|
|
Migration auf Apache CouchDB-Version 3
Ältere E-ConsentPro Versionen bis einschließlich Version 9.x verwenden die Apache CouchDB-Version 1.
Ab E-ConsentPro Version 10 wird die Apache Couch-Datenbank Version 3 benötigt. Die Migration erfolgt automatisch nach dem Update auf E-ConsentPro 10.
Verschiedene Update-Szenarien (Details: Hinweise zum Wechsel auf ECP Version 10)
- Neuinstallation von E-ConsentPro 10:
Apache CouchDB-Version 3 wird automatisch in der aktuellen Version installiert. (Details) - Update von E-ConsentPro 9 auf 10: Apache CouchDB-Version 3 wird automatisch zusätzlich installiert. (Details)
- Aktualisierung von einer Version älter als E-ConsentPro 9:
Erst Update auf E-ConsentPro 9 durchführen. Danach ist das Update auf Version 10 möglich.
Übersicht der Änderungen:
| Vorher (bis E-ConsentPro Version 9) | Nachher (ab E-ConsentPro Version 10) |
|---|---|
| Apache CouchDB-Version 1 | Apache CouchDB-Version 3 |
| Port 5984 | Port 7984 |
Prüfen der Migrationsvoraussetzungen (Details):
Stellen Sie sicher, dass ausreichend freier Speicherplatz verfügbar ist. Für die Migration von Apache CouchDB-Version 1 zu Apache CouchDB-Version 3 wird mindestens der dreifache Speicherplatz der bisherigen Apache CouchDB-Version‑1‑Installation benötigt.
Das Update darf nicht gestartet werden, wenn nicht ausreichend Speicherplatz zur Verfügung steht.
Für eine reibungslose und sichere Durchführung der Migration empfehlen wir folgende Rahmenbedingungen:
- Führen Sie das Update vorzugsweise innerhalb eines geplanten Wartungsfensters durch.
- Stellen Sie sicher, dass das System sich während der Migration im Leerlauf befindet (keine aktiven Benutzer, keine laufenden Prozesse).
- Alternativ kann die Migration außerhalb der regulären Arbeitszeiten oder als Wochenend-Update durchgeführt werden, um Unterbrechungen im Betrieb zu vermeiden.
Statusüberblick im Apache CouchDB‑Monitor (Details):
-
Öffnen Sie die Menüoption Admin > CouchDB Monitor
Der Dialog CouchDB Monitor erscheint.
Wichtig:
Bei Dokumenten handelt es sich um Datenbankobjekte, nicht um Bögen!
Beispiel: Anzeige von CouchDB -Version1 und CouchDB-Version 3 – Replikation unvollständig -
Im Bereich zu Apache CouchDB–Version 1 können Sie eine Kontrolle des aktuellen Speicherplatzbedarfs sowie der Anzahl der Dokumente pro Datenbank durchführen.
-
Auch für Apache CouchDB-Version 3 können Sie hier den aktuellen Speicherplatzbedarf sowie die Anzahl der Dokumente pro Datenbank überwachen.
-
Im Abschnitt zur Datenbankreplikation können Sie den Status der Übertragung einsehen: Gesamtgröße der jeweiligen Datenbanken sowie den Fortschritt der bereits kopierten Dokumente. Das Fenster aktualisiert sich minütlich.
Hinweis:
Wenn sich die Werte über einen längeren Zeitraum nicht verändern, wenden Sie sich bitte an den Systemadministrator.
Abschlusskontrolle nach der Umstellung auf Apache CouchDB-Version 3:
Nach der erfolgreich abgeschlossenen Umstellung auf Apache CouchDB-Version 3 können Sie im CouchDB-Monitor die finalen Systeminformationen einsehen. Der Monitor sollte nach der Migration folgende Ansicht bzw. Werte anzeigen.
Nach dem Neustart sollte nur noch die CouchDB-Version 3 angezeigt werden.
Hinweis:
Apache CouchDB-Version 1 bleibt nach der Migration unverändert bestehen und belegt weiterhin Speicherplatz. Eine zukünftige Programmversion wird die alte Datenbank automatisch entfernen.
