Red Hat SummitJBoss Server 마이그레이션 툴 사용
Red Hat JBoss Enterprise Application Platform 8.0으로 서버 구성을 마이그레이션하는 경우
초록
JBoss EAP 문서에 대한 피드백 제공
오류를 보고하거나 문서를 개선하기 위해 Red Hat Jira 계정에 로그인하여 문제를 제출하십시오. Red Hat Jira 계정이 없는 경우 계정을 생성하라는 메시지가 표시됩니다.
프로세스
- 티켓을 생성하려면 다음 링크를 클릭하십시오.
- 요약 에 문제에 대한 간략한 설명을 입력합니다.
- 설명에서 문제 또는 개선 사항에 대한 자세한 설명을 제공합니다. 문서에서 문제가 발생한 위치에 URL을 포함합니다.
- Submit 을 클릭하고 문제를 적절한 문서 팀으로 라우팅합니다.
보다 포괄적 수용을 위한 오픈 소스 용어 교체
Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 용어를 교체하기 위해 최선을 다하고 있습니다. 먼저 마스터(master), 슬레이브(slave), 블랙리스트(blacklist), 화이트리스트(whitelist) 등 네 가지 용어를 교체하고 있습니다. 이러한 변경 사항은 향후 릴리스에 걸쳐 점진적으로 구현될 예정입니다. 언어를 보다 포괄적으로 만드는 방법에 대한 자세한 내용은 CTO Chris Wright의 메시지를 참조하십시오.
1장. JBoss Server 마이그레이션 툴 소개
1.1. Red Hat JBoss Enterprise Application Platform 정보
Red Hat JBoss EAP(JBoss Enterprise Application Platform)는 Jakarta Enterprise Edition 10 사양과 호환되는 오픈 표준을 기반으로 구축된 미들웨어 플랫폼입니다.
JBoss EAP의 8.0 릴리스는 Web Profile, Core Profile 및 Full Platform 사양에 대해 Jakarta Enterprise Edition 호환 구현입니다. 8.0 릴리스는 Jakarta EE Jakarta Enterprise Edition Web Profile, Core Profile 및 Full Platform 사양의 인증된 구현이기도 합니다.
JBoss EAP는 서버 인스턴스에 대해 두 가지 작동 모드를 제공합니다.
독립 실행형 서버
독립 실행형 서버 작동 모드는 JBoss EAP를 단일 서버 인스턴스로 실행하는 것을 나타냅니다.
관리형 도메인
관리형 도메인 운영 모드를 사용하면 단일 제어 지점에서 여러 JBoss EAP 인스턴스를 관리할 수 있습니다.
JBoss EAP에는 안전하고 확장 가능한 Jakarta EE 애플리케이션을 빠르게 개발할 수 있는 API 및 개발 프레임워크가 포함되어 있습니다. JBoss EAP 서버에 배포된 애플리케이션에 노출되는 대부분의 API 및 기능은 서버 구성 파일에 구성된 하위 시스템으로 구성됩니다. 예를 들어 JBoss EAP 독립 실행형 서버 또는 관리형 도메인에 배포된 애플리케이션에서 액세스할 수 있도록 데이터 소스 하위 시스템에서 데이터베이스 액세스 정보를 구성합니다. 새로운 기능을 도입하고 다른 기능을 사용하려면 JBoss EAP의 한 릴리스에서 다른 릴리스로 서버 구성을 수정해야 할 수 있습니다.
Red Hat JBoss Enterprise Application Platform에 대한 자세한 내용은 Red Hat 고객 포털에 있는 JBoss EAP 제품 문서를 참조하십시오.
1.2. 이 문서에서 EAP_PREVIOUS_HOME, EAP_NEW_HOME 및MIGRATION_TOOL_HOME 사용 정보
이 문서에서는 변수 EAP_PREVIOUS_HOME 을 사용하여 소스 서버 설치 경로를 나타냅니다. 이 변수를 소스 서버 설치의 실제 경로로 바꿉니다. 또한 변수 EAP_NEW_HOME 은 대상 서버 설치 경로를 나타내는 데 사용됩니다. 이 변수를 대상 서버 설치의 실제 경로로 바꿉니다. 또한 변수 MIGRATION_TOOL_HOME 은 마이그레이션 도구가 설치된 디렉터리를 지정합니다.
1.2.1. JBoss EAP 설치 경로
-
.zip파일 설치 방법을 사용하여 JBoss EAP를 설치한 경우 설치 디렉터리는.zip파일을 추출한jboss-eap-8.0디렉터리입니다. -
RPM 설치 방법을 사용하여 JBoss EAP를 설치한 경우 설치 디렉터리는
/opt/rh/eap8/root/usr/share/wildfly/입니다. 설치 프로그램을 사용하여 JBoss EAP를 설치한 경우
EAP_NEW_HOME의 기본 경로는${user.home}/EAP-8.0.0:입니다.-
Red Hat Enterprise Linux, Solaris 및 HP- Cryostat의 경우:
/home/USER_NAME/EAP-8.0.0/ -
Microsoft Windows의 경우:
C:\Users\USER_NAME\EAP-8.0.0\
-
Red Hat Enterprise Linux, Solaris 및 HP- Cryostat의 경우:
JBoss Developer Studio 설치 프로그램을 사용하여 JBoss EAP 서버를 설치하고 구성하는 경우
EAP_NEW_HOME의 기본 경로는${user.home}/jbdevstudio/runtimes/jboss-eap:-
Red Hat Enterprise Linux의 경우:
/home/USER_NAME/jbdevstudio/runtimes/jboss-eap/ -
Microsoft Windows의 경우:
C:\Users\USER_NAME\jbdevstudio\runtimes\jboss-eap또는C:\Documents 및 Settings\USER_NAME\jbdevstudio\runtimes\jboss-eap\
-
Red Hat Enterprise Linux의 경우:
2장. 사전 준비 사항
2.1. 명확한 대상 서버 설치로 실행
JBoss Server 마이그레이션 도구는 이전 릴리스의 구성을 기반으로 구성 파일을 생성하므로 깔끔하고 구성되지 않은 대상 서버 설치에서 실행되도록 설계되었습니다. JBoss Server 마이그레이션 도구는 파일 이름에 .beforeMigration 을 추가하여 대상 서버의 구성 파일의 백업을 생성합니다. 그런 다음 소스 서버의 구성 파일을 사용하여 대상 서버에 대해 완전히 새로운 구성 파일을 생성하고 대상 서버 구성에서 실행할 구성을 마이그레이션합니다.
JBoss Server 마이그레이션 도구를 실행하면 설치와 마이그레이션 툴 실행 시 발생한 대상 서버의 모든 변경 사항이 손실됩니다.
또한 대상 서버 디렉터리에 대해 도구를 두 번 이상 실행하면 후속 실행이 툴의 첫 번째 실행 시 백업된 원래 대상 구성 파일을 덮어씁니다. 이는 각 툴 실행에서 .beforeMigration 을 추가하여 구성 파일을 백업하므로 기존 백업 구성 파일이 손실되기 때문입니다.
2.2. 마이그레이션 사용자 정의
JBoss Server 마이그레이션 도구는 로깅, 보고 및 마이그레이션 작업 실행을 구성하는 기능을 제공합니다. 기본적으로 비대화형 모드에서 JBoss Server Migration Tool을 실행하면 전체 서버 구성이 마이그레이션됩니다. JBoss Server 마이그레이션 도구를 구성하여 로깅 및 보고 출력을 사용자 지정할 수 있습니다. 마이그레이션하지 않으려는 구성의 일부를 건너뛰도록 구성할 수도 있습니다.
3장. JBoss Server 마이그레이션 툴 실행
다음 방법 중 하나로 JBoss Server Migration Tool을 실행할 수 있습니다.
JBoss Server 마이그레이션 도구를 실행하기 전에 소스 및 대상 JBoss EAP 서버를 모두 중지해야 합니다.
3.1. 대화형 모드에서 JBoss Server 마이그레이션 툴 실행
기본적으로 JBoss Server 마이그레이션 도구는 대화식으로 실행됩니다. 이 모드를 사용하면 마이그레이션할 서버 구성을 정확하게 선택할 수 있습니다.
대화형 모드에서는 마이그레이션할 하위 시스템을 선택할 수 없습니다. 하위 시스템 또는 작업 수준에서 툴을 구성하는 방법에 대한 자세한 내용은 JBoss Server 마이그레이션 툴에서 수행하는 마이그레이션 작업 구성을 참조하십시오.
다음은 최소 마이그레이션에 수행되는 기본 단계입니다. 마이그레이션하는 서버에 사용자 지정 구성(예: 배포 또는 기본 리소스가 누락된 경우)이 포함된 경우 이 툴에서 추가 프롬프트를 제공합니다.
프로세스
대화형 모드에서 툴을 실행하려면 대상 서버 설치 디렉터리로 이동하여
소스 인수를 소스서버 설치 경로로 제공하여 다음 명령을 실행합니다.MIGRATION_TOOL_HOME/bin/jboss-server-migration.sh --source EAP_PREVIOUS_HOME --target EAP_NEW_HOME
$ MIGRATION_TOOL_HOME/bin/jboss-server-migration.sh --source EAP_PREVIOUS_HOME --target EAP_NEW_HOMECopy to Clipboard Copied! Toggle word wrap Toggle overflow EAP_PREVIOUS_HOME/standalone/configuration/ 디렉터리에 있는 소스 서버의 독립 실행형 구성을EAP_구성으로 마이그레이션하려는 경우 확인하라는 메시지가 표시됩니다.NEW_HOME/standalone/configuration/디렉터리에 있는 대상 서버의 독립 실행형Migrate the source's standalone server? yes/no? yes
Migrate the source's standalone server? yes/no? yesCopy to Clipboard Copied! Toggle word wrap Toggle overflow 응답이
없으면독립 실행형 서버 마이그레이션을 건너뛰고 독립 실행형 서버 구성 파일이 마이그레이션되지 않습니다.yes로 응답하는 경우 다음 프롬프트가 표시됩니다.Migrate all configurations? yes/no? yes
Migrate all configurations? yes/no? yesCopy to Clipboard Copied! Toggle word wrap Toggle overflow yes로 응답하여 모든 소스 서버의 독립 실행형 서버 구성 파일을 마이그레이션합니다.no로 응답하여 개별standalone*.xml구성 파일에 대한 프롬프트를 수신합니다.다음으로
EAP_PREVIOUS_HOME/domain/configuration/ 디렉터리에 있는 소스 서버의 관리형 도메인 구성을EAP_디렉터리에 있는 대상 서버의 관리형 도메인 구성으로 마이그레이션하려는지 확인하라는 메시지가 표시됩니다.NEW_HOME/domain/configuration/Migrate the source's managed domain? yes/no? yes
Migrate the source's managed domain? yes/no? yesCopy to Clipboard Copied! Toggle word wrap Toggle overflow 없이응답하는 경우 관리형 도메인 마이그레이션을 건너뛰고 관리형 도메인 구성 파일이 마이그레이션되지 않습니다.yes로 응답하는 경우 소스 서버의 관리형 도메인 콘텐츠 마이그레이션을 시작합니다. 암호화 리포지토리는 소스 서버의 관리형 도메인 및 호스트 구성에서 참조하는 배포 및 배포 오버레이와 같은 데이터를 저장하는 데 사용됩니다. 소스 및 대상 서버는 유사한 콘텐츠 리포지토리를 사용하므로 이 툴은 소스 서버에서 대상 서버로 데이터를 복사하고 결과를 콘솔 및 서버 로그에 출력합니다.INFO [ServerMigrationTask#397] Migrating domain content found: [22/caa450a9ba3b84eaf5a15b6da418b92ce6c98e/content, 23/b62a37ba8a4830622bfcdb960280577cc6796e/content] INFO [ServerMigrationTask#398] Resource with path /EAP_NEW_HOME/domain/data/content/22/caa450a9ba3b84eaf5a15b6da418b92ce6c98e/content migrated. INFO [ServerMigrationTask#399] Resource with path /EAP_NEW_HOME/domain/data/content/23/b62a37ba8a4830622bfcdb960280577cc6796e/content migrated.
INFO [ServerMigrationTask#397] Migrating domain content found: [22/caa450a9ba3b84eaf5a15b6da418b92ce6c98e/content, 23/b62a37ba8a4830622bfcdb960280577cc6796e/content] INFO [ServerMigrationTask#398] Resource with path /EAP_NEW_HOME/domain/data/content/22/caa450a9ba3b84eaf5a15b6da418b92ce6c98e/content migrated. INFO [ServerMigrationTask#399] Resource with path /EAP_NEW_HOME/domain/data/content/23/b62a37ba8a4830622bfcdb960280577cc6796e/content migrated.Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음으로 마이그레이션 툴은 소스 서버에서 관리형 도메인 구성 파일을 스캔하고 결과를 콘솔에 출력하고 다음 프롬프트를 제공합니다.
Migrate all configurations? yes/no? yes
Migrate all configurations? yes/no? yesCopy to Clipboard Copied! Toggle word wrap Toggle overflow yes로 응답하여 모든 소스 서버의 관리형 도메인 구성 파일을 마이그레이션합니다.no로 응답하여 각 개별 관리형 도메인 구성 파일에 대한 프롬프트를 수신합니다.다음으로 마이그레이션 툴은 소스 서버에서 호스트 구성 파일을 스캔하고 결과를 콘솔에 출력하고 다음 프롬프트를 제공합니다.
Copy to Clipboard Copied! Toggle word wrap Toggle overflow yes로 응답하여 모든 소스 서버의 호스트 구성 파일을 마이그레이션합니다.no로 응답하여 개별 호스트 구성 파일에 대한 프롬프트를 수신합니다.완료되면 서버 콘솔에 다음 메시지가 표시됩니다.
Migration Result: SUCCESS
Migration Result: SUCCESSCopy to Clipboard Copied! Toggle word wrap Toggle overflow
3.2. 비대화형 모드에서 JBoss Server 마이그레이션 툴 실행
비대화형 모드에서 JBoss Server 마이그레이션 툴을 실행할 수 있습니다. 이 모드를 사용하면 프롬프트 없이 실행할 수 있습니다.
JBoss Server 마이그레이션 도구는 모든 서버 구성 파일에 대한 모든 하위 시스템 구성을 자동으로 마이그레이션합니다. 하위 시스템 또는 작업 수준에서 툴을 구성하는 방법에 대한 자세한 내용은 JBoss Server 마이그레이션 툴에서 수행하는 마이그레이션 작업 구성을 참조하십시오.
프로세스
비대화형 모드에서 툴을 실행하려면 대상 서버 설치 디렉터리로 이동하여 다음 명령을 실행하여 소스 서버 설치 경로로
소스인수를 제공하고--interactive또는-i인수를false로 설정합니다.MIGRATION_TOOL_HOME/bin/jboss-server-migration.sh --source EAP_PREVIOUS_HOME --target EAP_NEW_HOME --interactive false
$ MIGRATION_TOOL_HOME/bin/jboss-server-migration.sh --source EAP_PREVIOUS_HOME --target EAP_NEW_HOME --interactive falseCopy to Clipboard Copied! Toggle word wrap Toggle overflow 기본적으로 이 툴은 모든 소스 서버의 독립 실행형 및 관리형 도메인 구성 파일을 자동으로 마이그레이션합니다. 그러나 특정 구성의 마이그레이션을 건너뛰도록 도구의 속성을 구성할 수 있습니다. 완료되면 서버 콘솔에 다음 메시지가 표시됩니다.
Migration Result: SUCCESS
Migration Result: SUCCESSCopy to Clipboard Copied! Toggle word wrap Toggle overflow
4장. JBoss Server Migration Tool 실행 결과 검토
4.1. 마이그레이션된 구성 파일 검토
마이그레이션이 완료되면 EAP_NEW_HOME /standalone/configuration/ 및 EAP_NEW_HOME/domain/configuration/ 디렉터리에서 마이그레이션된 서버 구성 파일을 검토합니다.
-
마이그레이션용으로 선택한 원래
EAP_NEW_HOME대상 서버 구성 파일 이름이 백업되어 이제 .beforeMigration.beforeMigration이 추가됩니다. -
이제
.beforeMigration에 추가되지 않은EAP_NEW_HOME대상 서버 구성 파일 이름이EAP_PREVIOUS_HOME소스 서버 구성에서 마이그레이션된 콘텐츠를 사용하여 업데이트됩니다. -
EAP_PREVIOUS_HOME소스 서버 구성 디렉터리에 있는 원래 구성 파일은 그대로 유지됩니다. -
대상 구성 디렉터리의
logging.properties및standalone-load-balancer.xml파일은 그대로 유지됩니다.
사용 가능한 구성을 모두 마이그레이션하도록 선택하는 경우 대상 서버 디렉터리에 다음 구성 파일이 표시됩니다.
예: 대상 서버의 구성 파일 목록
4.2. 마이그레이션 작업 실행 추적
JBoss Server 마이그레이션 도구는 루트 작업을 실행하여 각 대상 서버 마이그레이션을 시작한 다음 하위 작업을 실행할 수 있습니다. 그런 다음 해당 하위 작업에서 추가 작업 및 하위 작업을 실행할 수도 있습니다. 이 도구가 실행되면 각 마이그레이션 작업을 모든 하위 작업과 함께 추적하고 나중에 보고서를 빌드하는 데 사용되는 트리 구조에 결과를 저장합니다.
각 마이그레이션 작업에는 다음 구문을 사용하여 선택적 속성과 연결된 작업 이름으로 구성된 이름이 제공됩니다.
TASK_NAME(ATTRIBUTE_1_NAME=ATTRIBUTE_1_VALUE,ATTRIBUTE_2_NAME=ATTRIBUTE_2_VALUE, ...)
TASK_NAME(ATTRIBUTE_1_NAME=ATTRIBUTE_1_VALUE,ATTRIBUTE_2_NAME=ATTRIBUTE_2_VALUE, ...)name은 작업 제목 또는 유형을 정의하고, 속성은 하위 작업과 형제 작업을 구분하는 데 사용됩니다. 예를 들어 다음은 Jakarta Enterprise Cryostats 하위 시스템 업데이트 작업을 구분하는 이름입니다.
subsystem.ejb3.update subsystem.ejb3.update.activate-ejb3-remoting-http-connector(resource=/subsystem=ejb3) subsystem.ejb3.update.setup-default-sfsb-passivation-disabled-cache(resource=/subsystem=ejb3) subsystem.ejb3.update.add-infinispan-passivation-store-and-distributable-cache(resource=/subsystem=ejb3)
subsystem.ejb3.update
subsystem.ejb3.update.activate-ejb3-remoting-http-connector(resource=/subsystem=ejb3)
subsystem.ejb3.update.setup-default-sfsb-passivation-disabled-cache(resource=/subsystem=ejb3)
subsystem.ejb3.update.add-infinispan-passivation-store-and-distributable-cache(resource=/subsystem=ejb3)
마이그레이션 작업은 서로 다른 상위 작업에서 여러 번 실행할 수 있으므로 각 작업은 루트부터 > 문자로 구분된 각 상위 작업 이름을 사용하여 트리에 저장됩니다. 작업 실행 트리는 마이그레이션 보고서를 빌드하는 데 사용됩니다.
작업 실행으로 인해 다음 상태 중 하나가 발생할 수 있습니다.
| 상태 | 설명 |
|---|---|
| 성공 | 작업이 성공적으로 실행되었습니다. |
| 건너뛴 | 작업이 필요하지 않았거나 건너뛰도록 구성되었기 때문에 실행을 건너뛰었습니다. |
| 실패 | 작업 실행이 실패했습니다. |
4.3. 작업 요약 로그 검토
작업 요약이 생성되고 마이그레이션 콘솔과 JBoss Server 마이그레이션 툴 로그 파일에 출력됩니다. 구성 요소 및 하위 작업별 마이그레이션 결과에 대한 고급 개요를 계층적 목록으로 제공합니다.
4.4. JBoss Server 마이그레이션 툴 보고서 검토
JBoss Server 마이그레이션 도구는 MIGRATION_TOOL_HOME/reports/ 디렉터리에 잘 포맷된 HTML 및 XML 보고서를 생성합니다. 이러한 보고서는 마이그레이션 프로세스와 마이그레이션 중에 대상 서버가 구성된 방법에 대한 자세한 분석을 제공합니다. 이러한 보고서의 기본 이름은 migration-report.html 및 migration-report.xml 입니다. 이러한 각 이름은 구성할 수 있습니다.
이 섹션에서는 이러한 보고서의 콘텐츠에 대한 간략한 개요를 제공합니다.
4.4.1. JBoss Server Migration Tool HTML 보고서
HTML 보고서는 세 개의 섹션으로 구성되어 있습니다.
요약
이 섹션에서는 실행 시작 시간, 소스 및 대상 서버에 대한 정보 및 마이그레이션 결과를 제공합니다.
환경
이 섹션에는 마이그레이션에 사용된 환경 속성이 나열되어 있습니다.
작업
축소 가능한 하위 섹션이 포함된 이 섹션에서는 실행된 마이그레이션 작업의 통계와 맵을 제공합니다. 각 작업은 해당 이름으로 나열되며 작업 완료 상태에 따라 색상으로 코딩됩니다.
- 성공하면 녹색입니다.
- 실패한 경우 빨간색입니다.
- 회색을 건너 뛰는 경우입니다.
4.4.2. JBoss Server Migration Tool XML 보고서
XML Report는 툴에서 수집한 모든 마이그레이션 데이터를 제공하는 낮은 수준 보고서입니다. third-party document 또는 기타 데이터 조작 툴로 가져와 조작할 수 있는 방식으로 포맷됩니다.
5장. JBoss Server 마이그레이션 툴 구성
5.1. JBoss Server 마이그레이션 툴 속성 구성
속성을 사용하여 JBoss Server Migration Tool 로깅 및 보고 출력을 구성하고 마이그레이션할 구성 요소와 구성을 결정합니다. 다음 메서드의 조합을 사용하여 이러한 속성을 구성할 수 있습니다.
5.1.1. 툴 속성을 사용하여 JBoss Server 마이그레이션 툴 구성
MIGRATION_TOOL_HOME/configuration/ 디렉터리에 있는 environment.properties 파일을 사용하여 JBoss Server 마이그레이션 도구를 구성할 수 있습니다. 이 표준 Java 속성 파일은 대상 서버로 마이그레이션할 때 구성할 수 있는 모든 유효한 속성에 대한 기본값을 제공합니다. 기본값을 변경하려면 속성 앞에 있는 # 주석 문자를 제거하고 필요한 값으로 설정합니다.
5.1.2. 사용자 속성을 사용하여 JBoss Server 마이그레이션 툴 구성
원하는 경우 JBoss Server Migration Tool 구성 속성을 정의하는 표준 Java 속성 파일을 생성하고 --environment 또는 -e 인수를 사용하여 명령줄에서 해당 경로를 전달할 수 있습니다. 이 경로는 절대 경로이거나 현재 디렉터리를 기준으로 하는 경로일 수 있습니다.
MIGRATION_TOOL_HOME/bin/jboss-server-migration.sh --source EAP_PREVIOUS_HOME --target EAP_NEW_HOME --environment path/to/my-server-migration.properties
$ MIGRATION_TOOL_HOME/bin/jboss-server-migration.sh --source EAP_PREVIOUS_HOME --target EAP_NEW_HOME --environment path/to/my-server-migration.properties
--environment 또는 -e 인수를 사용하여 명령줄에서 전달된 파일에 정의된 속성은 MIGRATION_TOOL_HOME/migration/configuration/environment.properties 파일에 정의된 값을 재정의합니다.
5.1.3. 시스템 속성을 사용하여 JBoss Server 마이그레이션 툴 구성
다음 구문을 사용하여 명령줄에서 시스템 속성을 전달하여 JBoss Server 마이그레이션 도구를 구성할 수 있습니다.
MIGRATION_TOOL_HOME/bin/jboss-server-migration.sh --source EAP_PREVIOUS_HOME --target EAP_NEW_HOME -Djboss.server.migration.PROPERTY_NAME=PROPERTY_VALUE
$ MIGRATION_TOOL_HOME/bin/jboss-server-migration.sh --source EAP_PREVIOUS_HOME --target EAP_NEW_HOME -Djboss.server.migration.PROPERTY_NAME=PROPERTY_VALUE
시스템 속성 이름은 jboss.server.migration. concatenated 환경 속성 이름과 연결해야 합니다. 다음 예제에서는 JBoss Server 마이그레이션 도구를 시작할 때 XML 보고서의 이름을 migration-report.xml 로 지정하는 방법을 보여줍니다.
MIGRATION_TOOL_HOME/bin/jboss-server-migration.sh --source EAP_PREVIOUS_HOME --target EAP_NEW_HOME -Djboss.server.migration.report.xml.fileName=migration-report.xml
$ MIGRATION_TOOL_HOME/bin/jboss-server-migration.sh --source EAP_PREVIOUS_HOME --target EAP_NEW_HOME -Djboss.server.migration.report.xml.fileName=migration-report.xml명령줄에 지정된 환경 속성은 사용자 구성 속성과 툴 구성 속성을 모두 재정의합니다.
5.2. JBoss Server 마이그레이션 툴의 로깅 구성
JBoss Server 마이그레이션 도구는 JBoss Logging 프레임워크를 사용하여 마이그레이션 진행 상황을 기록합니다. 결과는 콘솔에 기록되고 migration.log 라는 파일에 기록되며, 이 파일은 MIGRATION_TOOL_HOME/migration/logs/ 디렉터리에 있습니다. 이 로그 파일은 아직 존재하지 않는 경우 생성되며 후속 툴 실행 시 해당 콘텐츠를 덮어씁니다.
로깅 구성은 MIGRATION_TOOL_HOME/migration/logging.properties 파일에서 제공합니다. 이 구성 파일을 수정하거나 명령줄에서 logging.configuration 시스템 속성을 사용하여 대체 로깅 구성 파일을 지정할 수 있습니다.
MIGRATION_TOOL_HOME/bin/jboss-server-migration.sh --source EAP_PREVIOUS_HOME --target EAP_NEW_HOME -Dlogging.configuration=file:EAP_PREVIOUS_HOME/migration/configuration/my-alternate-logging.properties
$ MIGRATION_TOOL_HOME/bin/jboss-server-migration.sh --source EAP_PREVIOUS_HOME --target EAP_NEW_HOME -Dlogging.configuration=file:EAP_PREVIOUS_HOME/migration/configuration/my-alternate-logging.properties5.3. 모듈 마이그레이션 구성
JBoss Server 마이그레이션 도구는 대상 서버에 해당 모듈이 아직 설치되지 않은 한 소스 서버에 설치된 모든 모듈을 마이그레이션할 수 있습니다. 요청으로 모듈 마이그레이션을 명시적으로 수행하거나 다른 모듈 또는 마이그레이션된 서버 구성이 종속되기 때문에 암시적으로 수행할 수 있습니다.
5.3.1. 모듈 환경 속성
module .includes 및 환경 속성을 사용하여 모듈을 마이그레이션해야 하는지 여부를 제어할 수 있습니다. 모듈 ID의 구문은 modules. excludesname:slot 입니다. :slot 는 선택 사항이며 지정되지 않은 경우 기본값은 main 입니다.
-
modules.excludes환경 속성에서 참조하는 ID는 마이그레이션되지 않습니다. -
modules.excludes환경 속성에서 참조하지 않는 한modules.includes환경 속성은 항상 마이그레이션됩니다.
5.3.2. 모듈 속성 구성
모듈을 마이그레이션하는 데 사용되는 환경 속성은 다음과 같은 방식으로 구성할 수 있습니다.
도구의
MIGRATION_TOOL_HOME/migration/configuration/environment.properties파일에서 속성을 구성할 수 있습니다.modules.includes=com.example.moduleA,com.example.moduleB modules.excludes=com.example.moduleC
modules.includes=com.example.moduleA,com.example.moduleB modules.excludes=com.example.moduleCCopy to Clipboard Copied! Toggle word wrap Toggle overflow 위의 속성을 자체 사용자 지정 속성 파일에 포함한 다음
--environment인수를 사용하여 명령줄에서 속성 파일 이름을 전달할 수 있습니다.MIGRATION_TOOL_HOME/bin/jboss-server-migration.sh --source EAP_PREVIOUS_HOME --target EAP_NEW_HOME --environment PATH_TO_MY_PROPERTIES_FILE
$ MIGRATION_TOOL_HOME/bin/jboss-server-migration.sh --source EAP_PREVIOUS_HOME --target EAP_NEW_HOME --environment PATH_TO_MY_PROPERTIES_FILECopy to Clipboard Copied! Toggle word wrap Toggle overflow 시스템 속성을 사용하여 명령줄에서 정보를 전달할 수 있습니다. 환경 속성 이름 앞에
jboss.server.migration을 추가해야 합니다. 예를 들면 다음과 같습니다.MIGRATION_TOOL_HOME/bin/jboss-server-migration.sh --source EAP_PREVIOUS_HOME --target EAP_NEW_HOME -Djboss.server.migration.modules.includes="com.example.moduleA" -Djboss.server.migration.modules.excludes="com.example.moduleC,com.example.moduleD"
$ MIGRATION_TOOL_HOME/bin/jboss-server-migration.sh --source EAP_PREVIOUS_HOME --target EAP_NEW_HOME -Djboss.server.migration.modules.includes="com.example.moduleA" -Djboss.server.migration.modules.excludes="com.example.moduleC,com.example.moduleD"Copy to Clipboard Copied! Toggle word wrap Toggle overflow
JBoss Server 마이그레이션 도구는 소스 모듈이 대상 서버와 호환되는지 확인하지 않습니다. 호환되지 않는 마이그레이션 모듈은 대상 서버가 오작동하거나 전혀 작동하지 않을 수 있습니다. 소스 및 대상 서버 모두에 설치된 모듈에 대한 종속성으로 인해 모듈은 호환되지만 각각에 다른 리소스를 포함하거나 노출합니다.
5.4. JBoss Server 마이그레이션 툴에 대한 보고 구성
JBoss Server 마이그레이션 툴에 대해 다음 보고서를 구성할 수 있습니다.
- 작업 요약 로그
- HTML 보고서
- XML 보고서
5.4.1. 작업 요약 로그 구성
다음 환경 속성을 사용하여 작업 요약 생성을 사용자 지정할 수 있습니다.
| 속성 이름 | 유형 | 속성 설명 및 기본값 |
|---|---|---|
| report.summary.maxTaskPathSizeToDisplaySubtasks | 정수 | 수준이 지정된 정수보다 작거나 같은 요약에 마이그레이션된 하위 작업을 포함합니다.
기본값은 |
5.4.2. HTML 보고서 구성
다음 환경 속성을 사용하여 HTML 보고서를 사용자 지정할 수 있습니다.
| 속성 이름 | 유형 | 속성 설명 및 기본값 |
|---|---|---|
| report.html.fileName | 문자열 | HTML 보고서 파일의 이름입니다. 설정되지 않은 경우 보고서가 생성되지 않습니다.
기본값은 |
| report.html.maxTaskPathSizeToDisplaySubtasks | 정수 | 수준이 지정된 정수보다 작거나 같은 요약에 마이그레이션된 하위 작업을 포함합니다.
기본값은 |
| report.html.templateFileName | 문자열 | HTML 보고서 템플릿 파일 이름입니다.
기본값은 |
5.4.3. XML 보고서 구성
다음 환경 속성을 사용하여 XML 보고서를 사용자 지정할 수 있습니다.
| 속성 이름 | 유형 | 속성 설명 및 기본값 |
|---|---|---|
| report.xml.fileName | 문자열 | XML 보고서 파일의 이름입니다. 설정되지 않은 경우 보고서가 생성되지 않습니다.
기본값은 |
5.5. 독립 실행형 서버 구성에 대한 마이그레이션 구성
독립 실행형 서버의 마이그레이션을 완전히 건너뛰거나 마이그레이션할 구성 파일 이름을 제공하거나 소스 또는 대상 서버의 기본 및 구성 디렉터리에 대한 대체 경로를 제공하도록 JBoss Server 마이그레이션 도구를 구성할 수 있습니다.
다음 환경 속성을 사용하여 독립 실행형 서버 구성 마이그레이션을 사용자 지정할 수 있습니다.
| 속성 이름 | 속성 설명 |
|---|---|
| standalone.skip |
|
| server.source.standalone.serverDir |
소스 서버의 독립 실행형 디렉터리에 대한 대체 경로를 정의합니다. 이는 기본적으로 소스 서버의 |
| server.source.standalone.configDir |
소스 서버의 독립 실행형 구성 디렉터리에 대한 대체 경로를 정의합니다. 이는 기본적으로 소스 서버의 |
| server.source.standalone.configFiles | 마이그레이션할 소스 서버의 독립 실행형 구성의 쉼표로 구분된 목록입니다. |
| server.target.standalone.serverDir |
대상 서버의 독립 실행형 디렉터리의 대체 경로를 정의합니다. 이는 기본적으로 대상 서버의 |
| server.target.standalone.configDir |
대상 서버의 독립 실행형 구성 디렉터리에 대한 대체 경로를 정의합니다. 이 디렉터리의 기본값은 대상 서버의 |
5.6. 관리형 도메인 구성 마이그레이션 구성
관리형 도메인의 마이그레이션을 완전히 건너뛰거나 마이그레이션할 구성 파일 이름을 제공하거나 소스 또는 대상 서버의 기본 및 구성 디렉터리에 대한 대체 경로를 제공하도록 JBoss Server 마이그레이션 도구를 구성할 수 있습니다.
다음 환경 속성을 사용하여 관리형 도메인 구성의 마이그레이션을 사용자 지정할 수 있습니다.
| 속성 이름 | 속성 설명 |
|---|---|
| domain.skip |
|
| server.source.domain.domainDir |
소스 서버의 관리형 도메인 디렉터리에 대한 대체 경로를 정의합니다. 이는 기본적으로 소스 서버의 |
| server.source.domain.configDir |
소스 서버의 관리형 도메인 구성 디렉터리에 대한 대체 경로를 정의합니다. 이는 기본적으로 소스 서버의 |
| server.source.domain.domainConfigFiles | 마이그레이션할 소스 서버의 관리형 도메인 구성의 쉼표로 구분된 목록입니다. |
| server.source.domain.hostConfigFiles | 마이그레이션할 소스 서버의 호스트 구성 파일의 쉼표로 구분된 목록입니다. |
| server.target.domain.domainDir |
대상 서버의 관리형 도메인 디렉터리에 대한 대체 경로를 정의합니다. 이는 기본적으로 대상 서버의 |
| server.target.domain.configDir |
대상 서버의 관리형 도메인 구성 디렉터리에 대한 대체 경로를 정의합니다. 이 디렉터리의 기본값은 대상 서버의 |
5.7. JBoss Server 마이그레이션 툴에서 수행하는 마이그레이션 작업 구성
기본적으로 JBoss Server 마이그레이션 도구는 마이그레이션하도록 선택한 각 독립 실행형 서버, 관리형 도메인 및 호스트 구성에 대한 모든 구성 요소와 하위 시스템을 자동으로 마이그레이션합니다. 환경 속성을 사용하여 툴에서 수행하는 특정 작업 및 하위 작업의 실행을 사용자 지정할 수 있습니다. 예를 들어 지원되지 않는 하위 시스템의 제거를 건너뛰거나 배포 마이그레이션을 건너뛰도록 툴을 구성할 수 있습니다. 툴에서 수행하는 작업은 서버 구성 유형과 마이그레이션 중인 소스 서버의 버전에 따라 달라집니다.
JBoss Server 마이그레이션 툴에서 수행하는 작업을 사용자 지정하도록 환경 속성을 구성하는 방법에 대한 정보는 다음 섹션에서 확인할 수 있습니다.
6장. JBoss EAP 6.4 구성을 JBoss EAP 8.0으로 마이그레이션
JBoss EAP 6.4 구성을 JBoss EAP 8.0으로 마이그레이션하는 절차가 업데이트되었습니다. 먼저 JBoss EAP 6.4 구성을 최신 버전의 JBoss EAP 7.4로 마이그레이션한 다음 JBoss EAP 8.0으로 추가로 마이그레이션해야 합니다.
- JBoss EAP 6.4 구성을 JBoss EAP 7.4로 마이그레이션하려면 JBoss Server Migration Tool을 사용하여 서버 구성 마이그레이션을 참조하십시오.
- JBoss EAP 7.x 구성을 JBoss EAP 8.0으로 마이그레이션하려면 JBoss EAP 7.x 구성 마이그레이션을 참조하십시오.
7장. JBoss EAP 7.x 구성을 JBoss EAP 8.0으로 마이그레이션
7.1. JBoss EAP 7.x 독립 실행형 서버를 JBoss EAP 8.0으로 마이그레이션
기본적으로 JBoss Server 마이그레이션 도구는 독립 실행형 서버 구성을 JBoss EAP x에서 JBoss EAP 8.0으로 마이그레이션할 때 다음 작업을 수행합니다.
7.1.1. JBoss 도메인 속성 마이그레이션
도메인 관련 속성 이름에 대한 마스터 및 슬레이브 라는 단어가 '기본' 및 '초기'로 교체되었으며 마이그레이션에서 이전 속성 이름을 자동으로 사용합니다.
콘솔은 마이그레이션에 의해 이름이 변경된 속성을 기록합니다.
INFO JBoss domain property jboss.domain.master.address migrated to jboss.domain.primary.address INFO JBoss domain property jboss.domain.master.port migrated to jboss.domain.primary.port INFO JBoss domain property jboss.domain.master.protocol migrated to jboss.domain.primary.protocol
INFO JBoss domain property jboss.domain.master.address migrated to jboss.domain.primary.address
INFO JBoss domain property jboss.domain.master.port migrated to jboss.domain.primary.port
INFO JBoss domain property jboss.domain.master.protocol migrated to jboss.domain.primary.protocol속성의 이름이 성공적으로 변경되면 다음 메시지가 표시됩니다.
INFO JBoss domain properties migrated.
INFO JBoss domain properties migrated.7.1.2. 지원되지 않는 하위 시스템 제거
JBoss Server 마이그레이션 도구는 지원되지 않는 하위 시스템 구성 및 마이그레이션된 서버 구성에서 확장 기능을 제거합니다. 툴은 각 하위 시스템과 확장이 로그 파일 및 제거 시 콘솔에 기록합니다.
JBoss EAP 7.x에서 지원되지 않았지만 관리자가 해당 서버에 추가한 하위 시스템은 JBoss EAP 8.0에서 지원되지 않으며 제거됩니다.
지원되지 않는 하위 시스템 제거를 건너뛰려면 subsystems.remove-unsupported-subsystems.skip 환경 속성을 true 로 설정합니다.
JBoss Server 마이그레이션 툴의 기본 동작을 재정의하고 다음 환경 속성을 사용하여 마이그레이션 중에 포함하거나 제외해야 하는 하위 시스템과 확장을 지정할 수 있습니다.
| 속성 이름 | 속성 설명 |
|---|---|
|
|
마이그레이션해서는 안 되는 확장 모듈 이름 목록입니다(예: |
|
|
항상 마이그레이션해야 하는 확장 모듈 이름 목록입니다(예: |
|
|
버전이 제거된 하위 시스템 네임스페이스 목록입니다(예: |
|
|
버전이 제거되는 하위 시스템 네임스페이스 목록입니다(예: |
7.1.3. 독립 실행형 서버에 대해 참조된 모듈 마이그레이션
소스 서버에서 대상 서버로 마이그레이션된 구성은 대상 서버에 설치되지 않은 모듈을 참조하거나 사용할 수 있습니다. JBoss Server 마이그레이션 도구는 이를 감지하고 참조된 모듈과 종속 모듈을 소스 서버에서 대상 서버로 자동으로 마이그레이션합니다.
독립 실행형 서버 구성에서 참조하는 모듈은 다음 프로세스를 사용하여 마이그레이션됩니다.
-
데이터 소스 하위 시스템 구성에서참조하는 모듈은 데이터 소스 드라이버 모듈로 마이그레이션됩니다. -
ee하위 시스템 구성에서 참조하는 모듈은 글로벌 모듈로 마이그레이션됩니다. -
이름 지정하위 시스템 구성에서 참조하는 모듈은 오브젝트 팩토리 모듈로 마이그레이션됩니다. -
메시징 하위 시스템 구성에서 참조하는 모듈은 Jakarta 메시징브리지 모듈로 마이그레이션됩니다. - 대상 구성에 설치되지 않은 확장은 대상 서버 구성으로 마이그레이션됩니다.
콘솔은 마이그레이션된 모듈의 모듈 ID를 알리는 메시지를 기록합니다. modules.excludes 환경 속성에 모듈 ID를 지정하여 특정 모듈의 마이그레이션을 제외할 수 있습니다.
7.1.4. 독립 실행형 서버의 참조 경로 마이그레이션
소스 서버에서 대상 서버로 마이그레이션된 구성은 대상 서버로 마이그레이션해야 하는 파일 경로와 디렉터리를 참조하거나 사용할 수 있습니다. JBoss Server 마이그레이션 도구는 절대 경로 참조를 마이그레이션하지 않습니다. 소스 구성과 관련하여 구성된 파일 또는 디렉터리만 마이그레이션합니다. 콘솔은 마이그레이션되는 각 경로를 알리는 메시지를 기록합니다.
7.1.5. 레거시 보안 마이그레이션
JBoss EAP 8은 레거시 Security Cryostats 프레임워크를 지원하지 않습니다. JBoss Server 마이그레이션 도구는 기본 JBoss EAP 8 Elytron 대체를 사용하여 구성을 마이그레이션합니다.
기본 레거시 보안 영역을 사용하지 않은 경우 Elytron을 수동으로 구성해야 할 수 있습니다.
콘솔은 기본 JBoss EAP 8 Elytron 대체로 마이그레이션된 구성 리소스를 기록합니다.
INFO Legacy security XML configuration retrieved. WARN Migrated Remoting subsystem's http connector resource /subsystem/remoting/http-connector/http-remoting-connector using a legacy security-realm, to Elytron's default application SASL Authentication Factory migration-defaultApplicationSaslAuthenticationFactory. Please note that further manual Elytron configuration may be needed if the legacy security realm being used was not the source server's default Application Realm configuration! WARN Migrated Undertow subsystem https-listener resource /subsystem/undertow/server/default-server/https-listener/https using a legacy security-realm, to Elytron's default TLS ServerSSLContext migration-defaultTLSServerSSLContext. Please note that further manual Elytron configuration may be needed if the legacy security realm being used was not the source server's default Application Realm configuration! WARN Migrated Undertow subsystem http-invoker resource /subsystem/undertow/server/default-server/host/default-host/setting/http-invoker using a legacy security-realm, to Elytron's default Application HTTP AuthenticationFactory migration-defaultApplicationHttpAuthenticationFactory. Please note that further manual Elytron configuration may be needed if the legacy security realm being used was not the source server's default Application Realm configuration! INFO Legacy security realms migrated to Elytron.
INFO Legacy security XML configuration retrieved.
WARN Migrated Remoting subsystem's http connector resource /subsystem/remoting/http-connector/http-remoting-connector using a legacy security-realm, to Elytron's default application SASL Authentication Factory migration-defaultApplicationSaslAuthenticationFactory. Please note that further manual Elytron configuration may be needed if the legacy security realm being used was not the source server's default Application Realm configuration!
WARN Migrated Undertow subsystem https-listener resource /subsystem/undertow/server/default-server/https-listener/https using a legacy security-realm, to Elytron's default TLS ServerSSLContext migration-defaultTLSServerSSLContext. Please note that further manual Elytron configuration may be needed if the legacy security realm being used was not the source server's default Application Realm configuration!
WARN Migrated Undertow subsystem http-invoker resource /subsystem/undertow/server/default-server/host/default-host/setting/http-invoker using a legacy security-realm, to Elytron's default Application HTTP AuthenticationFactory migration-defaultApplicationHttpAuthenticationFactory. Please note that further manual Elytron configuration may be needed if the legacy security realm being used was not the source server's default Application Realm configuration!
INFO Legacy security realms migrated to Elytron.7.1.6. 레거시 보안 도메인 마이그레이션
JBoss EAP 8은 레거시 보안 도메인 프레임워크를 지원하지 않습니다. JBoss Server 마이그레이션 도구는 기본 JBoss EAP 8 Elytron 대체를 사용하여 구성을 마이그레이션합니다.
기본 레거시 보안 도메인을 사용하지 않은 경우 Elytron을 수동으로 구성해야 할 수 있습니다.
콘솔은 기본 JBoss EAP 8 Elytron 대체로 마이그레이션된 모든 구성 리소스를 기록합니다.
WARN Migrated ejb3 subsystem resource /subsystem/ejb3/application-security-domain/other using legacy security domain other, to Elytron's default application Security Domain. Please note that further manual Elytron configuration may be needed if the legacy security domain being used was not the source server's default Application Domain configuration! WARN Migrated undertow subsystem resource /subsystem/undertow/application-security-domain/other using legacy security domain other, to Elytron's default application Security Domain. Please note that further manual Elytron configuration may be needed if the legacy security domain being used was not the source server's default Application Domain configuration!
WARN Migrated ejb3 subsystem resource /subsystem/ejb3/application-security-domain/other using legacy security domain other, to Elytron's default application Security Domain. Please note that further manual Elytron configuration may be needed if the legacy security domain being used was not the source server's default Application Domain configuration!
WARN Migrated undertow subsystem resource /subsystem/undertow/application-security-domain/other using legacy security domain other, to Elytron's default application Security Domain. Please note that further manual Elytron configuration may be needed if the legacy security domain being used was not the source server's default Application Domain configuration!7.1.7. keycloak 하위 시스템 마이그레이션
keycloak 하위 시스템은 JBoss EAP 8에서 지원되지 않으며 elytron-oidc-client 하위 시스템으로 교체됩니다.
기본적으로 JBoss Server 마이그레이션 도구는 레거시 하위 시스템 구성을 자동으로 마이그레이션합니다. 이 마이그레이션 작업을 건너뛰려면 subsystem.keycloak.migrate.skip 환경 속성 값을 true 로 설정합니다.
레거시 하위 시스템 마이그레이션은 사용자의 상호 작용 없이 수행됩니다.
레거시 keycloak 하위 시스템 마이그레이션이 완료되면 마이그레이션 콘솔에 다음 메시지가 표시됩니다.
INFO Subsystem keycloak migrated.
INFO Subsystem keycloak migrated.마이그레이션 중에 발생한 문제는 로그 파일에 기록되고 마이그레이션 콘솔에 표시됩니다.
7.1.8. 마이그레이션 picketlink-federation 하위 시스템
picketlink-federation 하위 시스템은 JBoss EAP 8에서 더 이상 사용되지 않으며 keycloak-saml 하위 시스템으로 교체됩니다.
기본적으로 JBoss Server 마이그레이션 도구는 레거시 하위 시스템 구성을 자동으로 마이그레이션합니다. 이 마이그레이션 작업을 건너뛰려면 subsystem.picketlink-federation.migrate.skip 환경 속성 값을 true 로 설정합니다.
레거시 하위 시스템 마이그레이션은 사용자의 상호 작용 없이 수행됩니다.
다음과 같은 이유로 레거시 하위 시스템 마이그레이션이 실패할 수 있습니다.
-
대상 서버에 Keycloak 클라이언트 SAML 어댑터가 누락되어 레거시
picketlink-federation하위 시스템은keycloak-saml하위 시스템으로 마이그레이션할 수 없습니다. -
수동으로 마이그레이션해야 하는 비어 있지 않은 레거시
picketlink-federation하위 시스템 구성
레거시 picketlink-federation 하위 시스템 마이그레이션이 완료되면 마이그레이션 콘솔에 다음 메시지가 표시됩니다.
INFO Subsystem picketlink-federation migrated.
INFO Subsystem picketlink-federation migrated.마이그레이션 중에 발생한 문제는 로그 파일에 기록되고 마이그레이션 콘솔에 표시됩니다.
자세한 내용은 마이그레이션 가이드를 참조하십시오.
7.1.9. jgroups 하위 시스템 구성 업데이트
JBoss Server 마이그레이션 도구는 jgroups 하위 시스템 구성의 마이그레이션을 자동화하지 않습니다. JBoss Server 마이그레이션 도구는 구성을 기본 JBoss EAP 8 jgroups 구성으로 되돌립니다.
기본 JBoss EAP 8 jgroups 하위 시스템을 사용하지 않은 경우 jgroups 하위 시스템 구성을 수동으로 구성해야 할 수 있습니다.
jgroups 하위 시스템 구성이 업데이트되면 콘솔에서 메시지를 기록합니다.
WARN Configuration of JGroups protocols has been changed to match the default protocols of the target server. Please note that further manual configuration may be needed if the legacy configuration being used was not the source server's default configuration!
WARN Configuration of JGroups protocols has been changed to match the default protocols of the target server. Please note that further manual configuration may be needed if the legacy configuration being used was not the source server's default configuration!7.1.10. 독립 실행형 서버에 대한 상태 하위 시스템 추가
JBoss EAP 8.0 상태 하위 시스템은 서버의 상태 기능을 지원합니다. JBoss Server 마이그레이션 도구는 기본 상태 하위 시스템 구성을 마이그레이션된 구성 파일에 자동으로 추가합니다.
상태 하위 시스템 구성을 건너뛰려면 subsystem.health.add.skip 환경 속성을 true 로 설정합니다.
JBoss EAP 8.0에 상태 하위 시스템을 추가한 후 웹 콘솔에 다음 메시지가 표시됩니다.
INFO Subsystem health added.
INFO Subsystem health added.7.1.11. 독립 실행형 서버에 대한 지표 하위 시스템 추가
JBoss EAP 8.0 지표 하위 시스템은 서버의 지표 기능을 지원합니다. JBoss Server 마이그레이션 도구는 기본 지표 하위 시스템 구성을 마이그레이션된 구성 파일에 자동으로 추가합니다.
지표 하위 시스템 구성 추가를 건너뛰려면 subsystem.metrics.add.skip 환경 속성을 true 로 설정합니다.
지표 하위 시스템을 JBoss EAP 8.0에 추가한 후 웹 콘솔에 다음 메시지가 표시됩니다.
INFO Subsystem metrics added.
INFO Subsystem metrics added.7.1.12. 독립 실행형 서버에 대한 배포 마이그레이션
JBoss Server 마이그레이션 도구는 다음과 같은 유형의 독립 실행형 서버 배포 구성을 마이그레이션할 수 있습니다.
- 배포는 영구 배포 라고도 합니다.
- 배포 스캐너에서 모니터링하는 디렉터리에 있는 배포 입니다.
- 배포는 참조에 오버레이 됩니다.
배포 마이그레이션은 대상 서버에 관련 파일 리소스를 설치하고 마이그레이션된 구성을 업데이트하는 것으로 구성됩니다.
JBoss Server 마이그레이션 도구는 비대화형 모드로 실행할 때 기본적으로 배포를 건너뛰도록 사전 구성되어 있습니다. 배포 마이그레이션을 활성화하려면 deployments.migrate-deployments.skip 환경 속성을 false 로 설정합니다.
대화형 모드에서 JBoss Server Migration Tool을 실행하고 잘못된 입력을 입력하면 생성되는 동작은 deployments.migrate-deployments 환경 속성 값에 따라 달라집니다.
-
deployments.migrate-deployments.skip가false로 설정되어 있고 잘못된 입력을 입력하면 툴에서 배포를 마이그레이션하려고 합니다. -
deployments.migrate-deployments.skip가true로 설정되어 있고 잘못된 입력을 입력하면 툴에서 배포 마이그레이션을 건너뜁니다.
JBoss Server 마이그레이션 도구는 배포된 리소스가 대상 서버와 호환되는지 여부를 확인하지 않습니다. 즉, 애플리케이션 또는 리소스가 배포되지 않거나 예상대로 작동하지 않거나 전혀 작동하지 않을 수 있습니다. 또한 JBoss EAP 7.3 *-jms.xml 구성 파일과 같은 아티팩트는 수정되지 않고 복사되며 JBoss EAP 서버가 오류로 부팅될 수 있습니다.
Red Hat은 Migration Toolkit for Runtimes(MTR)를 사용하여 배포를 분석하여 다른 JBoss EAP 서버 간의 호환성을 결정하는 것이 좋습니다. 자세한 내용은 Migration Toolkit for Runtimes 제품 문서를 참조하십시오.
7.1.12.1. 독립 실행형 서버의 영구 배포 마이그레이션
비대화형 모드로 실행할 때 영구 배포를 활성화하려면 deployments.migrate-persistent-deployments.skip 환경 속성을 false 로 설정합니다.
JBoss Server 마이그레이션 도구는 영구 배포 참조를 검색하고 콘솔에 나열합니다.
INFO [ServerMigrationTask#67] Persistent deployments found: [cmtool-helloworld3.war, cmtool-helloworld4.war, cmtool-helloworld2.war, cmtool-helloworld1.war]
INFO [ServerMigrationTask#67] Persistent deployments found: [cmtool-helloworld3.war, cmtool-helloworld4.war, cmtool-helloworld2.war, cmtool-helloworld1.war]그런 다음 처리 워크플로우는 아래 설명된 대로 대화형 모드에서 도구를 실행 중인지 또는 비대화형 모드에서 실행 중인지에 따라 달라집니다.
비대화형 모드로 영구 배포 마이그레이션
비대화형 모드로 툴을 실행하는 경우 툴은 사전 구성된 속성을 사용하여 영구 배포를 마이그레이션할지 여부를 결정합니다. 영구 배포는 deployments.migrate-deployments.skip 및 deployments.migrate-persistent-deployments.skip 속성이 모두 false 로 설정된 경우에만 마이그레이션됩니다.
대화형 모드에서 영구 배포 마이그레이션
대화형 모드에서 툴을 실행하는 경우 JBoss Server 마이그레이션 툴에서 다음 워크플로를 사용하여 각 배포에 대한 메시지를 표시합니다.
영구 배포를 콘솔에 출력하면 다음 프롬프트가 표시됩니다.
This tool is not able to assert if persistent deployments found are compatible with the target server, skip persistent deployments migration? yes/no?
This tool is not able to assert if persistent deployments found are compatible with the target server, skip persistent deployments migration? yes/no?Copy to Clipboard Copied! Toggle word wrap Toggle overflow -
yes로 응답하여 영구 배포 마이그레이션을 건너뜁니다. 모든 배포 참조는 마이그레이션된 구성에서 제거되고 마이그레이션 프로세스의 이 부분을 종료합니다. -
마이그레이션을 계속하려면
no와 함께 응답합니다.
-
계속하도록 선택하면 다음 프롬프트가 표시됩니다.
Migrate all persistent deployments found? yes/no?
Migrate all persistent deployments found? yes/no?Copy to Clipboard Copied! Toggle word wrap Toggle overflow -
yes로 응답하여 모든 배포를 자동으로 마이그레이션하고 마이그레이션 프로세스의 이 부분을 종료합니다. -
마이그레이션을 계속하려면
no와 함께 응답합니다.
-
계속하도록 선택하면 참조된 각 배포에 대한 마이그레이션을 확인하라는 메시지가 표시됩니다.
Migrate persistent deployment 'helloworld01.war'? yes/no?
Migrate persistent deployment 'helloworld01.war'? yes/no?Copy to Clipboard Copied! Toggle word wrap Toggle overflow -
yes로 응답하여 배포를 마이그레이션합니다. no로 응답하여 마이그레이션된 구성에서 배포를 제거합니다.INFO [ServerMigrationTask#68] Removed persistent deployment from configuration /deployment=helloworld01.war
INFO [ServerMigrationTask#68] Removed persistent deployment from configuration /deployment=helloworld01.warCopy to Clipboard Copied! Toggle word wrap Toggle overflow
-
7.1.12.2. 독립 실행형 서버의 배포 스캐너 배포 마이그레이션
독립 실행형 서버 구성에서만 사용되는 배포 스캐너는 새 파일의 디렉터리를 모니터링하고 자동으로 또는 특수 배포 마커 파일을 통해 배포를 관리합니다.
비대화형 모드로 실행할 때 배포 스캐너에서 감시한 디렉터리에 있는 배포를 활성화하려면 deployments.migrate-deployment-scanner-deployments.skip 환경 속성을 false 로 설정합니다.
독립 실행형 서버 구성을 마이그레이션할 때 JBoss Server Migration Tool은 먼저 구성된 배포 스캐너를 검색합니다. 각 스캐너에서 배포된 배포가 있는지 모니터링된 디렉터리를 검색하고 결과를 콘솔에 출력합니다.
그런 다음 처리 워크플로우는 아래 설명된 대로 대화형 모드에서 도구를 실행 중인지 또는 비대화형 모드에서 실행 중인지에 따라 달라집니다.
비대화형 모드로 배포 스캐너 배포 마이그레이션
비대화형 모드에서 툴을 실행하는 경우 툴은 사전 구성된 속성을 사용하여 배포 스캐너 배포를 마이그레이션할지 여부를 결정합니다. 배포 스캐너 배포는 deployments.migrate-deployments.skip 및 deployments.migrate-deployment-scanner-deployments.skip 속성이 모두 false 로 설정된 경우에만 마이그레이션됩니다.
대화형 모드에서 배포 스캐너 배포 마이그레이션
대화형 모드에서 툴을 실행하는 경우 JBoss Server 마이그레이션 툴에서 다음 워크플로를 사용하여 각 배포에 대한 메시지를 표시합니다.
배포 스캐너 배포를 인쇄하면 콘솔에 다음 프롬프트가 표시됩니다.
This tool is not able to assert if the scanner's deployments found are compatible with the target server, skip scanner's deployments migration? yes/no?
This tool is not able to assert if the scanner's deployments found are compatible with the target server, skip scanner's deployments migration? yes/no?Copy to Clipboard Copied! Toggle word wrap Toggle overflow -
yes로 응답하여 배포 스캐너 배포 마이그레이션을 건너뜁니다. 모든 배포 참조는 마이그레이션된 구성에서 제거되고 마이그레이션 프로세스의 이 부분을 종료합니다. -
마이그레이션을 계속하려면
no와 함께 응답합니다.
-
계속하도록 선택하면 다음 프롬프트가 표시됩니다.
Migrate all scanner's deployments found? yes/no?
Migrate all scanner's deployments found? yes/no?Copy to Clipboard Copied! Toggle word wrap Toggle overflow -
yes로 응답하여 모든 배포를 자동으로 마이그레이션하고 마이그레이션 프로세스의 이 부분을 종료합니다. -
마이그레이션을 계속하려면
no와 함께 응답합니다.
-
계속하도록 선택하면 참조된 각 배포에 대한 마이그레이션을 확인하라는 메시지가 표시됩니다.
Migrate scanner's deployment 'helloworld02.war'? yes/no?
Migrate scanner's deployment 'helloworld02.war'? yes/no?Copy to Clipboard Copied! Toggle word wrap Toggle overflow -
yes로 응답하여 배포를 마이그레이션합니다. no로 응답하여 마이그레이션된 구성에서 배포를 제거합니다.INFO [ServerMigrationTask#69] Resource with path EAP_NEW_HOME/standalone/deployments/helloworld02.war migrated.
INFO [ServerMigrationTask#69] Resource with path EAP_NEW_HOME/standalone/deployments/helloworld02.war migrated.Copy to Clipboard Copied! Toggle word wrap Toggle overflow
-
7.1.12.3. 독립 실행형 서버의 배포 오버레이 마이그레이션
배포 오버레이의 마이그레이션은 완전히 자동화된 프로세스입니다. deployments.migrate-deployments.skip 환경 속성을 false 로 설정하여 배포를 활성화한 경우 JBoss Server Migration Tool은 마이그레이션된 배포에 연결된 독립 실행형 서버 구성에서 참조되는 배포 오버레이를 검색합니다. 발견된 항목을 자동으로 마이그레이션하고 참조되지 않은 항목을 제거하고 결과를 로그 파일 및 콘솔에 기록합니다.
7.2. JBoss EAP 7.x 관리형 도메인을 JBoss EAP 8.0으로 마이그레이션
JBoss Server 마이그레이션 툴을 사용하는 경우 호스트를 마이그레이션하기 전에 도메인 컨트롤러를 마이그레이션하여 호스트에서 사용하는 버전과 비교했을 때 도메인 컨트롤러가 JBoss EAP의 최신 버전을 사용해야 하는지 확인합니다. 예를 들어 JBoss EAP 7에서 실행되는 도메인 컨트롤러는 JBoss EAP 8.0에서 실행되는 호스트를 처리할 수 없습니다.
기본적으로 JBoss Server 마이그레이션 도구는 관리형 도메인 구성을 JBoss EAP 7에서 JBoss EAP 8.0으로 마이그레이션할 때 다음 작업을 수행합니다.
7.2.1. JBoss 도메인 속성 마이그레이션
도메인 관련 속성 이름에 대한 마스터 및 슬레이브 라는 단어가 '기본' 및 '초기'로 교체되었으며 마이그레이션에서 이전 속성 이름을 자동으로 사용합니다.
콘솔은 마이그레이션에 의해 이름이 변경된 속성을 기록합니다.
INFO JBoss domain property jboss.domain.master.address migrated to jboss.domain.primary.address INFO JBoss domain property jboss.domain.master.port migrated to jboss.domain.primary.port INFO JBoss domain property jboss.domain.master.protocol migrated to jboss.domain.primary.protocol
INFO JBoss domain property jboss.domain.master.address migrated to jboss.domain.primary.address
INFO JBoss domain property jboss.domain.master.port migrated to jboss.domain.primary.port
INFO JBoss domain property jboss.domain.master.protocol migrated to jboss.domain.primary.protocol속성의 이름이 성공적으로 변경되면 다음 메시지가 표시됩니다.
INFO JBoss domain properties migrated.
INFO JBoss domain properties migrated.7.2.2. 지원되지 않는 하위 시스템 제거
JBoss Server 마이그레이션 도구는 지원되지 않는 하위 시스템 구성 및 마이그레이션된 서버 구성에서 확장 기능을 제거합니다. 툴은 각 하위 시스템과 확장이 로그 파일 및 제거 시 콘솔에 기록합니다.
JBoss EAP 7.x에서 지원되지 않았지만 관리자가 해당 서버에 추가한 하위 시스템은 JBoss EAP 8.0에서 지원되지 않으며 제거됩니다.
지원되지 않는 하위 시스템 제거를 건너뛰려면 subsystems.remove-unsupported-subsystems.skip 환경 속성을 true 로 설정합니다.
JBoss Server 마이그레이션 툴의 기본 동작을 재정의하고 다음 환경 속성을 사용하여 마이그레이션 중에 포함하거나 제외해야 하는 하위 시스템과 확장을 지정할 수 있습니다.
| 속성 이름 | 속성 설명 |
|---|---|
|
|
마이그레이션해서는 안 되는 확장 모듈 이름 목록입니다(예: |
|
|
항상 마이그레이션해야 하는 확장 모듈 이름 목록입니다(예: |
|
|
버전이 제거된 하위 시스템 네임스페이스 목록입니다(예: |
|
|
버전이 제거되는 하위 시스템 네임스페이스 목록입니다(예: |
7.2.3. 관리형 도메인의 참조 모듈 마이그레이션
소스 서버에서 대상 서버로 마이그레이션된 구성은 대상 서버에 설치되지 않은 모듈을 참조하거나 사용할 수 있습니다. JBoss Server 마이그레이션 도구는 이를 감지하고 참조된 모듈과 종속 모듈을 소스 서버에서 대상 서버로 자동으로 마이그레이션합니다.
관리형 도메인 구성에서 참조하는 모듈은 다음 프로세스를 사용하여 마이그레이션됩니다.
-
데이터 소스 하위 시스템 구성에서참조하는 모듈은 데이터 소스 드라이버 모듈로 마이그레이션됩니다. -
ee하위 시스템 구성에서 참조하는 모듈은 글로벌 모듈로 마이그레이션됩니다. -
이름 지정하위 시스템 구성에서 참조하는 모듈은 오브젝트 팩토리 모듈로 마이그레이션됩니다. -
메시징 하위 시스템 구성에서 참조하는 모듈은 Jakarta 메시징브리지 모듈로 마이그레이션됩니다. - 대상 구성에 설치되지 않은 확장은 대상 서버 구성으로 마이그레이션됩니다.
콘솔은 마이그레이션된 모듈의 모듈 ID를 알리는 메시지를 기록합니다. modules.excludes 환경 속성에 모듈 ID를 지정하여 특정 모듈의 마이그레이션을 제외할 수 있습니다.
7.2.4. 관리형 도메인의 참조 경로 마이그레이션
소스 서버에서 대상 서버로 마이그레이션된 구성은 대상 서버로 마이그레이션해야 하는 파일 경로와 디렉터리를 참조하거나 사용할 수 있습니다. JBoss Server 마이그레이션 도구는 절대 경로 참조를 마이그레이션하지 않습니다. 소스 구성과 관련하여 구성된 파일 또는 디렉터리만 마이그레이션합니다. 콘솔은 마이그레이션되는 각 경로를 알리는 메시지를 기록합니다.
7.2.5. 레거시 보안 마이그레이션
JBoss EAP 8은 레거시 Security Cryostats 프레임워크를 지원하지 않습니다. JBoss Server 마이그레이션 도구는 기본 JBoss EAP 8 Elytron 대체를 사용하여 구성을 마이그레이션합니다.
기본 레거시 보안 도메인을 사용하지 않는 경우 Elytron을 수동으로 구성해야 할 수 있습니다.
콘솔은 기본 JBoss EAP 8 Elytron 대체로 마이그레이션된 구성 리소스를 기록합니다.
7.2.6. 레거시 보안 도메인 마이그레이션
JBoss EAP 8은 레거시 보안 도메인 프레임워크를 지원하지 않습니다. JBoss Server 마이그레이션 도구는 기본 JBoss EAP 8 Elytron 대체를 사용하여 구성을 마이그레이션합니다.
기본 레거시 보안 도메인을 사용하지 않은 경우 Elytron을 수동으로 구성해야 할 수 있습니다.
콘솔은 기본 JBoss EAP 8 Elytron 대체로 마이그레이션된 모든 구성 리소스를 기록합니다.
7.2.7. keycloak 하위 시스템 마이그레이션
keycloak 하위 시스템은 JBoss EAP 8에서 지원되지 않으며 elytron-oidc-client 하위 시스템으로 교체됩니다.
기본적으로 JBoss Server 마이그레이션 도구는 레거시 하위 시스템 구성을 자동으로 마이그레이션합니다. 이 마이그레이션 작업을 건너뛰려면 subsystem.keycloak.migrate.skip 환경 속성 값을 true 로 설정합니다.
레거시 하위 시스템 마이그레이션은 사용자의 상호 작용 없이 수행됩니다.
레거시 keycloak 하위 시스템 마이그레이션이 완료되면 마이그레이션 콘솔에 다음 메시지가 표시됩니다.
INFO Subsystem keycloak migrated.
INFO Subsystem keycloak migrated.마이그레이션 중에 발생한 문제는 로그 파일에 기록되고 마이그레이션 콘솔에 표시됩니다.
7.2.8. 마이그레이션 picketlink-federation 하위 시스템
picketlink-federation 하위 시스템은 JBoss EAP 8에서 더 이상 사용되지 않으며 keycloak-saml 하위 시스템으로 교체됩니다.
기본적으로 JBoss Server 마이그레이션 도구는 레거시 하위 시스템 구성을 자동으로 마이그레이션합니다. 이 마이그레이션 작업을 건너뛰려면 subsystem.picketlink-federation.migrate.skip 환경 속성 값을 true 로 설정합니다.
레거시 하위 시스템 마이그레이션은 사용자의 상호 작용 없이 수행됩니다.
다음과 같은 이유로 레거시 하위 시스템 마이그레이션이 실패할 수 있습니다.
-
대상 서버에 Keycloak 클라이언트 SAML 어댑터가 누락되어 레거시
picketlink-federation하위 시스템은keycloak-saml하위 시스템으로 마이그레이션할 수 없습니다. -
수동으로 마이그레이션해야 하는 비어 있지 않은 레거시
picketlink-federation하위 시스템 구성
레거시 picketlink-federation 하위 시스템 마이그레이션이 완료되면 마이그레이션 콘솔에 다음 메시지가 표시됩니다.
INFO Subsystem picketlink-federation migrated.
INFO Subsystem picketlink-federation migrated.마이그레이션 중에 발생한 문제는 로그 파일에 기록되고 마이그레이션 콘솔에 표시됩니다.
자세한 내용은 마이그레이션 가이드를 참조하십시오.
7.2.9. jgroups 하위 시스템 구성 업데이트
JBoss Server 마이그레이션 도구는 jgroups 하위 시스템 구성의 마이그레이션을 자동화하지 않습니다. JBoss Server 마이그레이션 도구는 구성을 기본 JBoss EAP 8 jgroups 구성으로 되돌립니다.
기본 JBoss EAP 8 jgroups 하위 시스템을 사용하지 않은 경우 jgroups 하위 시스템 구성을 수동으로 구성해야 할 수 있습니다.
jgroups 하위 시스템 구성이 업데이트되면 콘솔에서 메시지를 기록합니다.
WARN Configuration of JGroups protocols has been changed to match the default protocols of the target server. Please note that further manual configuration may be needed if the legacy configuration being used was not the source server's default configuration!
WARN Configuration of JGroups protocols has been changed to match the default protocols of the target server. Please note that further manual configuration may be needed if the legacy configuration being used was not the source server's default configuration!7.2.10. 관리형 도메인 마이그레이션을 위한 호스트 제외 추가
JBoss EAP 8.0 도메인 컨트롤러에는 이전 버전의 서버에서 실행되는 호스트에서 지원하지 않는 기능을 잠재적으로 포함할 수 있습니다. host-exclude 구성은 이전 버전에서 숨겨야 하는 리소스를 지정합니다.
도메인 컨트롤러 구성을 마이그레이션할 때 JBoss Server 마이그레이션 도구는 소스 서버의 host-exclude 구성에 추가되거나 대상 JBoss EAP 8.0 서버의 구성으로 대체됩니다.
JBoss Server 마이그레이션 도구는 host-exclude 구성을 자동으로 업데이트하고 결과를 로그 파일 및 콘솔에 기록합니다.
INFO Host-excludes configuration added.
INFO Host-excludes configuration added.7.2.11. 관리형 도메인의 배포 마이그레이션
JBoss Server 마이그레이션 도구는 다음과 같은 유형의 관리형 도메인 배포 구성을 마이그레이션할 수 있습니다.
- 배포는 영구 배포 라고도 합니다.
- 배포는 참조에 오버레이 됩니다.
배포 마이그레이션은 대상 서버에 관련 파일 리소스를 설치하고 마이그레이션된 구성을 업데이트하는 것으로 구성됩니다.
JBoss Server 마이그레이션 도구는 비대화형 모드로 실행할 때 기본적으로 배포를 건너뛰도록 사전 구성되어 있습니다. 배포 마이그레이션을 활성화하려면 deployments.migrate-deployments.skip 환경 속성을 false 로 설정합니다.
대화형 모드에서 JBoss Server Migration Tool을 실행하고 잘못된 입력을 입력하면 생성되는 동작은 deployments.migrate-deployments 환경 속성 값에 따라 달라집니다.
-
deployments.migrate-deployments.skip가false로 설정되어 있고 잘못된 입력을 입력하면 툴에서 배포를 마이그레이션하려고 합니다. -
deployments.migrate-deployments.skip가true로 설정되어 있고 잘못된 입력을 입력하면 툴에서 배포 마이그레이션을 건너뜁니다.
JBoss Server 마이그레이션 도구는 배포된 리소스가 대상 서버와 호환되는지 여부를 확인하지 않습니다. 즉, 애플리케이션 또는 리소스가 배포되지 않거나 예상대로 작동하지 않거나 전혀 작동하지 않을 수 있습니다. 또한 JBoss EAP 7.3 *-jms.xml 구성 파일과 같은 아티팩트는 수정되지 않고 복사되며 JBoss EAP 서버가 오류로 부팅될 수 있습니다.
Red Hat은 Migration Toolkit for Runtimes(MTR)를 사용하여 배포를 분석하여 다른 JBoss EAP 서버 간의 호환성을 결정하는 것이 좋습니다. 자세한 내용은 Migration Toolkit for Runtimes 제품 문서를 참조하십시오.
7.2.11.1. 관리형 도메인의 영구 배포 마이그레이션
비대화형 모드로 실행할 때 영구 배포를 활성화하려면 deployments.migrate-persistent-deployments.skip 환경 속성을 false 로 설정합니다.
JBoss Server 마이그레이션 도구는 영구 배포 참조를 검색하고 콘솔에 나열합니다.
INFO [ServerMigrationTask#67] Persistent deployments found: [cmtool-helloworld3.war, cmtool-helloworld4.war, cmtool-helloworld2.war, cmtool-helloworld1.war]
INFO [ServerMigrationTask#67] Persistent deployments found: [cmtool-helloworld3.war, cmtool-helloworld4.war, cmtool-helloworld2.war, cmtool-helloworld1.war]그런 다음 처리 워크플로우는 아래 설명된 대로 대화형 모드에서 도구를 실행 중인지 또는 비대화형 모드에서 실행 중인지에 따라 달라집니다.
비대화형 모드로 영구 배포 마이그레이션
비대화형 모드로 툴을 실행하는 경우 툴은 사전 구성된 속성을 사용하여 영구 배포를 마이그레이션할지 여부를 결정합니다. 영구 배포는 deployments.migrate-deployments.skip 및 deployments.migrate-persistent-deployments.skip 속성이 모두 false 로 설정된 경우에만 마이그레이션됩니다.
대화형 모드에서 영구 배포 마이그레이션
대화형 모드에서 툴을 실행하는 경우 JBoss Server 마이그레이션 툴에서 다음 워크플로를 사용하여 각 배포에 대한 메시지를 표시합니다.
영구 배포를 콘솔에 출력하면 다음 프롬프트가 표시됩니다.
This tool is not able to assert if persistent deployments found are compatible with the target server, skip persistent deployments migration? yes/no?
This tool is not able to assert if persistent deployments found are compatible with the target server, skip persistent deployments migration? yes/no?Copy to Clipboard Copied! Toggle word wrap Toggle overflow -
yes로 응답하여 영구 배포 마이그레이션을 건너뜁니다. 모든 배포 참조는 마이그레이션된 구성에서 제거되고 마이그레이션 프로세스의 이 부분을 종료합니다. -
마이그레이션을 계속하려면
no와 함께 응답합니다.
-
계속하도록 선택하면 다음 프롬프트가 표시됩니다.
Migrate all persistent deployments found? yes/no?
Migrate all persistent deployments found? yes/no?Copy to Clipboard Copied! Toggle word wrap Toggle overflow -
yes로 응답하여 모든 배포를 자동으로 마이그레이션하고 마이그레이션 프로세스의 이 부분을 종료합니다. -
마이그레이션을 계속하려면
no와 함께 응답합니다.
-
계속하도록 선택하면 참조된 각 배포에 대한 마이그레이션을 확인하라는 메시지가 표시됩니다.
Migrate persistent deployment 'helloworld01.war'? yes/no?
Migrate persistent deployment 'helloworld01.war'? yes/no?Copy to Clipboard Copied! Toggle word wrap Toggle overflow -
yes로 응답하여 배포를 마이그레이션합니다. no로 응답하여 마이그레이션된 구성에서 배포를 제거합니다.INFO [ServerMigrationTask#68] Removed persistent deployment from configuration /deployment=helloworld01.war
INFO [ServerMigrationTask#68] Removed persistent deployment from configuration /deployment=helloworld01.warCopy to Clipboard Copied! Toggle word wrap Toggle overflow
-
7.2.11.2. 관리형 도메인의 배포 오버레이 마이그레이션
배포 오버레이의 마이그레이션은 완전히 자동화된 프로세스입니다. deployments.migrate-deployments.skip 환경 속성을 false 로 설정하여 배포를 활성화한 경우 JBoss Server Migration Tool은 마이그레이션된 배포에 연결된 독립 실행형 서버 구성에서 참조되는 배포 오버레이를 검색합니다. 발견된 항목을 자동으로 마이그레이션하고 참조되지 않은 항목을 제거하고 결과를 로그 파일 및 콘솔에 기록합니다.
7.3. JBoss EAP 7.x 호스트 구성을 JBoss EAP 8.0으로 마이그레이션
기본적으로 JBoss Server 마이그레이션 도구는 JBoss EAP 7.x에서 JBoss EAP 8.0으로 호스트 서버 구성을 마이그레이션할 때 다음 작업을 수행합니다.
7.3.1. JBoss 도메인 속성 마이그레이션
도메인 관련 속성 이름에 대한 마스터 및 슬레이브 라는 단어가 '기본' 및 '초기'로 교체되었으며 마이그레이션에서 이전 속성 이름을 자동으로 사용합니다.
콘솔은 마이그레이션에 의해 이름이 변경된 속성을 기록합니다.
INFO JBoss domain property jboss.domain.master.address migrated to jboss.domain.primary.address INFO JBoss domain property jboss.domain.master.port migrated to jboss.domain.primary.port INFO JBoss domain property jboss.domain.master.protocol migrated to jboss.domain.primary.protocol
INFO JBoss domain property jboss.domain.master.address migrated to jboss.domain.primary.address
INFO JBoss domain property jboss.domain.master.port migrated to jboss.domain.primary.port
INFO JBoss domain property jboss.domain.master.protocol migrated to jboss.domain.primary.protocol속성의 이름이 성공적으로 변경되면 다음 메시지가 표시됩니다.
INFO JBoss domain properties migrated.
INFO JBoss domain properties migrated.7.3.2. 호스트 구성에 대해 참조된 모듈 마이그레이션
소스 서버에서 대상 서버로 마이그레이션된 구성은 대상 서버에 설치되지 않은 모듈을 참조하거나 사용할 수 있습니다. JBoss Server 마이그레이션 도구는 이를 감지하고 참조된 모듈과 종속 모듈을 소스 서버에서 대상 서버로 자동으로 마이그레이션합니다.
호스트 서버 구성에서 참조하는 모듈은 다음 프로세스를 사용하여 마이그레이션됩니다.
- 보안 영역 구성에서 참조하는 모듈은 플러그인 모듈로 마이그레이션됩니다.
콘솔은 마이그레이션된 모듈의 모듈 ID를 알리는 메시지를 기록합니다. modules.excludes 환경 속성에 모듈 ID를 지정하여 특정 모듈의 마이그레이션을 제외할 수 있습니다.
7.3.3. 호스트 구성에 대한 참조 경로 마이그레이션
소스 서버에서 대상 서버로 마이그레이션된 구성은 대상 서버로 마이그레이션해야 하는 파일 경로와 디렉터리를 참조하거나 사용할 수 있습니다. JBoss Server 마이그레이션 도구는 절대 경로 참조를 마이그레이션하지 않습니다. 소스 구성과 관련하여 구성된 파일 또는 디렉터리만 마이그레이션합니다. 콘솔은 마이그레이션되는 각 경로를 알리는 메시지를 기록합니다.
부록 A. 참조 자료
A.1. 작업 요약 보고서 예
다음은 작업 요약 보고서의 예입니다.
A.2. HTML 보고서 예
다음은 JBoss Server Migration HTML 보고서의 예입니다.
그림 A.1. 예: 섹션 개요
그림 A.2. 예: 작업 세부 정보 페이지
A.3. XML 보고서 예
다음은 JBoss Server 마이그레이션 XML 보고서의 예입니다.
2024-02-08에 최종 업데이트된 문서
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}