La herramienta de migración de servidores JBoss es una herramienta que migra servidores de aplicaciones JBoss. Lee los archivos de configuración del servidor para una versión anterior de WildFly o JBoss EAP, denominado servidor de origen, y los migra a la última versión o al servidor de destino. Además de las configuraciones, la herramienta también es capaz de migrar módulos, implementaciones y otros recursos que se encuentran en el servidor de origen.
Java 8.0 (Java SDK 1.8) o posterior
experto apache
Utilice el siguiente comando para crear la herramienta desde el código fuente:
mvn clean install
Navegue hasta el directorio dist/standalone/target/
y descomprima el archivo jboss-server-migration-VERSION_NUMBER.zip
unzip jboss-server-migration-34.0.0.Final-SNAPSHOT.zip
Abra una terminal y navegue hasta el directorio dist/standalone/target/jboss-server-migration/
.
Ejecute el siguiente comando.
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
Reemplace SOURCE_SERVER_PATH
con la ruta a la versión anterior de la instalación del servidor desde la que desea migrar, por ejemplo: ${user.home}/wildfly-26.0.0.Final/
Reemplace TARGET_SERVER_PATH
con la ruta a la versión actual de la instalación del servidor a la que desea migrar la configuración anterior, por ejemplo: ${user.home}/wildfly-31.0.0.Final/
Cuando ejecuta el comando, la herramienta identifica los servidores de origen y de destino a partir de las rutas proporcionadas e inicia la migración del servidor.
---------------------------------------------------------- ---- 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...
Cada migración de servidor consta de varias tareas de migración, que pueden requerir o no la interacción del usuario.
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.
Una vez realizada la migración del servidor, se mostrará un informe Task Summary
que resume los resultados de las tareas de migración. Migración del servidor realizada.
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
Debería ver el siguiente mensaje cuando se complete.
---------------------------------------------------------------------------------------------- Migration Result: SUCCESS ----------------------------------------------------------------------------------------------
Se pueden encontrar informes adicionales en el directorio reports/
.
migration-report.html
: El informe HTML es un informe con un formato agradable que muestra los resultados detallados de la migración.
migration-report.xml
: el archivo XML incluye todos los datos de migración recopilados.
Los registros de archivos se pueden encontrar en el directorio logs/
.
migration.log
: el registro contiene información detallada sobre la ejecución de la migración del servidor.
Error de migración fallida
Si recibe un mensaje de error que le indica que la migración falló debido a que la versión Y no admite migraciones desde la versión X, consulte la sección Versiones para ver qué versión de la herramienta de migración necesita para migrar sus versiones. Por ejemplo, no puede utilizar la herramienta de migración 1.11.0 Final para migrar WildFly 16.0.0 a WildFly 22.0.0. Para eso necesita la versión 1.10.0 final de la herramienta de migración.
Rastreador de problemas