Wiki-Quellcode von Update auf Mongo 4.2
Zuletzt geändert von MACH ProForms GmbH am 24.06.2024
Zeige letzte Bearbeiter
| author | version | line-number | content |
|---|---|---|---|
| 1 | ## Update auf MongoDB 4.2 | ||
| 2 | |||
| 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. | ||
| 4 | Die Dokumentation untergliedert sich dabei in Serverbetrieben mit und ohne Docker. | ||
| 5 | |||
| 6 | > _**Hinweis:**_ | ||
| 7 | |||
| 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 | |||
| 13 | ### Update MongoDB (Docker-Umgebung) | ||
| 14 | |||
| 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. | ||
| 16 | |||
| 17 | > _**Hinweis:**_ | ||
| 18 | > | ||
| 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. | ||
| 20 | |||
| 21 | #### Händische Installation (Docker) | ||
| 22 | |||
| 23 | Folgende Schritte müssen für eine händische Installation vorgenommen werden: | ||
| 24 | |||
| 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. | ||
| 38 | |||
| 39 | #### Datenbank-Skripte für Metaformular und neuer Kundenbereich | ||
| 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 | |||
| 43 | #### Metaformular | ||
| 44 | |||
| 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. | ||
| 46 | |||
| 47 | #### fsAdministrationCenter | ||
| 48 | |||
| 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. | ||
| 50 | |||
| 51 | #### Weitere Schritte | ||
| 52 | |||
| 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. | ||
| 55 | |||
| 56 | ### Update MongoDB (ohne Docker-Umgebung) | ||
| 57 | |||
| 58 | Beim Updaten der MongoDB-Datenbank ist es am einfachsten den Anweisungen aus der offiziellen Dokumentation zu folgen. | ||
| 59 | |||
| 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/)" | ||
| 65 | |||
| 66 | ##### Datenbank-Skripte für Metaformular und neuer Kundenbereich | ||
| 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 | |||
| 70 | #### Metaformular | ||
| 71 | |||
| 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. | ||
| 73 | |||
| 74 | #### fsAdministrationCenter | ||
| 75 | |||
| 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. | ||
| 77 | |||
| 78 | #### Weitere Schritte | ||
| 79 | |||
| 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` |