Wiki-Quellcode von Update auf Mongo 8.0

Zuletzt geändert von MACH ProForms GmbH am 05.03.2025

version	line-number	content
1.1	1	= Allgemeine Hinweise =
	2
15.3	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.
1.1	4
	5	(% class="box infomessage" %)
	6	(((
12.2	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.
1.1	8	)))
	9
	10	= Ablauf =
	11
	12	1. Backup durchführen
12.2	13	1. Abhängig von der verwendeten Umgebung die nachfolgende Anleitung für das MongoDB Update durchführen
16.2	14	1. [[Update-Prozess >>path:/wiki/admindoku/view/Main/01_Systemadministration/05_Anleitungen/03_Update/]]der Software durchführen
12.4	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.
1.1	16
	17	== Vorbereitung ==
	18
	19	(% class="box warningmessage" %)
	20	(((
15.4	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.
1.1	22	)))
	23
2.1	24	= Docker-Umgebung =
1.1	25
4.1	26	== Manuell ==
1.1	27
6.2	28	=== Version 5 auf 6 ===
	29
1.1	30	1. Alle Container stoppen: {{code}}docker-compose down{{/code}}
2.1	31	1. MongoDB-Image ({{code}}docker images{{/code}}) entfernen {{code}}docker image rm <img-id>{{/code}}
1.1	32	1. docker-compose.yml Datei anpassen, Image "mongo"
	33	- Eigenschaft "version" von 5.0 auf 6.0 ändern
12.5	34	- Eigenschaft "Command" den Parameter "~-~-auth" entfernen, wenn vorhanden
1.1	35	1. Docker-Container "mongo" starten: {{code}}docker-compose up -d mongo{{/code}}
12.6	36	1. Aktivierung der Feature-Kompatibilität.
15.1	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:
14.1	38	{{code language="none"}}db.adminCommand( { setFeatureCompatibilityVersion: "6.0" }){{/code}}
6.2	39	1. Bei Bedarf - folgender Befehl kann für die Überprüfung innerhalb des Containers genutzt werden:
14.1	40	{{code language="none"}}db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } ){{/code}}
11.1	41	1. (((
	42	Mongo Container entfernen: {{code}}docker-compose rm -sf mongo{{/code}}
	43	)))
6.2	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"
6.3	49	- Eigenschaft "version" von 6.0 auf 7.0 ändern
6.2	50	1. Docker-Container "mongo" starten: {{code}}docker-compose up -d mongo{{/code}}
12.6	51	1. Aktivierung der Feature-Kompatibilität.
15.1	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}}
11.1	53	1. (((
	54	(% id="cke_bm_91323S" style="display:none" %) (%%)Mongo Container entfernen: {{code}}docker-compose rm -sf mongo{{/code}}
	55	)))
1.1	56
6.2	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"
6.3	61	- Eigenschaft "version" von 7.0 auf 8.0 ändern
6.2	62	1. Docker-Container "mongo" starten: {{code}}docker-compose up -d mongo{{/code}}
12.7	63	1. Aktivierung der Feature-Kompatibilität.
15.1	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}}
13.1	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:
6.2	67	Image "mongo" - Eigenschaft "Command" den Parameter "~-~-auth" (wenn vorhanden war) hinzufügen
8.1	68	1. Container Web, Mongo und MariaDB starten
6.2	69
4.1	70	= Native Umgebung =
	71
15.2	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
4.1	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/]]