Wildfly-Servermigration
34.0.0.Final
Das JBoss Server Migration Tool ist ein Tool zur Migration von JBoss-Anwendungsservern. Es liest die Serverkonfigurationsdateien für eine frühere Version von WildFly oder JBoss EAP, die als Quellserver bezeichnet wird, und migriert sie auf die neueste Version oder den Zielserver. Neben den Konfigurationen ist das Tool auch in der Lage, Module, Bereitstellungen und andere Ressourcen zu migrieren, die sich auf dem Quellserver befinden.
Java 8.0 (Java SDK 1.8) oder höher
Apache Maven
Verwenden Sie den folgenden Befehl, um das Tool aus dem Quellcode zu erstellen:
mvn clean install
Navigieren Sie zum Verzeichnis dist/standalone/target/ und entpacken Sie die Datei jboss-server-migration-VERSION_NUMBER.zip
unzip jboss-server-migration-34.0.0.Final-SNAPSHOT.zip
Öffnen Sie ein Terminal und navigieren Sie zum Verzeichnis dist/standalone/target/jboss-server-migration/ .
Führen Sie den folgenden Befehl aus.
For Linux|Mac: ./jboss-server-migration.sh -s SOURCE_SERVER_PATH -t TARGET_SERVER_PATH For Windows: jboss-server-migration.bat -s SOURCE_SERVER_PATH -t TARGET_SERVER_PATH
Ersetzen Sie SOURCE_SERVER_PATH durch den Pfad zur vorherigen Version der Serverinstallation, von der Sie migrieren möchten, zum Beispiel: ${user.home}/wildfly-26.0.0.Final/
Ersetzen Sie TARGET_SERVER_PATH durch den Pfad zur aktuellen Version der Serverinstallation, zu der die alte Konfiguration migriert werden soll, zum Beispiel: ${user.home}/wildfly-31.0.0.Final/
Wenn Sie den Befehl ausführen, identifiziert das Tool die Quell- und Zielserver anhand der bereitgestellten Pfade und startet die Servermigration.
---------------------------------------------------------- ---- JBoss Server Migration Tool ----------------------- ---------------------------------------------------------- Retrieving servers... INFO SOURCE server name: WildFly Full, version: 26.0.0.Final. INFO TARGET server name: WildFly Full, version: 34.0.0.Final-SNAPSHOT. ---------------------------------------------------------- ---------------------------------------------------------- Server migration starting...
Jede Servermigration besteht aus mehreren Migrationsaufgaben, die möglicherweise eine Benutzerinteraktion erfordern oder nicht.
INFO --- Migrating modules requested by environment... INFO Module cmtool.module1:main migrated. INFO --- Migrating standalone server... INFO No source's standalone content found to migrate. INFO Source's standalone configurations found: [standalone.xml] INFO Migrating standalone configuration standalone.xml... INFO Subsystem infinispan updated. INFO Subsystem undertow updated. INFO Security realms migrated. INFO Non-persistent deployments found in standalone/deployments: [cmtool-helloworld5.war, cmtool-helloworld6.war] INFO Non-persistent deployment cmtool-helloworld5.war migrated. INFO Non-persistent deployment cmtool-helloworld6.war migrated. INFO --- Migrating managed domain... INFO No source's domain content found to migrate. INFO Source's domain configurations found: [domain.xml] INFO Migrating domain configuration domain.xml... INFO Subsystem infinispan updated. INFO Subsystem undertow updated. INFO Source's host configurations found: [host.xml] INFO Migrating host configuration host.xml... INFO Migrating host master... INFO Security realms migrated.
Sobald die Servermigration abgeschlossen ist, wird ein Task Summary angezeigt, der die Ergebnisse der Migrationsaufgaben zusammenfasst. Servermigration abgeschlossen.
INFO ---------------------------------------------------------------------------------------------- Task Summary ---------------------------------------------------------------------------------------------- server .............................................................................. SUCCESS modules.migrate-modules-requested-by-user .......................................... SUCCESS modules.migrate-modules-requested-by-user.migrate-module(id=cmtool.module1:main) .. SUCCESS standalone ......................................................................... SUCCESS standalone-configurations ......................................................... SUCCESS standalone-configuration(source=standalone.xml) .................................. SUCCESS domain ............................................................................. SUCCESS domain-configurations ............................................................. SUCCESS domain-configuration(source=domain.xml) .......................................... SUCCESS host-configurations ............................................................... SUCCESS host-configuration(source=host.xml) .............................................. SUCCESS
Sobald der Vorgang abgeschlossen ist, sollte die folgende Meldung angezeigt werden.
---------------------------------------------------------------------------------------------- Migration Result: SUCCESS ----------------------------------------------------------------------------------------------
Weitere Berichte finden Sie im Verzeichnis reports/ .
migration-report.html : Der HTML-Bericht ist ein schön formatierter Bericht, der die detaillierten Ergebnisse der Migration zeigt.
migration-report.xml : Die XML-Datei enthält alle erfassten Migrationsdaten.
Dateiprotokolle befinden sich möglicherweise im Verzeichnis logs/ .
migration.log : Das Protokoll enthält detaillierte Informationen zur Ausführung der Servermigration.
Fehler „Migration fehlgeschlagen“.
Wenn Sie eine Fehlermeldung erhalten, dass die Migration fehlgeschlagen ist, weil Version Y keine Migrationen von Version Beispielsweise können Sie das Migration Tool 1.11.0 Final nicht für die Migration von WildFly 16.0.0 auf WildFly 22.0.0 verwenden. Hierzu benötigen Sie das Migration Tool Version 1.10.0 Final.
Issue-Tracker
