Um eventuellen Datenverlust zu vermeiden, sollte eine Sicherheitskopie der alten DLE Installation angelegt werden. Dies kann durch eine Kopie geschehen.
Ein Update ist auch ohne Sicherung durchführbar. Obwohl die Migration auf die alte DLE nur lesend zugreift, ist ein Update ohne Rücksicherung nicht empfehlenswert.
Soll die neue DLE in denselben Pfad der alten DLE installiert werden, muss der Ordner der alten DLE umbenannt oder verschoben werden.
In beiden Fällen (mit und ohne Sicherung) ist im Falle eines misslungenen Updates oder Installation eine Wiederherstellung der alten DLE möglich und alle Funktionalitäten bleiben vorhanden.
Nachdem die alte DLE gesichert und / oder verschoben bzw. umbenannt wurde, kann mit der Installation der neuen DLE fortgefahren werden. Siehe dazu das Kapitel zur Neu-Installation.
Die neue DLE enthält nun aktuelle Pakete, die von Vision-Flow gepflegt werden. Individuelle Pakete sind im Installer nicht enthalten und daher auch in der neuen Installation nicht vorhanden. Ebenfalls zurückgesetzt wurden Konfigurationsdateien, Menüs, etc.
Um diese Dateien in die neue DLE einzupflegen, liegt dem Installer ein Migrationstool bei. Dieses Migrationstool ist, wie der Installer auch, ein ausführbares Java-Archiv. Zum Ausführen des sogenannten "Migrators", siehe auch das Kapitel "Manueller start" der Neu-Installation.
Beim Starten über die Kommandozeile lässt sich der Migrator über mehrere Parameter steuern. Die folgenden beiden sind dabei zwingend notwendig:
Optionale Parameter sind:
Um für die Protokollierung den Verbose-Modus zu aktivieren (viele Ausgaben), ist folgender Runtime-Switch zu setzen, der im grafischen Modus automatisch aktiviert ist:
Ein typischer Aufruf für die Kommandozeilenvariante des Migrators könnte daher lauten:
java -Ddle.migratedebug=true -jar DLEMigrator.jar -From C:\dleAlt -To C:\Programme\DLE
Dieser Modus ist nur möglich, wenn eine Oberfläche installiert und unterstützt wird. Ist dies nicht der Fall, wie beispielsweise bei gewissen Serverkonfigurationen, wird der Migrator nur im Kommandozeilenmodus gestartet. Im grafischen Modus sind die Parameter "-exclude", "-From" und "-To" optional. Sind sie dennoch angegeben, werden die entsprechenden Felder im Migrations-Fenster ausgefüllt. Das heißt, dass dieser Modus auch ohne Parameter gestartet werden kann - das Standardverhalten bei einem Start über Doppelklick.
Die grafische Oberfläche des Migrators ist unkompliziert gestaltet und bietet alle Möglichkeiten der Kommandozeilenversion.
In der ersten Zeile ist der Pfad zur alten DLE einzugeben. Über den Button "Select" öffnet sich ein Suchfenster mit dem der Pfad ausgewählt werden kann.
Analog dazu wird in der zweiten Zeile der Pfad der neuen DLE eingegeben.
Mit einem Klick auf den Button "Migrate" wird der Migrationsprozess gestartet. Im darunter liegenden Textfeld erscheinen die Logausgaben wobei im grafischen Modus alle Ausgaben protokolliert werden (siehe Kommandozeilen-Parameter dle.migratedebug). Die Zusammenfassung über die Anzahl der Warnungen und Fehler erscheint am Ende des Logs.
Sind keine Warnungen oder Fehler aufgetreten, ist die Migration erfolgreich abgeschlossen.
Ab Version 1.4 der DLE wurde eine neue paketorientierte Ordnerstruktur eingeführt.
Innerhalb eines Pakets sind die Strukturen vorgegeben. Für benutzerdefinierte Startskripte und Dokumentationen sind dabei die beiden Verzeichnisse "doc" und "scripts" jeweils im Unterordner [PAKETNAME]/resources/ vorgesehen. Diese Verzeichnisse sind standardmäßig nicht vorhanden und müssen angelegt werden, sobald Inhalte darin platziert werden sollen.
Drei verschiedene Typen von Logausgaben informieren über den Fortschritt oder Abschluss der Migration:
| Präfix | Name | Bedeutung |
|---|---|---|
| [INFO] | Informationsausgabe | Sie zeigt Informationen aller Art an, ist mit dem Parameter dle.migratedebug konfigurierbar und im grafischen Modus immer sichtbar. |
| [WARN] | Warnungsausgabe | Nachrichten dieser Art deuten auf einen potentiellen Fehler hin. Die restliche Migration ist davon aber unbeeinflusst und wird fortgeführt. Einträge, die als Warnung gekennzeichnet sind, sollten anschließend manuell überprüft und gegebenenfalls per Hand nachgezogen werden. |
| [ERROR] | Fehlerausgabe | Wird eine Fehlermeldung ausgegeben, bedeutet dies den Abbruch der Migration. Solche Situationen können die neue DLE in einen undefinierten zustand versetzen. Der Fehler ist in so einem Fall aufgrund der Nachricht zu beheben und das Migrationstool erneut auszuführen. |
