Wiki-Quellcode von Update auf Mongo 8.0

Zuletzt geändert von MACH ProForms GmbH am 05.03.2025

Zeige letzte Bearbeiter
1 = Allgemeine Hinweise =
2
3 Für das Update auf die Version 4.105 ist ein Update der MongoDB zwingend erforderlich. Diese Anleitung beschreibt den __kompletten__ Update-Prozess inkl. der Aktualisierung der Software.
4
5 (% class="box infomessage" %)
6 (((
7 Bitte beachten Sie, dass Sie ggf. zusätzliche Module manuell updaten müssen. Hierzu gehört 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
10 = Ablauf =
11
12 1. Backup durchführen
13 1. Abhängig von der verwendeten Umgebung die nachfolgende Anleitung für das MongoDB Update durchführen
14 1. [[Update-Prozess >>path:/wiki/admindoku/view/Main/01_Systemadministration/05_Anleitungen/03_Update/]]der Software durchführen
15 1. Vergewissern Sie sich, dass Ihre Skripte wie z.B. "db-backup.sh" nach dem Update ordnungsgemäß funktionieren. In der Regel muss {{code}}... fs mongo:5.0 ...{{/code}} durch {{code}}... fs mongo:8.0 ...{{/code}} getauscht werden.
16
17 == Vorbereitung ==
18
19 (% class="box warningmessage" %)
20 (((
21 Für dieses Update ist es wichtig, dass das Timeout für das Deployment entsprechend dem Artikel [[Deployment-Timeout>>path:/wiki/admindoku/view/Main/01_Systemadministration/03_Installation/03_Abschliessend/01_Wildfly/03_Standalone/#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 werden und müssen nicht zurückgestellt werden.
22 )))
23
24 = Docker-Umgebung =
25
26 == Manuell ==
27
28 === Version 5 auf 6 ===
29
30 1. Alle Container stoppen: {{code}}docker-compose down{{/code}}
31 1. MongoDB-Image ({{code}}docker images{{/code}}) entfernen {{code}}docker image rm <img-id>{{/code}}
32 1. docker-compose.yml Datei anpassen, Image "mongo"
33 - Eigenschaft "version" von 5.0 auf 6.0 ändern
34 - Eigenschaft "Command" den Parameter "~-~-auth" entfernen, wenn vorhanden
35 1. Docker-Container "mongo" starten: {{code}}docker-compose up -d mongo{{/code}}
36 1. Aktivierung der Feature-Kompatibilität.
37 Dazu gehen Sie direkt in den Container {{code language="none"}}docker-compose exec mongo mongosh{{/code}} und verbinden sich mit der Datenbank. Anschließend führen Sie folgenden Befehl aus:
38 {{code language="none"}}db.adminCommand( { setFeatureCompatibilityVersion: "6.0" }){{/code}}
39 1. Bei Bedarf - folgender Befehl kann für die Überprüfung innerhalb des Containers genutzt werden:
40 {{code language="none"}}db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } ){{/code}}
41 1. (((
42 Mongo Container entfernen: {{code}}docker-compose rm -sf mongo{{/code}}
43 )))
44
45 === Version 6 auf 7 ===
46
47 1. MongoDB-Image ({{code}}docker images{{/code}}) entfernen {{code}}docker image rm <img-id>{{/code}}
48 1. docker-compose.yml Datei anpassen, Image "mongo"
49 - Eigenschaft "version" von 6.0 auf 7.0 ändern
50 1. Docker-Container "mongo" starten: {{code}}docker-compose up -d mongo{{/code}}
51 1. Aktivierung der Feature-Kompatibilität.
52 Dazu gehen Sie direkt in den Container {{code language="none"}}docker-compose exec mongo mongosh{{/code}} und verbinden sich mit der Datenbank. Anschließend führen Sie folgenden Befehl aus: {{code language="none"}}db.adminCommand( { setFeatureCompatibilityVersion: "7.0", confirm:true }){{/code}}
53 1. (((
54 (% id="cke_bm_91323S" style="display:none" %) (%%)Mongo Container entfernen: {{code}}docker-compose rm -sf mongo{{/code}}
55 )))
56
57 === Version 7 auf 8 ===
58
59 1. MongoDB-Image ({{code}}docker images{{/code}}) entfernen {{code}}docker image rm <img-id>{{/code}}
60 1. docker-compose.yml Datei anpassen, Image "mongo"
61 - Eigenschaft "version" von 7.0 auf 8.0 ändern
62 1. Docker-Container "mongo" starten: {{code}}docker-compose up -d mongo{{/code}}
63 1. Aktivierung der Feature-Kompatibilität.
64 Dazu gehen Sie direkt in den Container {{code language="none"}}docker-compose exec mongo mongosh{{/code}} und verbinden sich mit der Datenbank. Anschließend führen Sie folgenden Befehl aus: {{code language="none"}}db.adminCommand( { setFeatureCompatibilityVersion: "8.0", confirm:true }){{/code}}
65 1. (% id="cke_bm_1777S" style="display:none" %) (%%)Mongo Container entfernen: {{code}}docker-compose rm -sf mongo{{/code}}
66 1. docker-compose.yml Datei anpassen:
67 Image "mongo" - Eigenschaft "Command" den Parameter "~-~-auth" (wenn vorhanden war) hinzufügen
68 1. Container Web, Mongo und MariaDB starten
69
70 = Native Umgebung =
71
72 Es gelten die Schritte aus diesem [[Tutorial>>doc:Main.01_Systemadministration.05_Anleitungen.Update auf Mongo 5\.0.WebHome]]. Dabei sind die veränderten Versionen/Pakete aus den nachfolgenden Links zu entnehmen
73
74 * [[https:~~/~~/www.mongodb.com/docs/v6.0/tutorial/install-mongodb-on-ubuntu/>>https://www.mongodb.com/docs/v6.0/tutorial/install-mongodb-on-ubuntu/]]
75 * [[https:~~/~~/www.mongodb.com/docs/v7.0/tutorial/install-mongodb-on-ubuntu/>>https://www.mongodb.com/docs/v7.0/tutorial/install-mongodb-on-ubuntu/]]
76 * [[https:~~/~~/www.mongodb.com/docs/manual/tutorial/install-mongodb-on-ubuntu/>>https://www.mongodb.com/docs/manual/tutorial/install-mongodb-on-ubuntu/]]