Zum Inhalt springen

Update auf Mongo 4.2

Version 1.1 von MACH ProForms GmbH am 06.07.2020

Update auf Mongo 4.2

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

Hinweis:

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

Update Mongo (Docker-Umgebung)

Für die Docker-Variante unseres Antragsmanagement-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 Mongo-Datenbank angepasst werden.

Händische Installation (Docker)

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

  • Den Docker-Container von Mongo und Wildfly herunterfahren via docker rm -sf mongo wildfly
  • In der docker-compose.yml die Mongo-Version auf 3.6 abändern.
  • Docker-Container für Mongo starten via docker-compose up -d mongo
  • Aktivierung der Feature-Kompatibilität. Dazu gehen Sie entweder via robo3T oder direkt im Container auf die Datenbank und führen den folgenden Befehl aus: db.adminCommand( { setFeatureCompatibilityVersion: "3.6" })
  • Docker-Container für Mongo stoppen mittels  docker rm -sf mongo
  • In der docker-compose.yml die Mongo-Version auf 4.0 abändern.
  • Docker-Container für Mongo starten  via docker-compose up -d mongo
  • Um die Feature-Kompatibilität mit der Version 4.0 zu gewährleisten gehen Sie entweder via robo3T oder direkt im Docker-Container auf die Datenbank und führen den folgenden Befehl aus: db.adminCommand( { setFeatureCompatibilityVersion: "4.0" } )
  • Docker-Container für Mongo stoppen mittels docker rm -sf mongo
  • In der docker-compose.yml die Mongo-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 entweder via robo3T oder 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 Mongo-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 ebenfalls entweder in robo3T auf der Datenbank metaform oder direkt im Docker-Container der Mongo auszuführen.

Hinweis: Bei der Ausführung via robo3T ist es zu empfehlen den Timeout der Datenbank-Verbindung vorab deutlich zu erhöhen.

fsAdministrationCenter

Das Skript können Sie unter "Skript Kundenbereich" herunterladen und ebenfalls entweder in robo3T auf der Datenbank fsAdministrationCenter oder direkt im Docker-Container der Mongo auszufü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 Mongo (ohne Docker-Umgebung)

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

Datenbank-Skripte  für Metaformular und neuer Kundenbereich

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.

Metaformular

Das Skript können Sie unter "Skript Metafomular" herunterladen und ebenfalls entweder in robo3T auf der Datenbank metaform oder direkt im Docker-Container der Mongo auszuführen.

Hinweis: Bei der Ausführung via robo3T ist zu empfehlen den Timeout der Datenbank-Verbindung vorab deutlich zu erhöhen.

fsAdministrationCenter

Das Skript können Sie unter "Skript Kundenbereich" herunterladen und ebenfalls entweder in robo3T auf der Datenbank fsAdministrationCenter oder direkt im Docker-Container der Mongo via auszuführen.

Weitere Schritte

  • Ausführung des egov-Installers mittels sh egov-installer.sh
  • Update der mysql-Datenbank mittels php /srv/kundenbereich/inc/db_update.php ofs customers