A JBoss Server Migration Tool é uma ferramenta que migra JBoss Application Servers. Ele lê os arquivos de configuração do servidor de uma versão anterior do WildFly ou JBoss EAP, referido como servidor de origem, e os migra para a versão mais recente ou servidor de destino. Além das configurações, a ferramenta também é capaz de migrar módulos, implantações e outros recursos encontrados no servidor de origem.
Java 8.0 (Java SDK 1.8) ou posterior
Apache Maven
Use o seguinte comando para construir a ferramenta a partir da fonte:
mvn clean install
Navegue até o diretório dist/standalone/target/
e descompacte o arquivo jboss-server-migration-VERSION_NUMBER.zip
unzip jboss-server-migration-34.0.0.Final-SNAPSHOT.zip
Abra um terminal e navegue até o diretório dist/standalone/target/jboss-server-migration/
.
Execute o seguinte 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
Substitua SOURCE_SERVER_PATH
pelo caminho para a versão anterior da instalação do servidor da qual você deseja migrar, por exemplo: ${user.home}/wildfly-26.0.0.Final/
Substitua TARGET_SERVER_PATH
pelo caminho para a versão atual da instalação do servidor para a qual você deseja que a configuração antiga seja migrada, por exemplo: ${user.home}/wildfly-31.0.0.Final/
Ao executar o comando, a ferramenta identifica os servidores de origem e de destino a partir dos caminhos fornecidos e inicia a migração do 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 migração de servidor consiste em diversas tarefas de migração, que podem ou não exigir interação do usuário.
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.
Assim que a migração do servidor for concluída, será mostrado um relatório Task Summary
, que resume os resultados das tarefas de migração. Migração de servidor concluída.
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
Você deverá ver a seguinte mensagem quando for concluído.
---------------------------------------------------------------------------------------------- Migration Result: SUCCESS ----------------------------------------------------------------------------------------------
Relatórios adicionais podem ser encontrados no diretório reports/
.
migration-report.html
: O relatório HTML é um relatório bem formatado que mostra os resultados detalhados da migração.
migration-report.xml
: o arquivo XML inclui todos os dados de migração coletados.
Os logs de arquivos podem ser encontrados no diretório logs/
.
migration.log
: O log contém informações detalhadas sobre a execução da migração do servidor.
Erro de falha na migração
Se você receber uma mensagem de erro informando que a migração falhou porque a versão Y não suporta migrações da versão X, consulte a seção Versões para ver qual versão da ferramenta de migração você precisa para migrar suas versões. Por exemplo, você não pode usar a ferramenta de migração 1.11.0 Final para migrar o WildFly 16.0.0 para o WildFly 22.0.0. Para isso você precisa da Ferramenta de Migração Versão 1.10.0 Final.
Rastreador de problemas