Wildfly 서버 마이그레이션
34.0.0.Final
JBoss Server Migration Tool은 JBoss Application Server를 마이그레이션하는 도구입니다. 원본 서버라고 하는 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로부터의 마이그레이션을 지원하지 않아 마이그레이션이 실패했다는 오류 메시지가 표시되면 릴리스 섹션을 참조하여 버전 마이그레이션에 필요한 마이그레이션 도구 버전을 확인하세요. 예를 들어 WildFly 16.0.0을 WildFly 22.0.0으로 마이그레이션하는 데 마이그레이션 도구 1.11.0 Final을 사용할 수 없습니다. 이를 위해서는 마이그레이션 도구 버전 1.10.0 Final이 필요합니다.
이슈 트래커
