DOMOS Migration Tool
Übersicht
Das DOMOS Migration Tool wird verwendet, um ein bestehendes DOMOS-System auf eine neue Installation zu migrieren. Dabei spielt es keine Rolle, ob das Quellsystem auf physischer Hardware oder in einer virtuellen Umgebung betrieben wird.
Der komplette Migrationsprozess wird auf dem Zielsystem ausgeführt. Abhängig vom jeweiligen Migrationsszenario können zusätzliche Vorbereitungsschritte auf dem Quellsystem erforderlich sein.
Der Migrationsprozess basiert auf einer direkten Kommunikation zwischen Quell- und Zielsystem. Es wird keine zusätzliche Client- oder Server-Infrastruktur benötigt.
TL;DR
Der folgende TL;DR-Bereich richtet sich ausschließlich an erfahrene Administratoren. Optionale Schritte, zusätzliche Erklärungen und umgebungsspezifische Details können der Übersichtlichkeit halber ausgelassen sein.
Für eine vollständige Schritt-für-Schritt-Anleitung inklusive aller erforderlichen Details und Empfehlungen sollten die weiter unten beschriebenen Abschnitte verwendet werden.
-
Stellen Sie sicher, dass beide Systeme per FQDN oder IP-Adresse erreichbar sind und SSH-Zugriff möglich ist.
-
Erstellen Sie eine Konfigurationsdatei mit dem Namen
domosmigration.cfg, die alle benötigten Verbindungsinformationen enthält (FQDN/IP-Adresse, Benutzername, Passwort usw.). -
Optional: Erstellen Sie einen Backup-Job auf dem Quellsystem, falls zusätzlich Anwendungsdaten migriert werden sollen.
-
Kopieren Sie die Konfigurationsdatei auf das Zielsystem:
scp domosmigration.cfg admin@NEW-SYSTEM-IP:/tmp
- Starten Sie die Migration auf dem Zielsystem:
ssh admin@NEW-SYSTEM-IP run_migration
- Warten Sie, bis der Migrationsprozess abgeschlossen ist und das Zielsystem automatisch neu gestartet wurde.
Vorbereitung des Quellsystems
In den meisten Fällen sind auf dem Quellsystem keine besonderen Vorbereitungen erforderlich.
Die DOMOS WebUI muss vom Zielsystem erreichbar sein und die Anmeldung per Benutzername und Passwort muss möglich sein.
Das Migration Tool unterstützt keine TLS-Clientzertifikats-Authentifizierung. Falls TLS-Clientzertifikate auf dem Quellsystem erzwungen werden, müssen diese vor Beginn der Migration deaktiviert werden.
Falls zusätzlich Anwendungsdaten migriert werden sollen, muss auf dem Quellsystem ein Backup-Client-Job erstellt werden. Der Name dieses Jobs muss später in der Migrations-Konfigurationsdatei angegeben werden.
Zusätzliche Anforderungen
Netzwerk
Das Quellsystem muss vom Zielsystem erreichbar sein.
Eine normale Konfigurationsmigration kommuniziert mit der DOMOS WebUI über Port 10000. Eine Migration von DOMOS7 zu DOMOS7 verwendet stattdessen Port 11000.
Falls zusätzlich eine Datenmigration durchgeführt wird, muss außerdem der Port des Backup-Client-Dienstes erreichbar sein. Standardmäßig verwendet der Backup-Client-Dienst Port 9877.
Migrations-Konfigurationsdatei
Der Migrationsprozess wird über eine Konfigurationsdatei gesteuert.
Die Konfigurationsdatei muss den Namen domosmigration.cfg tragen.
Beispielkonfiguration:
[Remote]
# optional: Standardwert ist admin
username = admin
# optional: Standardwert ist admin
password = admin (eigenes Passwort eintragen)
fqdn = 172.16.0.222 (FQDN/IP des Quellsystems eintragen)
# optional: Standardwert ist 10000
# Achtung: Für eine DOMOS7-zu-DOMOS7-Migration muss Port `11000` verwendet werden.
port = 10000
# optional: Standardwert ist 5
domosversion = 6 (DOMOS-Version des Quellsystems eintragen)
# optional: Datenmigration
[DataMigration]
bakres=MyBakResJob
[License]
# optional: DOMOS-Lizenz
filename = D202317000003.lic
Die einzelnen Bereiche werden nachfolgend beschrieben.
Abschnitt: Remote
Dieser Abschnitt ist verpflichtend und definiert die Verbindungseinstellungen für das Quellsystem.
| Parameter | Beschreibung |
|---|---|
username | Optional. Benutzername für die Anmeldung. Standard: admin |
password | Optional. Passwort für die Anmeldung. Standard: admin |
fqdn | FQDN oder IP-Adresse des Quellsystems |
port | Optional. Port der DOMOS WebUI. Standard: 10000. Achtung: Für eine DOMOS7-zu-DOMOS7-Migration muss Port 11000 verwendet werden. |
domosversion | Optional. DOMOS-Version des Quellsystems. Verfügbare Werte: 5, 6, 7 |
Abschnitt: DataMigration
Dieser Abschnitt ist optional und nur erforderlich, wenn zusätzlich Anwendungsdaten migriert werden sollen.
Das Migration Tool lädt den BackupClient vom Quellsystem herunter und verwendet diesen zur Erstellung und Wiederherstellung des Anwendungs-Backups.
| Parameter | Beschreibung |
|---|---|
bakres | Name des BackupClient-Jobs für die Datenmigration |
Abschnitt: License
Dieser optionale Abschnitt ermöglicht die Installation einer neuen DOMOS-Lizenz während der Migration.
Das normale Konfigurations-Backup enthält bereits die bestehende DOMOS-Lizenz. Dieser Abschnitt wird daher nur benötigt, wenn eine Ersatzlizenz installiert werden muss.
| Parameter | Beschreibung |
|---|---|
filename | Name der Lizenzdatei |
Durchführung der Migration
Der Migrationsprozess besteht aus zwei Schritten.
Schritt 1: Benötigte Dateien kopieren
Die Migrations-Konfigurationsdatei sowie gegebenenfalls eine neue Lizenzdatei müssen in das Verzeichnis /tmp auf dem Zielsystem kopiert werden.
Die empfohlene Methode hierfür ist Secure Copy (scp).
Die Konfigurationsdatei muss den Namen domosmigration.cfg tragen.
scp domosmigration.cfg admin@NEW-SYSTEM-IP:/tmp
scp DOMOSLIC.lic admin@NEW-SYSTEM-IP:/tmp
Das Verzeichnis /tmp wird bei jedem Neustart automatisch geleert. Die kopierten Dateien werden daher nach Abschluss der Migration automatisch entfernt.
Schritt 2: Migration starten
Die Migration wird per SSH gestartet.
Der Migrationsbefehl funktioniert über den Benutzer admin nur solange das Root-Passwort des Zielsystems nicht geändert wurde.
Wurde das Root-Passwort bereits geändert, muss die Migration direkt als root auf der Kommandozeile des Zielsystems gestartet werden.
Starten Sie die Migration mit folgendem Befehl:
ssh admin@NEW-SYSTEM-IP run_migration
Die Ausgabe der Migration wird direkt im Terminal angezeigt. Während des Migrationsprozesses ist keine interaktive Eingabe erforderlich.
Beispielausgabe:
$ ssh admin@172.16.0.23 run_migration
admin@172.16.0.23's password:
2023-04-26 11:04:39 [INFO] Login into remote system ...
2023-04-26 11:04:39 [INFO] Login ok
2023-04-26 11:04:39 [INFO] Downloading configuration backup ...
2023-04-26 11:04:41 [INFO] Download ok
2023-04-26 11:04:41 [INFO] Login into remote system ...
2023-04-26 11:04:41 [INFO] Login ok
2023-04-26 11:04:41 [INFO] Shutting down remote system ...
2023-04-26 11:04:41 [INFO] Restoring old configuration ...
2023-04-26 11:05:28 [INFO] Notice: Restoring sensor successful.
2023-04-26 11:05:28 [INFO] Notice: The database has been successfully restored.
2023-04-26 11:05:28 [INFO] Notice: Restoring management successful.
2023-04-26 11:05:28 [INFO] Error from localhost.localdomain: The node names are not configured correctly.
2023-04-26 11:05:28 [INFO] Notice: Restoring cluster successful.
2023-04-26 11:05:28 [INFO] Patching configuration ...
2023-04-26 11:05:28 [INFO] Add key system.keymap with value de
2023-04-26 11:05:28 [INFO] Add key sssd.section.ssh.ssh_use_certificate_keys.value with value True
2023-04-26 11:05:28 [INFO] Installing new license ...
2023-04-26 11:05:28 [INFO] System reboot
Nachdem das Zielsystem erfolgreich neu gestartet wurde, ist die Migration abgeschlossen.
Während der Migration übernimmt das Zielsystem die Netzwerkkonfiguration des Quellsystems.
Um IP-Adresskonflikte zu vermeiden, stellen Sie sicher, dass das Quellsystem heruntergefahren wird, bevor das migrierte Zielsystem im Netzwerk aktiv wird.