Wiki-Quellcode von Update auf Mongo 4.2

Zuletzt geändert von MACH ProForms GmbH am 24.06.2024

version	line-number	content
7.1	1	## Update auf MongoDB 4.2
1.1	2
3.1	3	Ab der Version [4.56.0](https://wiki.form-solutions.de/wiki/docwiki/view/Main/13_Release-Notes/) ist die MongoDB-Version 4.2.x zwingende Voraussetzung für die Verwendung des Formularservers.
1.1	4	Die Dokumentation untergliedert sich dabei in Serverbetrieben mit und ohne Docker.
	5
8.1	6	> _Hinweis:_
1.1	7
8.1	8	1. In beiden nachfolgenden Update-Varianten ist ein direkter Umstieg aus Kompatibilitätsgründen nicht möglich.
	9	1. Es wird empfohlen vor Beginn einen Datenbank-Dump zu erstellen.
	10
	11
	12
7.1	13	### Update MongoDB (Docker-Umgebung)
1.1	14
8.1	15	Für die Docker-Variante unseres MACH formsolutions-Systems können Sie sich entweder ein anpassbares "[Skript](https://cloud.form-solutions.de/index.php/s/Xdx9YBpNK4EZ7sR)" herunterladen oder gemäß der nachfolgenden beschriebenen händischen Installation vorgehen.
1.1	16
8.1	17	> _Hinweis:_
	18	>
3.1	19	> Bei der automatisierten Variante muss in der Datei update202007-Docker-Verwendung auf eigene Gefahr die URL zur Wartungsseite sowie die Zugangsdaten zur MongoDB-Datenbank angepasst werden.
1.1	20
7.1	21	#### Händische Installation (Docker)
1.1	22
	23	Folgende Schritte müssen für eine händische Installation vorgenommen werden:
	24
8.1	25	* Den Docker-Container von MongoDB und Wildfly herunterfahren via `docker-compose rm -sf mongo wildfly`
	26	* In der docker-compose.yml die MongoDB-Version auf 3.6 abändern.
	27	* Docker-Container für MongoDB starten via `docker-compose up -d mongo`
	28	* Aktivierung der Feature-Kompatibilität. Dazu gehen Sie direkt im Container auf die Datenbank und führen den folgenden Befehl aus: `db.adminCommand( { setFeatureCompatibilityVersion: "3.6" })`
	29	* Docker-Container für MongoDB stoppen mittels `docker-compose rm -sf mongo`
	30	* In der docker-compose.yml die MongoDB-Version auf 4.0 abändern.
	31	* Docker-Container für MongoDB starten via `docker-compose up -d mongo`
	32	* Um die Feature-Kompatibilität mit der Version 4.0 zu gewährleisten gehen Sie direkt im Docker-Container auf die Datenbank und führen den folgenden Befehl aus: `db.adminCommand( { setFeatureCompatibilityVersion: "4.0" } )`
	33	* Docker-Container für MongoDB stoppen mittels `docker-compose rm -sf mongo`
	34	* In der docker-compose.yml die MongoDB-Version auf 4.2 abändern.
	35	* Docker-Container für mongo starten via `docker-compose up -d mongo`
	36	* Um die Feature-Kompatibilität mit der Version 4.2 zu gewährleisten gehen Sie direkt im Docker-Container auf die Datenbank und führen den folgenden Befehl aus `db.adminCommand( { setFeatureCompatibilityVersion: "4.2" } )`
	37	* In allen Skripten, die Sie für das Dumpen und Wiederherstellen der MongoDB-Datenbank verwenden, ist 3.4 durch 4.2 zu ersetzen.
1.1	38
7.1	39	#### Datenbank-Skripte für Metaformular und neuer Kundenbereich
1.1	40
	41	Mit der Version 4.56.0 wurden zwei Datenbankskript ausgeliefert, die nicht automatisiert mit dem Update ausgeführt werden können, sondern händisch ausgeführt werden müssen.
	42
7.1	43	#### Metaformular
1.1	44
6.1	45	Das Skript können Sie unter "[Skript Metafomular](https://cloud.form-solutions.de/index.php/s/WdkM22JzoK7CXDa)" herunterladen und direkt im Docker-Container der MongoDB ausführen.
1.1	46
7.1	47	#### fsAdministrationCenter
1.1	48
6.1	49	Das Skript können Sie unter "[Skript Kundenbereich](https://cloud.form-solutions.de/index.php/s/YgdW7CojS3gKHet)" herunterladen und direkt im Docker-Container der MongoDB ausführen.
1.1	50
7.1	51	#### Weitere Schritte
1.1	52
8.1	53	* Ausführung des egov-Installers mittels sh egov-installer.sh
	54	* Update der mysql-Datenbank mittels `php /kundenbereich/inc/db_update.php ofs customers` innerhalb des entsprechenden Docker-Containers.
1.1	55
7.1	56	### Update MongoDB (ohne Docker-Umgebung)
1.1	57
3.1	58	Beim Updaten der MongoDB-Datenbank ist es am einfachsten den Anweisungen aus der offiziellen Dokumentation zu folgen.
1.1	59
8.1	60	* Alle Anwendungen stoppen
	61	* MongoDB-Dump erstellen
	62	* "[Update auf MongoDB 3.6](https://docs.mongodb.com/manual/release-notes/3.6-upgrade-standalone/)"
	63	* "[Update auf MongoDB 4.0](https://docs.mongodb.com/manual/release-notes/4.0-upgrade-standalone/)"
	64	* "[Update auf MongoDB 4.2](https://docs.mongodb.com/manual/release-notes/4.2-upgrade-standalone/)"
1.1	65
7.1	66	##### Datenbank-Skripte für Metaformular und neuer Kundenbereich
1.1	67
	68	Mit der Version 4.56.0 liefern wir auch zwei Datenbankskripte aus, die nicht automatisiert mit dem Update ausgeführt werden können, sondern händisch ausgeführt werden müssen.
	69
7.1	70	#### Metaformular
1.1	71
6.1	72	Das Skript können Sie unter "[Skript Metafomular](https://cloud.form-solutions.de/index.php/s/WdkM22JzoK7CXDa)" herunterladen und direkt im Docker-Container der MongoDB ausführen.
1.1	73
7.1	74	#### fsAdministrationCenter
1.1	75
6.1	76	Das Skript können Sie unter "[Skript Kundenbereich](https://cloud.form-solutions.de/index.php/s/YgdW7CojS3gKHet)" herunterladen und direkt im Docker-Container der MongoDB ausführen.
1.1	77
7.1	78	#### Weitere Schritte
1.1	79
8.1	80	* Ausführung des egov-Installers mittels sh egov-installer.sh
	81	* Update der mysql-Datenbank mittels `php /srv/kundenbereich/inc/db_update.php ofs customers`