Инструмент миграции сервера JBoss — это инструмент, предназначенный для миграции серверов приложений JBoss. Он считывает файлы конфигурации сервера для предыдущей версии WildFly или JBoss EAP, называемой исходным сервером, и переносит их на последнюю версию или целевой сервер. Помимо конфигураций, инструмент также способен переносить модули, развертывания и другие ресурсы, найденные на исходном сервере.
Java 8.0 (Java SDK 1.8) или более поздняя версия.
Апач Мавен
Используйте следующую команду для сборки инструмента из исходного кода:
mvn clean install
Перейдите в каталог dist/standalone/target/
и разархивируйте файл jboss-server-migration-VERSION_NUMBER.zip
unzip jboss-server-migration-34.0.0.Final-SNAPSHOT.zip
Откройте терминал и перейдите в каталог dist/standalone/target/jboss-server-migration/
.
Выполните следующую команду.
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
Замените SOURCE_SERVER_PATH
на путь к предыдущей версии установки сервера, с которой вы хотите выполнить миграцию, например: ${user.home}/wildfly-26.0.0.Final/
Замените TARGET_SERVER_PATH
на путь к текущей версии установки сервера, в которую вы хотите перенести старую конфигурацию, например: ${user.home}/wildfly-31.0.0.Final/
Когда вы выполняете команду, инструмент определяет исходный и целевой серверы по предоставленным путям и начинает миграцию серверов.
---------------------------------------------------------- ---- 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...
Каждая миграция сервера состоит из нескольких задач миграции, которые могут требовать или не требовать взаимодействия с пользователем.
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.
После завершения миграции сервера будет показан отчет Task Summary
, в котором суммируются результаты задач миграции. Миграция сервера завершена.
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
После завершения вы должны увидеть следующее сообщение.
---------------------------------------------------------------------------------------------- Migration Result: SUCCESS ----------------------------------------------------------------------------------------------
Дополнительные отчеты можно найти в каталоге reports/
.
migration-report.html
: отчет в формате HTML представляет собой красиво отформатированный отчет, показывающий подробные результаты миграции.
migration-report.xml
: XML-файл содержит все собранные данные миграции.
Файлы журналов можно найти в каталоге logs/
.
migration.log
: журнал содержит подробную информацию о выполнении миграции сервера.
Ошибка миграции
Если вы получили сообщение об ошибке, сообщающее, что миграция не удалась из-за того, что версия Y не поддерживает миграцию из версии X, обратитесь к разделу «Релизы», чтобы узнать, какая версия инструмента миграции вам нужна для переноса ваших версий. Например, вы не можете использовать Migration Tool 1.11.0 Final для миграции WildFly 16.0.0 на WildFly 22.0.0. Для этого вам потребуется инструмент миграции версии 1.10.0 Final.
Трекер проблем