Update auf Mongo 4.2

Zuletzt geändert von MACH ProForms GmbH am 24.06.2024

Update auf MongoDB 4.2

Ab der Version 4.56.0 ist die MongoDB-Version 4.2.x zwingende Voraussetzung für die Verwendung des Formularservers.
Die Dokumentation untergliedert sich dabei in Serverbetrieben mit und ohne Docker.

Hinweis:

In beiden nachfolgenden Update-Varianten ist ein direkter Umstieg aus Kompatibilitätsgründen nicht möglich.
Es wird empfohlen vor Beginn einen Datenbank-Dump zu erstellen.

Update MongoDB (Docker-Umgebung)

Für die Docker-Variante unseres MACH formsolutions-Systems können Sie sich entweder ein anpassbares "Skript" herunterladen oder gemäß der nachfolgenden beschriebenen händischen Installation vorgehen.

Hinweis:
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.

Händische Installation (Docker)

Folgende Schritte müssen für eine händische Installation vorgenommen werden:

Den Docker-Container von MongoDB und Wildfly herunterfahren via docker-compose rm -sf mongo wildfly
In der docker-compose.yml die MongoDB-Version auf 3.6 abändern.
Docker-Container für MongoDB starten via docker-compose up -d mongo
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" })
Docker-Container für MongoDB stoppen mittels docker-compose rm -sf mongo
In der docker-compose.yml die MongoDB-Version auf 4.0 abändern.
Docker-Container für MongoDB starten via docker-compose up -d mongo
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" } )
Docker-Container für MongoDB stoppen mittels docker-compose rm -sf mongo
In der docker-compose.yml die MongoDB-Version auf 4.2 abändern.
Docker-Container für mongo starten via docker-compose up -d mongo
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" } )
In allen Skripten, die Sie für das Dumpen und Wiederherstellen der MongoDB-Datenbank verwenden, ist 3.4 durch 4.2 zu ersetzen.

Datenbank-Skripte für Metaformular und neuer Kundenbereich

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.

Metaformular

Das Skript können Sie unter "Skript Metafomular" herunterladen und direkt im Docker-Container der MongoDB ausführen.

fsAdministrationCenter

Das Skript können Sie unter "Skript Kundenbereich" herunterladen und direkt im Docker-Container der MongoDB ausführen.

Weitere Schritte

Ausführung des egov-Installers mittels sh egov-installer.sh
Update der mysql-Datenbank mittels php /kundenbereich/inc/db_update.php ofs customers innerhalb des entsprechenden Docker-Containers.

Update MongoDB (ohne Docker-Umgebung)

Beim Updaten der MongoDB-Datenbank ist es am einfachsten den Anweisungen aus der offiziellen Dokumentation zu folgen.

Alle Anwendungen stoppen
MongoDB-Dump erstellen
"Update auf MongoDB 3.6"
"Update auf MongoDB 4.0"
"Update auf MongoDB 4.2"