Mandantenumzug

Diese Anleitung beschreibt, welche Schritte notwendig sind, um einen oder mehrere Kunden von einem Formularserversystem auf ein anderes Formularserversystem zu migrieren. Das Skript geht dabei davon aus, dass bei der Ausführung des Datenexportes folgende Punkte mit dem Kunden vereinbart worden sind:

  • Der Kunde wurde informiert und weiß auch, dass das System in der Zeit des vollständigen Umzuges nicht genutzt werden kann.

  • Der Kunde ist ferner darüber informiert, dass er, sofern er nicht über die Multidomainfunktionalität verfügt, er die Links händisch an allen hinterlegten Stellen ändern muss.

  • Im Falle eines Mulitdomain-Kunden muss er dafür sorgen, dass der DNS-Eintrag auf den neuen Server umgestellt wird.

  • Die Art der Übertragung der Daten zwischen Quell- und Zielsystem (WebServiceDefinition) muss abgestimmt werden.

  • Der zu migrierende Kunde darf auf dem Zielsystem noch nicht vorhanden sein.

  • Eine vollständige Liste aller Kunden, incl. zukünftiger Absender-Mailadresse, muss vorliegen.

Außerdem gilt es zu beachten, dass die erwähnten Skripte nicht Teil der Softwareauslieferung sind. Diese werden Ihnen für einen Umzug zur Verfügung gestellt.

Export der Mandanten

Für den Export der Mandanten sind die Skript-Dateien dumpData.sh und functions.sh sowie data.sh notwendig. Fuctions.sh sind dabei nur Hilfsskripte und müssen nicht extra ausgeführt werden.

Das Skript dumpData.sh kann mittels bash dumpData.sh ausgeführt werden. Es werden folgende Daten dabei gesichert:

  • Kundendatenbank von mongo und mysql

  • Alle Links, die in der Tabelle ofs.pdfstart für den Kunden vorhanden sind.

  • Kundenspezifische Dumps von den Daten in der mongo. Einträge für Kundenspezifische Replikationseinträge sowie evtl. Passwortzurücksetzungsanfragen werden dabei ignoriert.

  • Das Kundenverzeichnis auf Dateisystemebene

  • Vorhandene Kundenlogos

  • Die jeweiligen CMS-Keys müssen von Hand exportiert und auch später wieder von Hand eingespielt werden, da es ansonsten zu doppelten Primary-Einträgen kommen kann.

Bei der Ausführung des Skriptes werden neben Zugangsdaten für mysql und mongo auch die zu exportierenden Kundennummern und Empfängermailadressen abgefragt. Diese Werte sind jeweils durch ein Leerzeichen getrennt anzugeben.

Import von Mandanten

Für den Import der Mandanten sind die Skript-Dateien reimport.sh und functions.sh und data.sh notwendig. Fuctions.sh und data.sh sind dabei nur Hilfsskripte und müssen nicht extra ausgeführt werden.

Das Skript reimport.sh kann mittels bash reimport.sh ausgeführt werden. Es werden folgende Daten wieder eingespielt:

  • Kundendatenbank von mongo und mysql

  • Alle Links, die in der Tabelle ofs.pdfstart für den Kunden vorhanden sind.

  • Kundenspezifische Dumps von den Daten in der mongo. Einträge für Kundenspezifische Replikationseinträge sowie evtl. Passwortzurücksetzungsanfragen werden dabei ignoriert.

  • Das Kundenverzeichnis auf Dateisystemebene

  • Vorhandene Kundenlogos

  • Die jeweiligen CMS-Keys müssen von Hand exportiert und auch später wieder von Hand eingespielt werden, da es ansonsten zu doppelten Primary-Einträgen kommen kann.

Bei der Ausführung des Skriptes werden neben Zugangsdaten für mysql und mongo auch die zu importierenden Kundennummern abgefragt. Die Kundennummern sind dabei durch Leerzeichen getrennt anzugeben.