Replikationspause manuell
Warum ist eine Replikationspause erforderlich?
Bei manchen MACH formsolutions Updates wird die Datenstruktur geändert. Die neue Formularserver-Version und ihre zugehörige Datenstruktur sind möglicherweise nicht mit älteren Formularserver-Versionen und deren Datenstruktur kompatibel. Werden während des Updates bereits Daten zwischen Servern mit unterschiedlichen Release-Ständen repliziert, kann der empfangende Server diese Daten möglicherweise nicht korrekt verarbeiten.
Replikationspause bedeutet, dass keine Daten zwischen inkompatiblen Serverversionen übertragen werden, bis alle Server die erforderlichen Updates erhalten haben.
Müssen Sie die Replikation manuell pausieren?
Die manuelle Replikationspause ist nur dann erforderlich, wenn
- Sie als Betreiber mehrere Formularserver bereitstellen, zwischen denen eine Replikation eingerichtet ist.
- Z. B. wenn Sie als Betreiber eine QS-Umgebung bereitstellen, und Formulare von Ihrem Produktivsystem auf die QS-Umgebung replizieren.
- Die QS-Umgebung zuerst das neue Release erhält, während das Produktiv-System noch mit einer älteren Release-Version läuft.
- Vom Produktiv-Formularserver (älteres Release) zum QS-System (neues Release) repliziert wird.
Tabellarisch dargestellt:
Angenommen, Release X erfordert eine Replikationspause.
Wenn der Zielserver auf Release X aktualisiert werden soll, während der Quellserver noch auf einem älteren Release läuft, müssen Sie die Replikation vor dem Update manuell pausieren.
| Situation | Replikationspause | Ihre Handlung |
|---|---|---|
| Quellserver ist bereits auf Release X, Zielserver noch auf einer Version vor X | automatisch | Keine |
| Zielserver soll auf X aktualisiert werden, Quellserver noch auf einer Version vor X | manuell erforderlich | Replikation vor dem Update pausieren und nach dem Update wieder aktivieren |
Konstellation 1: Quellserver ist bereits auf Release X
Der Zielserver ist noch auf einem älteren Release.
Wenn der Quellserver schon das neue Release mit neuer Datenstruktur hat, der Zielserver aber noch nicht aktualisiert ist, kann der Zeilserver die neuen Datenstrukturen nicht korrekt verarbeiten.
Handlungsanweisung
Keine.
Die Replikation wird automatisch pausiert, solange der Zielserver noch nicht auf Release X aktualisiert wurde. Mit dem Update des Zielservers auf Release X wird die Replikation automatisch wieder aufgenommen.
Beispiel: MACH formsolutions Verlag
Der Server pdf.form-solutions.net wird immer mit dem aktuellsten Release betrieben. Wenn Sie den MACH formsolutions Verlag replizieren, kann daher der Quellserver bereits auf dem neuen Release sein, während Ihr Zielserver noch auf dem vorherigen Release läuft. Die Replikation ist in diesem Fall automatisch pausiert.
Konstellation 2: Zielserver wird auf das neue Release aktualisiert
Wenn der Zielserver auf Release X aktualisiert wird, während der Quellserver noch auf einem älteren Release läuft, können die vom Quellserver replizierten Daten mit der neuen Datenstruktur des Zielservers inkompatibel sein.
Diese Konstellation tritt beispielsweise auf, wenn ein neues Release zunächst in einer QS-Umgebung eingesetzt wird, während der produktiv eingesetzte Quell-Formularserver noch auf dem vorherigen Release läuft.
Handlungsanweisung
Die Replikation muss von Ihnen manuell pausiert werden. Aktualisieren Sie anschließend alle an der Replikation beteiligten Server auf einen kompatiblen Release-Stand.
Erst wenn alle Server kompatibel zueinander sind, darf die Replikation wieder aktiviert werden.
Folgen Sie der Anleitung unten: Replikationspause aktivieren
So pausieren Sie die Replikation vor dem Update manuell
Pausieren Sie die Replikation vor dem Update des Zielservers.
Dazu ändern Sie auf dem Replikationsziel vorübergehend die URL der Replikationsquelle für Assistenten.
Um die Replikation vorübergehend zu unterbinden, ändern Sie die URL der Replikationsquelle auf eine bewusst nicht erreichbare Adresse. Verwenden Sie eine eindeutige Kennzeichnung, damit Sie die ursprüngliche URL nach dem Update problemlos wiederherstellen können.
Melden Sie sich als Supermandanten-Benutzer mit Administratorrechten an.
Rufen Sie aus der Werkzeugleiste im Formulareditor den Dialog Administration (Button Schraubenschlüssel) auf.
Im Dialog Administration finden Sie im Reiter Replikations-Konfiguration die vorhandenen Replikationseinstellungen.
- Mit dem Button Eintrag editieren (Papier/Stift) übernehmen Sie einen Eintrag zum Editieren in die Eingabefelder unter Replikation.
- Ändern Sie die URL so, dass die Replikationsquelle nicht erreichbar ist. Die Änderung sollte eindeutig gekennzeichnet und leicht rückgängig zu machen sein.
- z. B. https://pdf.form-solutions.net/metaform-replication/replication/ wird zur nicht erreichbaren Adresse https://DISABLED-UNTIL-SOURCE-IS-ON-4.114-pdf.form-solutions.net/metaform-replication/replication/
- Übernehmen Sie die Replikations-Konfiguration als vorhandene Replikation
- Bestätigen Sie die Änderung mit OK
- Die Replikation ist pausiert.
Kontrolle: Im Serverlog können Sie erkennen, dass die Replikationsversuche aufgrund der nicht erreichbaren Adresse mit einer UnknownHostException fehlschlagen. Dies ist während der manuellen Replikationspause erwartbar.
Replikation nach dem Update wieder aktivieren
Nachdem alle an der Replikation beteiligten Server auf einen kompatiblen Release-Stand aktualisiert wurden, stellen Sie die ursprüngliche URL der Replikationsquelle wieder her.
Melden Sie sich als Supermandanten-Benutzer mit Administratorrechten an.
Rufen Sie aus der Werkzeugleiste im Formulareditor den Dialog Administration (Button Schraubenschlüssel) auf.
Im Dialog Administration finden Sie im Reiter Replikations-Konfiguration die vorhandenen Replikationseinstellungen.
- Mit dem Button Eintrag editieren (Papier/Stift) übernehmen Sie einen Eintrag zum Editieren in die Eingabefelder unter Replikation.
- Stellen Sie die ursprüngliche URL der Replikationsquelle wieder her.
- Übernehmen Sie die Replikations-Konfiguration als vorhandene Replikation
- Bestätigen Sie die Änderung mit OK
- Die Replikation startet automatisch wieder.