Wiki-Quellcode von Update auf Mongo 8.0
Zuletzt geändert von MACH ProForms GmbH am 05.03.2025
Zeige letzte Bearbeiter
author | version | line-number | content |
---|---|---|---|
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/]] |