Wiki-Quellcode von Update auf Mongo 4.2
Version 1.1 von MACH ProForms GmbH am 06.07.2020
Zeige letzte Bearbeiter
| author | version | line-number | content |
|---|---|---|---|
| 1 | # Update auf Mongo 4.2 | ||
| 2 | |||
| 3 | Ab der Version [[4.56.0|Main.13_Release-Notes]] ist die Mongo-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 | > 1. In beiden nachfolgenden Update-Varianten ist ein direkter Umstieg aus Kompatibilitätsgründen nicht möglich. | ||
| 8 | > 2. Es wird empfohlen vor Beginn einen Datenbank-Dump zu erstellen. | ||
| 9 | |||
| 10 | ## Update Mongo (Docker-Umgebung) | ||
| 11 | |||
| 12 | Für die Docker-Variante unseres Antragsmanagement-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. | ||
| 13 | |||
| 14 | > ***Hinweis:*** | ||
| 15 | > 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. | ||
| 16 | |||
| 17 | ### Händische Installation (Docker) | ||
| 18 | |||
| 19 | Folgende Schritte müssen für eine händische Installation vorgenommen werden: | ||
| 20 | |||
| 21 | - Den Docker-Container von Mongo und Wildfly herunterfahren via `docker rm -sf mongo wildfly` | ||
| 22 | - In der **docker-compose.yml** die Mongo-Version auf **3.6** abändern. | ||
| 23 | - Docker-Container für Mongo starten via `docker-compose up -d mongo` | ||
| 24 | - 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" })` | ||
| 25 | - Docker-Container für Mongo stoppen mittels `docker rm -sf mongo` | ||
| 26 | - In der **docker-compose.yml** die Mongo-Version auf **4.0** abändern. | ||
| 27 | - Docker-Container für Mongo starten via `docker-compose up -d mongo` | ||
| 28 | - 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" } )` | ||
| 29 | - Docker-Container für Mongo stoppen mittels `docker rm -sf mongo` | ||
| 30 | - In der **docker-compose.yml** die Mongo-Version auf **4.2** abändern. | ||
| 31 | - Docker-Container für mongo starten via `docker-compose up -d mongo` | ||
| 32 | - 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" } )` | ||
| 33 | - In allen Skripten, die Sie für das Dumpen und Wiederherstellen der Mongo-Datenbank verwenden, ist 3.4 durch 4.2 zu ersetzen. | ||
| 34 | |||
| 35 | ### Datenbank-Skripte für Metaformular und neuer Kundenbereich | ||
| 36 | |||
| 37 | 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. | ||
| 38 | |||
| 39 | ### Metaformular | ||
| 40 | |||
| 41 | Das Skript können Sie unter "[Skript Metafomular](https://cloud.form-solutions.de/index.php/s/JYaJy48BKaigT7L)" herunterladen und ebenfalls entweder in robo3T auf der Datenbank metaform oder direkt im Docker-Container der Mongo auszuführen. | ||
| 42 | |||
| 43 | > ***Hinweis:*** | ||
| 44 | > Bei der Ausführung via robo3T ist es zu empfehlen den Timeout der Datenbank-Verbindung vorab deutlich zu erhöhen. | ||
| 45 | |||
| 46 | |||
| 47 | ### fsAdministrationCenter | ||
| 48 | |||
| 49 | Das Skript können Sie unter "[Skript Kundenbereich](https://cloud.form-solutions.de/index.php/s/EtnFBnYLP6gG7g5)" herunterladen und ebenfalls entweder in robo3T auf der Datenbank fsAdministrationCenter oder direkt im Docker-Container der Mongo auszufü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 Mongo (ohne Docker-Umgebung) | ||
| 57 | |||
| 58 | Beim Updaten der Mongo-Datenbank ist es am einfachsten den Anweisungen aus der offiziellen Dokumentation zu folgen. | ||
| 59 | |||
| 60 | - Alle Anwendungen stoppen | ||
| 61 | - Mongo-Dump erstellen | ||
| 62 | - "[Update auf Mongo 3.6](https://docs.mongodb.com/manual/release-notes/3.6-upgrade-standalone/)" | ||
| 63 | - "[Update auf Mongo 4.0](https://docs.mongodb.com/manual/release-notes/4.0-upgrade-standalone/)" | ||
| 64 | - "[Update auf Mongo 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/JYaJy48BKaigT7L)" herunterladen und ebenfalls entweder in robo3T auf der Datenbank metaform oder direkt im Docker-Container der Mongo auszuführen. | ||
| 73 | |||
| 74 | > ***Hinweis:*** | ||
| 75 | > Bei der Ausführung via robo3T ist zu empfehlen den Timeout der Datenbank-Verbindung vorab deutlich zu erhöhen. | ||
| 76 | |||
| 77 | |||
| 78 | ### fsAdministrationCenter | ||
| 79 | |||
| 80 | Das Skript können Sie unter "[Skript Kundenbereich](https://cloud.form-solutions.de/index.php/s/EtnFBnYLP6gG7g5)" herunterladen und ebenfalls entweder in robo3T auf der Datenbank fsAdministrationCenter oder direkt im Docker-Container der Mongo via auszuführen. | ||
| 81 | |||
| 82 | ### Weitere Schritte | ||
| 83 | |||
| 84 | - Ausführung des egov-Installers mittels sh egov-installer.sh | ||
| 85 | - Update der mysql-Datenbank mittels `php /srv/kundenbereich/inc/db_update.php ofs customers` |