Migration von EasyUC 3.x

Wozu dient das

Die Migration übernimmt die Daten einer EasyUC-Anlage der Version 3.74 oder 3.75 in eine frisch installierte 4.x-Installation. Sie tragen im Manager den SSH-Zugang zur alten Anlage ein. Der Manager erzeugt dort ein verschlüsseltes Migrationsarchiv (.eucmig), holt es ab, prüft es in einem Probelauf und spielt es erst danach ein.

Die alte Anlage wird ausschließlich gelesen. Datenbank, Container und Installationsverzeichnis bleiben dort unverändert. Die IDs der Datensätze bleiben erhalten; eine Zusammenführung mit vorhandenen Daten findet nicht statt.

Der Menüpunkt erscheint nur mit dem Modul CUCM.

Voraussetzungen

Eine frisch installierte 4.x-Installation ohne CUCM-Verbindungen. Sonst meldet die Prüfung den Blocker TARGET_NOT_EMPTY. Ein Werksreset stellt den leeren Zustand her.
Modul CUCM aktiv.
SSH-Zugang zur alten Anlage mit einem Konto, das root ist oder per sudo zu root werden darf.
Netzwerkfreigabe von der Appliance zum SSH-Port der alten Anlage.
Genug freier Platz unter /tmp auf der alten Anlage für das Archiv.
Ohne Netzwerkverbindung zur alten Anlage: das von Hand erzeugte Archiv und dessen Passphrase.

Schritt für Schritt

Öffnen Sie im Manager die Seite Migration 3.x.
Schritt 1 Altsystem verbinden: Tragen Sie Host oder IP der alten Anlage, SSH-Port, Benutzer, Passwort und bei Bedarf das sudo-Passwort ein.
Wählen Sie Zeitfenster Verlaufsdaten und CDR-Historie.
Wählen Sie Verbindung pruefen. Die Vorprüfung zeigt erkannte Version, SSH, Rechte, Docker und freien Platz.
Wählen Sie Migration starten. Der Manager erzeugt das Archiv auf der alten Anlage, holt es ab und räumt dort auf. Die Seite kann offen bleiben.
Wählen Sie Weiter zur Pruefung.
Schritt 2 Pruefen: Wählen Sie Pruefung starten. Der Probelauf schreibt nichts in die Zieldatenbank.
Lesen Sie den Bericht: Blocker, Warnungen und die Uebersicht je Inhaltsbereich. Laden Sie ihn bei Bedarf als HTML oder JSON herunter.
Wählen Sie Weiter zur Migration. Das ist gesperrt, solange Blocker vorliegen.
Schritt 3 Migrieren: Entscheiden Sie über Verlaufsdaten uebernehmen und CDR-Historie uebernehmen und die Zeitfenster.
Wählen Sie Migration starten und verfolgen Sie das Live-Log.
Wählen Sie Weiter zum Abschluss. Schritt 4 Abschluss: Lesen Sie Ergebnis der Migration und Manuelle Nacharbeiten.
Wählen Sie Archiv aus dem Speicher loeschen. Das Archiv enthält Zugangsdaten im Klartext.

Felder und Optionen

Felder und Optionen
Feld / Aktion	Bedeutung und Verwendung
SSH-Port	1 bis 65535.
sudo-Passwort	Leer lassen, wenn es mit dem Passwort identisch ist oder der Benutzer bereits root ist.
Zeitfenster Verlaufsdaten	Logs, Tickets, Aufträge und ähnliche Verlaufstabellen. Älteres wird beim Export nicht mitgenommen. Standard beim Import: 12 Monate.
CDR-Historie	Verbindungsdatensätze. Sie sind der größte Anteil der Datenmenge. Standard beim Import: 3 Monate; „keine CDR uebernehmen“ ist möglich.
Archiv stattdessen manuell hochladen	Für Fälle ohne Netzverbindung zur alten Anlage: `.eucmig`-Datei ablegen und die Passphrase des Archivs eintragen.
Archiv im Speicher	Zeigt Datei, Größe, Bereitstellungszeit und ob eine Passphrase hinterlegt ist.
Blocker uebergehen	Nur sinnvoll bei `TARGET_NOT_EMPTY`, wenn die Zieldatenbank bewusst überschrieben werden soll. Zum Freischalten `FORCE` eintippen und die Prüfung wiederholen. Alle anderen Blocker bleiben bestehen.
Stammdaten und Dateien	Werden immer übernommen. Verlaufsdaten und CDR-Historie sind abwählbar.

Ergebnis prüfen und Fehler eingrenzen

Der Abschluss zeigt das Ergebnis der Migration mit eingefügten und übersprungenen Zeilen je Inhaltsbereich und „Der Bericht nennt keine offenen Nacharbeiten.“ oder die Liste der Nacharbeiten.
„Abruf noch nicht moeglich“ mit „Das steht dem Abruf im Weg“: Die Vorprüfung nennt die Hindernisse, zum Beispiel fehlende root-Rechte oder ein nicht laufendes Docker.
Blocker TARGET_NOT_EMPTY: Im Ziel sind bereits CUCM-Verbindungen angelegt. Führen Sie zuerst einen Werksreset durch.
„Export durchgelaufen — mit Warnungen“: Einzelne Teile wurden ausgelassen. Was fehlt, steht in der Ausgabe und fällt im Probelauf auf.
„Auf der alten Anlage sind Reste liegen geblieben“: Das Aufräumen ist nicht durchgelaufen. Löschen Sie das genannte Verzeichnis auf der alten Anlage von Hand, sonst liegt dort eine entschlüsselbare Kopie der Daten.
Warnungen im Bericht: Die Migration läuft, das Ergebnis ist aber nachzukontrollieren.
Die Seite schreibt Umlaute in ihren Beschriftungen als ae, oe und ue. Dieses Kapitel gibt die Beschriftungen so wieder, wie die Oberfläche sie zeigt.