Wichtige Hinweise zum Update auf E-ConsentPro Version 10

Das Update E-ConsentPro Version 10 hat spezielle Anforderungen an die Umgebung, da hierbei eine neue Datenbankversion mit ausgerollt wird. Da dies einen umfangreichen Eingriff in das bestehende System darstellt, sind die Hinweise und Empfehlungen auf dieser Seite unbedingt zu beachten:

  • Verwenden Sie vor der Installation des Updates von E-ConsentPro 10.0 in Ihrer Produktivumgebung ein Testsystem, um den Ablauf zu prüfen. Dies hilft Ihnen auch bei der Einschätzung der Dauer für das benötigte Wartungsfenster der Produktivumgebung.

  • Legen Sie vor der Installation des Softwareupdates unbedingt ein vollständiges Backup an. Ein Downgrade der CouchDB 3 oder von E-ConsentPro 10.0 ist nach erfolgter Installation nicht mehr möglich.

  • Führen Sie das Update inklusive der Datenbankmigration unbedingt zu einem Zeitpunkt aus, in dem das Produktivsystem nicht genutzt wird (Wartungsfenster) und warten Sie den Vorgang der Datenbankmigration ab, bevor Sie wieder in den Produktivbetrieb wechseln.

  • Beachten Sie, dass die Installation von E-ConsentPro10.0 zwingend eine installierte Version 9.0.x voraussetzt. Ein Update von einer älteren E-ConsentPro-Version ist nicht möglich. Führen Sie daher im Vorfeld ein Update auf Version 9.0.x durch.

Informationen für den Administrator

Systemanforderungen

  • Planen Sie bezüglich des freien Speicherplatzes mindestens das Dreifache der Größe der vorhandenen CouchDB‑1‑Datenbank (z. B.: 50 GB Datenbank → 150 GB frei) ein. Während der Migration sind beide Datenbanken aktiv, daher wird zusätzlicher Speicher benötigt.

  • Weitere Details — insbesondere zu RAM und CPU — entnehmen Sie den Systemvoraussetzungen.

Die Datenbankmigration ist CPU‑intensiv und kann E-ConsentPro (inklusive der mobilen Apps) spürbar verlangsamen. Das System kann während der Replikation eklatante Performance-Einbußen aufweisen (siehe unten).

Update-Vorbereitungen

  • Deaktivieren Sie vor dem Update die automatische Bogenaktualisierung.

  • Legen Sie eine Datensicherung gemäß Anleitung an.

  • Falls Sie ein Monitoring auf Ihrem Server eingerichtet haben, deaktivieren Sie dieses und prüfen Sie vor der Aktivierung, ob Anpassungen an diesem Monitoring möglich sind.

  • Prüfen Sie, ob der Port 7984 frei ist und für die neue Datenbank zur Verfügung steht.

Update von E-ConsentPro 9.0 auf Version 10.0

Das E-ConsentPro‑10.0‑Setup führt folgende zusätzlichen Aktionen aus:

  1. Installation von CouchDB 3 unter <Installationsverzeichnis>\couchdb3

    Konfiguration eines zusätzlichen Datenbankdienstes unter Port 7984.

    Dies ist der alt-Text
    Dienstkonfiguration der CouchDB 3

  2. Folgende Zeilen werden zu E-ConsentPro.config hinzugefügt:

    couchdb3.enabled=false
    sync.port=<tomcats http port>

    Dieser Eintrag bereitet die Verwendung der neuen Datenbank vor und darf in keiner Weise manuell geändert werden.

  3. Das Kennwort für die Datenverschlüsselung bei mobiler Aufklärung wird automatisch für die neue Datenbank übernommen, um sicherzustellen, dass alle abgeschlossenen, begonnenen und neu angelegten Vorgänge den identischen Schlüssel verwenden.

Abschluss des Softwareupdates:

  • E-ConsentPro 10 verwendet weiterhin CouchDB 1.

  • CouchDB 3 ist installiert.

Nach dem Abschluss der Installation erfolgt der Start der Datenmigration von CouchDB 1 zu CouchDB 3 vollautomatisch und kann nicht gestoppt werden. Sollte während des Updates gearbeitet werden, landen diese Daten in der alten CouchDB 1, bis die Datenmigration vollständig abgeschlossen ist.

Datenbankmigration mit E-ConsentPro 10.0

E-ConsentPro 10.0 wird mit der neuen Datenbankversion CouchDB 3 ausgeliefert.

Sobald die Datenmigration abgeschlossen ist, führt E-ConsentPro automatisch einen Umschaltvorgang auf die neue CouchDB 3 durch.

Dieser gesamte Prozess ist vollständig automatisiert.

Zur Fortschrittskontrolle steht Ihnen folgendes Statusfenster zur Verfügung.

CouchDB Monitor (optional)

Administratoren können den Fortschritt über das Fenster „CouchDB Monitor“ überwachen:

Dies ist der alt-Text
Die Nutzeroberfläche des CouchDB Monitors

Während der Migration werden unter anderem folgende Informationen dargestellt:

  • Status der Datenbank CouchDB 1

  • Status der Datenbank CouchDB 3

  • Status der Replikationsaufträge

  • Hinweis zum Replikationsstand

Hierbei gelten die folgenden Angaben zur Anzeige des Fortschritts:

  • Das Fenster wird einmal pro Minute aktualisiert.

  • Der Abschnitt "Status der Replikationsaufträge" zeigt den Fortschritt an.

  • Er dient als Übersicht der laufenden Aktivitäten.

  • Hier angezeigte Fehler werden in der Regel durch den Automatismus selbstständig gelöst.

Nach dem Umschaltvorgang (siehe unten) entfällt die Darstellung der CouchDB 1. Es werden nur noch die Werte der CouchDB 3 angezeigt.

Dies ist der alt-Text
Die Nutzeroberfläche des CouchDB Monitors nach der Migration auf Version 3

  • Das Überwachen der Migration ist optional, der Prozess läuft vollautomatisch. Das Fenster CouchDB Monitor dient lediglich dazu, den Fortschritt zu kontrollieren und damit die Dauer bis zum Ende der Migration abschätzen zu können.

  • Bei kritischen Problemen erscheint in der Statuszeile der Anwendung ein Hinweis.

  • Sollte sich eine längere Zeit kein Fortschritt zeigen und die Umstellung nicht erfolgen, wenden Sie sich bitte an unseren Support.

 

Nutzung von E-ConsentPro während der Datenmigration

Technisch bleibt E-ConsentPro nutzbar, jedoch empfehlen wir ausdrücklich, darauf zu verzichten bis der Vorgang abgeschlossen und die Umstellung auf die neue Version der CouchDB erfolgt ist.
Während der Migration ist mit starken Performance-Einbußen zu rechnen.

Die Entfernung der alten CouchDB 1 Datenbank erfolgt mit einem folgenden Release von E-ConsentPro. Wir empfehlen ausdrücklich, die Datenbank nicht manuell zu entfernen. Wenden Sie sich bei Fragen zu diesem Thema bitte an unseren Support.

Umschalten auf CouchDB 3

Die Umstellung der Nutzung von CouchDB 1 auf CouchDB 3 startet, sobald die Datenmigration abgeschlossen ist.
Folgende Aktionen werden automatisch gestartet:

  1. In der ecp.config wird couchdb3.enabled=true gesetzt.

  2. Die Konfiguration wird neu geladen. Ab diesem Zeitpunkt wird nur noch die neue CouchDB 3 verwendet.

  3. Der CouchDB 1 Dienst wird gestoppt und deaktiviert.

Der gesamte Prozess des Umschaltvorgangs läuft im Hintergrund ohne Downtime von E-ConsentPro.

Nacharbeiten

Folgende Schritte sind durchzuführen, nachdem die Umstellung auf die neue Datenbank abgeschlossen ist:

  • Führen Sie abschließend einmal das manuelle Bogenupdate durch um die aktuellen Inhalte zu Version 10 zu erhalten.

  • Aktivieren Sie die automatische Bogenaktualisierung.

  • Passen Sie gegebenenfalls das Monitoring an, mit welchem Sie den Server überwachen.

  • Passen Sie Ihre System-Backup-Routinen bei Bedarf den neuen Gegebenheiten an.

Fragen und Antworten

  • Eine Umstellung auf die CouchDB 3 findet in diesem Fall nicht statt.

  • Wenden Sie sich bitte an unseren Support, um die fehlerhaften Stellen zu identifizieren und zu korrigieren.

Die endgültige Dauer ist von diversen Faktoren abhängig, weswegen eine exakte Einschätzung nicht möglich ist. Im Folgenden finden Sie die Ergebnisse unserer Testsysteme:

Test 1 – (4 vCPU, 16 GB RAM, gp3)
Datenbank Dokumente Größe Dauer
ecp 115.900 0,8 GB 20 min
ecp_signature 582.014 10 GB 1 h 15 min
kis 119.078 41 GB 2 h 5 min

In Test 1 dauerte das gesamte Wartungsfenster auf dem virtuellen Server zwei Stunden und fünf Minuten.
Da die Arbeiten parallel ablaufen, wird die angegebene Dauer pro Datenbank nicht summiert.


Test 2 – (Xeon E3‑1230 v6, 32 GB, SSD)
Datenbank Dokumente Größe Dauer
ecp 692.245 40 GB 1 h 5 min

Grundsätzlich raten wir von diesem Vorgehen ab. Der Prozess ist jedoch robust und setzt den Vorgang anschließend an der Stelle fort, wo er zuletzt unterbrochen wurde.

Nach dem Neustart ist allerdings zunächst eine höhere Auslastung zu erwarten, während die Konsistenz der Datenbanken und der Migrationsstand ermittelt wird.