Wechsel von MongoDB nach Postgres
Betrifft mich dieses Szenario
Ob Sie das Szenario betrifft und Sie die Schritte beachten sollen, können Sie der nachstehenden Tabelle entnehmen. Sollten Sie keinen der Dienste in der jeweilige Version im Einsatz haben, so betrifft Sie dieses Szenario nicht.
Dienst | Version von | Version bis |
|---|---|---|
Authentication Service | 1.0.0 | 1.0.2 |
Client Service | 1.0.0 | 1.0.1 |
Dashboard Service (IoT) | 1.0.0 | 1.0.5 |
Process Service | 1.0.0 | 1.0.5 |
Project Service | 1.0.0 | 1.0.5 |
Report Service | 1.0.0 | 1.0.3 |
Object Storage Service | 1.0.0 | 1.0.5 |
Welche Schritte müssen unternommen werden
Bei diesem Update wurde die Datenbank der Services von MongoDB auf Postgres gewechselt. Aus diesem Grund ist eine einfache Datenmigration von MongoDB nach Postgres nicht möglich.
In den nachstehenden Abschnitten führen wir Sie durch die einzelnen Arbeitsschritte durch um Ihre Daten zu übernehmen.
Schritt 1: Aktualisierung des Designers und sichern der Projekte
Bevor mit dem Udpate des Systems begonnen werden kann sollte der Designer auf die Version 1.0.11 aktualisiert werden. Mit dieser Version können Sie ein vollständigen Export Ihres Systems durchführen.
Nach dem Sie den Designer aktualisiert haben starten Sie diesen und öffnen Sie jedes von Ihnen zuvor erstellte Projekt.
Diese Vorgang müssen Sie für jedes von Ihnen erstellte Projekt durchführen, welches Sie übernehmen möchten. Sollten Sie dieses nicht durchführen, sind die Projekte nicht mehr zugänglich und bei einer deinstallation der MongoDB können die Projekte nicht mehr hergestellt werden.
Im Dashboard des Projektes wird die Schaltfläche Export Project angeboten.
Mit dieser Schaltfläche können Sie einen Export für das Projekt erstellen. Haben Sie die Schaltfläche getätigt erscheint der folgende Dialog.
In diesem Dialog wählen Sie bitte also Version Aktuelle Arbeitsversion aus und die Variante Vollständiger Export. Die Überprüfung von Abhängigkeiten können wir bei diesen Einstellungen deaktivieren, da wir einen vollständigen Export mit allen Daten durchführen. Haben wir alle Einstellungen getätigt bestätigen wir diese mit einen Klick auf die Schaltfläche Weiter.
Das System sammelt anschließend alle Daten für den Export und die Erstellung der Exportdatei kann mit einem Klick auf die Schaltfläche Weiter gestartet werden.
Bei der Erstellung des Exports fragt das System an welcher Stelle und mit welcher Bezeichnung die Exportdatei gespeichert werden soll. Tragen Sie hier die jeweilige Bezeichnung für Ihr Projekt ein und bestätigen Sie den Dialog. Anschließend wird die Exportdatei auf dem System gespeichert.
Mit diesen Vorgang haben Sie ein vollständige Sicherung Ihre Projektes durchgeführt und können diese jederzeit als neues Projekt oder zu bestehenden Projekten importieren.
Schritt 2: Dienste aktualisieren
Als nächsten Schritt können Sie die Aktualisierung der Dienste wie gewohnt durchführen. Haben Sie die Dienste entsprechend aktualisiert und eine Postgres Datenbank ebenfalls, müssen Sie evtl. die bestehenden Einstellungen Ihrer Dienste anpassen und die Adresse zur Datenbank korrigieren.
Bitte beachten Sie, dass die Postgres Datenbank im Gegensatz zur MongoDB zwingend einen Benutzernamen und Passwort benötigen. Aus diesem Grund müssen Sie die Konfigurationen Ihrer Services um den jeweiligen Benutzernamen und Passwort erweitern.
Besonderheit Windows-Setup
Bei der Verwendung der Windows-Setups kann es unter Umständen nötig sein, dass die Konfigurationsdatei der Dienste manuell angepasst werden müssen. Das Setup aktualisiert keine Dateien welche nach der Installation erstellt/verändert wurden und müssen somit manuell angepasst werden.
Wie die jeweilige Konfigurationsdatei für das Setup anzupassen ist bzw. welche Parameter diese jetzt enthalten können Sie aus dem Artikel: Installation Backend und Services entnehmen. Hier steht für jeden Service der Abschnitt Lokale Konfigurationsdatei zur Verfügung in dem ein Beispiel der aktuellen Konfigurationsdatei aufgeführt wurde.
Schritt 3: Projekte erstellen und Daten importieren
Sind die Projekte gesichert und die Dienste aktualisiert starten wir den Designer erneut. Jetzt werden Sie sehen das keine Projekte mehr vorhanden sind. Wir müssen jetzt unsere zuvor exportierten Projekte wieder importieren.
Hierzu wählen wir den Arbeitsbereich Selektieren oder Erstellen eines neuen Projektes aus und klicken auf die Schaltfläche Projekt basierend auf ein anderes Projekt oder Vorlage aus.
Nach dem wir die Schaltfläche betätigt haben, werden wir nach der Exportdatei gefragt. Hier wählen wir die von uns zuvor erstellte Projektdatei aus und bestätigen den Dialog.
Im darauffolgenden Dialog, geben wir unseren Projektnamen an und bestätigen den Dialog. Anschließend wird das Projekt basierend auf unserem Export erstellt und wir haben unser Projekt somit rekonstruiert.
Schritt 4: Service Pools einrichten
Nach dem wir erfolgreich unsere Projekte importiert/rekonstruiert haben, erstellen wir einen neuen Service-Pool damit wir die Daten im nächsten Schritt wieder veröffentlichen können.
Schritt 5: Veröffentlichen unseres Projektes
Als letzten Schritt müssen wir unsere Projekte veröffentlichen und unser System ist wieder auf dem Stand wie vor dem Update.