Wiki-Quellcode von Update auf Mongo 5.0
Zuletzt geändert von MACH ProForms GmbH am 24.05.2023
Verstecke letzte Bearbeiter
| author | version | line-number | content |
|---|---|---|---|
 |
2.1 | 1 | = Allgemeine Hinweise = |
| 2 | |||
| |
19.1 | 3 | Für das Update auf die Version 4.86 ist ein Update der MongoDB zwingend Voraussetzung. Diese Anleitung beschreibt den __kompletten__ Updateprozess inkl. der Aktualisierung der Software. |
| |
2.1 | 4 | |
| |
3.1 | 5 | (% class="box infomessage" %) |
| 6 | ((( | ||
| 7 | Bitte beachten Sie, dass Sie ggf. zusätzliche Module manuell Updaten müssen. Hierzu gehören z.B. das Modul "data-export.war". Sollte sich dieses Modul im "deployment" Verzeichnis des Wildfly-Servers befinden, kontaktieren Sie bitte unseren Support. | ||
| 8 | ))) | ||
| 9 | |||
| |
17.1 | 10 | (% class="box infomessage" %) |
| 11 | ((( | ||
| 12 | Im Bereich des automatischen Abmeldeprozesses für die Nutzenden mussten neue Eigenschaftsnamen definiert werden. Sollten Sie hierzu individuelle Anpassungen vorgenommen haben müssen Sie sich bei uns im Support melden. Der bisherige und neue Wert für das automatische Abmelden beträgt 10 Stunden. | ||
| 13 | ))) | ||
| 14 | |||
| |
2.1 | 15 | == Ablauf == |
| 16 | |||
| 17 | 1. Backup durchführen | ||
| 18 | 1. Abhängig der verwendeten Umgebung die nachfolgende Anleitung für das MongoDB Update durchführen | ||
| 19 | 1. [[Updateprozess >>doc:Main.01_Systemadministration.05_Anleitungen.03_Update.WebHome]]der Software durchführen | ||
| 20 | |||
| |
16.1 | 21 | == Vorbereitung == |
| 22 | |||
| 23 | (% class="box warningmessage" %) | ||
| 24 | ((( | ||
| 25 | Für dieses Update ist es wichtig, dass der Timeout für das Deployment entsprechend dem Artikel [[Deployment-Timeout>>doc:Main.01_Systemadministration.03_Installation.03_Abschliessend.01_Wildfly.03_Standalone.WebHome||anchor="HDeploymentTimeout"]] eingestellt ist. Bitte kontrollieren und passen Sie die Einstellungen entsprechend an bevor Sie das Update einspielen. Diese Werte können nach dem Update beibehalten und müssen nicht zurückgestellt werden. | ||
| 26 | ))) | ||
| 27 | |||
| |
18.1 | 28 | == I: a) Update Docker-Umgebung mittels Skript == |
| |
2.1 | 29 | |
| |
18.1 | 30 | Für das Update steht Ihnen auch folgendes Skript zur Verfügung: |
| 31 | |||
| 32 | [[Download-Link>>https://cloud.form-solutions.de/index.php/s/BCAk6jXFpXgRxtF]] | ||
| 33 | |||
| 34 | Dieses Skript bündelt die in I: b) aufgelisteten manuellen Schritte in einen automatisierbaren Prozess. | ||
| 35 | |||
| 36 | == I: b) Update Docker-Umgebung manuell == | ||
| 37 | |||
| |
12.1 | 38 | 1. Alle Container stoppen: {{code}}docker-compose down{{/code}} |
| |
2.1 | 39 | 1. docker-compose.yml Datei anpassen, Image "mongo" |
| 40 | - Eigenschaft "version" von 4.2 auf 4.4 ändern | ||
| 41 | - Eigenschaft "Command" den Parameter "~-~-auth" (wenn vorhanden) entfernen | ||
| |
12.1 | 42 | 1. Docker-Container "mongo" starten: {{code}}docker-compose up -d mongo{{/code}} |
| |
13.1 | 43 | 1. Aktivierung der Feature-Kompatibilität. Dazu gehen Sie direkt in den Container {{code}}docker-compose exec mongo mongo{{/code}} und verbinden sich mit der Datenbank. Anschließend führen Sie folgenden Befehl aus: |
| |
12.1 | 44 | {{code}}db.adminCommand( { setFeatureCompatibilityVersion: "4.4" }){{/code}} |
| |
2.1 | 45 | 1. Bei Bedarf - folgender Befehl kann für die Überprüfung innerhalb des Containers genutzt werden: |
| |
12.1 | 46 | {{code}}db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } ){{/code}} |
| 47 | 1. Docker-Container "mongo" löschen: {{code}}docker-compose rm -sf mongo{{/code}} | ||
| |
2.1 | 48 | 1. docker-compose.yml Datei anpassen, Image "mongo" |
| 49 | - Eigenschaft "version" von 4.4 auf 5.0 ändern | ||
| |
12.1 | 50 | 1. Docker-Container "mongo" starten: {{code}}docker-compose up -d mongo{{/code}} |
| |
2.1 | 51 | 1. Aktivierung der Feature-Kompatibilität. Dazu gehen Sie direkt im Container auf die Datenbank und führen den folgenden Befehl aus: |
| |
12.1 | 52 | {{code}}db.adminCommand( { setFeatureCompatibilityVersion: "5.0" }){{/code}} |
| |
2.1 | 53 | 1. Bei Bedarf - folgender Befehl kann für die Überprüfung innerhalb des Containers genutzt werden: |
| |
12.1 | 54 | {{code}}db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } ){{/code}} |
| 55 | 1. Container "mongo" löschen: {{code}}docker-compose rm -sf mongo{{/code}} | ||
| |
2.1 | 56 | 1. docker-compose.yml Datei anpassen: |
| 57 | Image "mongo" - Eigenschaft "Command" den Parameter "~-~-auth" (wenn vorhanden war) hinzufügen | ||
| 58 | |||
| |
18.1 | 59 | == II: Update klassische Umgebung (Ubuntu) == |
| |
2.1 | 60 | |
| |
3.1 | 61 | === Schritt 1 - Update auf Version 4.4 === |
| 62 | |||
| 63 | 1. MongoDB Prozess stoppen: sudo service mongod stop | ||
| 64 | 1. Die installierten Mongo-DB Pakete deinstallieren: sudo apt-get purge mongodb-org* | ||
| |
4.1 | 65 | 1. Um zu überprüfen, ob die Deinstallation erfolgreich war: service mongod status |
| |
8.1 | 66 | 1. Für die Installation der MongoDB müssen folgende Schritte durchgeführt werden: |
| 67 | - Installation "gnupg" (wenn noch nicht vorhanden): sudo apt-get install gnupg | ||
| 68 | - Führen Sie den folgende Befehl aus, um den öffentlichen Schlüsselfür die MongoDB zu importieren: | ||
| |
3.1 | 69 | curl -fsSL https:~/~/pgp.mongodb.com/server-4.4.asc |
| 70 | sudo gpg -o /usr/share/keyrings/mongodb-server-4.4.gpg ~-~-dearmor | ||
| 71 | 1. Create the /etc/apt/sources.list.d/mongodb-org-4.4.list file for Ubuntu 20.04 (Focal): | ||
| 72 | echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-4.4.gpg ] https:~/~/repo.mongodb.org/apt/ubuntu focal/mongodb-org/4.4 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-4.4.list | ||
| |
9.1 | 73 | 1. Update der lokalen Paket-Datenbank: sudo apt-get update |
| |
6.1 | 74 | 1. MongoDB-Pakete installieren: |
| |
3.1 | 75 | sudo apt-get install -y mongodb-org=4.4.20 mongodb-org-server=4.4.20 mongodb-org-shell=4.4.20 mongodb-org-mongos=4.4.20 mongodb-org-tools=4.4.20 |
| |
5.1 | 76 | 1. Um zu überprüfen, ob die Installation vollständig durchgeführt ist: mongo –version |
| |
7.1 | 77 | 1. Service starten: sudo service mongod start |
| |
14.1 | 78 | 1. Verbinden Sie sich über den Mongo-Client und führen folgende Befehle aus: |
| |
3.1 | 79 | - db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } ) |
| 80 | - db.adminCommand( { setFeatureCompatibilityVersion: "4.4" } ) | ||
| 81 | |||
| 82 | === Schritt 2 - Update auf 5.0 === | ||
| 83 | |||
| 84 | 1. MongoDB Prozess stoppen: sudo service mongod stop | ||
| 85 | 1. Die installierten Mongo-DB Pakete deinstallieren: sudo apt-get purge mongodb-org* | ||
| |
4.1 | 86 | 1. Um zu überprüfen, ob die Deinstallation erfolgreich war: service mongod status |
| |
8.1 | 87 | 1. Für die Installation der MongoDB müssen folgende Schritte durchgeführt werden: |
| |
3.1 | 88 | - curl -fsSL https:~/~/pgp.mongodb.com/server-5.0.asc |
| 89 | - sudo gpg -o /usr/share/keyrings/mongodb-server-5.0.gpg ~-~-dearmor | ||
| 90 | 1. Create the /etc/apt/sources.list.d/mongodb-org-5.0.list file for Ubuntu 20.04 (Focal): | ||
| 91 | echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-5.0.gpg ] https:~/~/repo.mongodb.org/apt/ubuntu focal/mongodb-org/5.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-5.0.list | ||
| |
9.1 | 92 | 1. Update der lokalen Paket-Datenbank: sudo apt-get update |
| |
6.1 | 93 | 1. MongoDB-Pakete installieren: |
| |
3.1 | 94 | sudo apt-get install -y mongodb-org=5.0.16 mongodb-org-database=5.0.16 mongodb-org-server=5.0.16 mongodb-org-shell=5.0.16 mongodb-org-mongos=5.0.16 mongodb-org-tools=5.0.16 |
| |
5.1 | 95 | 1. Um zu überprüfen, ob die Installation vollständig durchgeführt ist: mongo –version |
| |
7.1 | 96 | 1. Service starten: sudo service mongod start |
| |
14.1 | 97 | 1. Verbinden Sie sich über den Mongo-Client und führen folgende Befehle aus: |
| |
3.1 | 98 | - db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } ) |
| 99 | - db.adminCommand( { setFeatureCompatibilityVersion: "5.0" } ) |