migration de serveur Wildfly
34.0.0.Final
L'outil de migration de serveur JBoss est un outil qui migre les serveurs d'applications JBoss. Il lit les fichiers de configuration du serveur d'une version précédente de WildFly ou de JBoss EAP, appelé serveur source, et les migre vers la dernière version ou serveur cible. Outre les configurations, l'outil est également capable de migrer des modules, des déploiements et d'autres ressources trouvées dans le serveur source.
Java 8.0 (Java SDK 1.8) ou version ultérieure
Apache Maven
Utilisez la commande suivante pour créer l'outil à partir des sources :
mvn clean install
Accédez au répertoire dist/standalone/target/ et décompressez le fichier jboss-server-migration-VERSION_NUMBER.zip
unzip jboss-server-migration-34.0.0.Final-SNAPSHOT.zip
Ouvrez un terminal et accédez au répertoire dist/standalone/target/jboss-server-migration/ .
Exécutez la commande suivante.
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
Remplacez SOURCE_SERVER_PATH par le chemin d'accès à la version précédente de l'installation du serveur à partir de laquelle vous souhaitez migrer, par exemple : ${user.home}/wildfly-26.0.0.Final/
Remplacez TARGET_SERVER_PATH par le chemin d'accès à la version actuelle de l'installation du serveur vers laquelle vous souhaitez migrer l'ancienne configuration, par exemple : ${user.home}/wildfly-31.0.0.Final/
Lorsque vous exécutez la commande, l'outil identifie les serveurs source et cible à partir des chemins fournis et démarre la migration du serveur.
---------------------------------------------------------- ---- 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...
Chaque migration de serveur se compose de plusieurs tâches de migration, qui peuvent nécessiter ou non une interaction de l'utilisateur.
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.
Une fois la migration du serveur terminée, un rapport Task Summary s'affichera, résumant les résultats des tâches de migration. Migration du serveur terminée.
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
Vous devriez voir le message suivant une fois l'opération terminée.
---------------------------------------------------------------------------------------------- Migration Result: SUCCESS ----------------------------------------------------------------------------------------------
Des rapports supplémentaires peuvent être trouvés dans le répertoire reports/ .
migration-report.html : Le rapport HTML est un rapport bien formaté montrant les résultats détaillés de la migration.
migration-report.xml : Le fichier XML inclut toutes les données de migration collectées.
Les fichiers journaux peuvent être trouvés dans le répertoire logs/ .
migration.log : Le journal contient des informations détaillées sur l'exécution de la migration du serveur.
Erreur d'échec de la migration
Si vous recevez un message d'erreur vous indiquant que la migration a échoué car la version Y ne prend pas en charge les migrations à partir de la version X, veuillez vous référer à la section Versions pour voir de quelle version de l'outil de migration vous avez besoin pour migrer vos versions. Par exemple, vous ne pouvez pas utiliser l'outil de migration 1.11.0 Final pour migrer WildFly 16.0.0 vers WildFly 22.0.0. Pour cela, vous avez besoin de l'outil de migration version 1.10.0 Final.
Suivi des problèmes
