JBoss Server 마이그레이션 툴 사용

Red Hat JBoss Enterprise Application Platform 7.4

서버 구성을 Red Hat JBoss Enterprise Application Platform 7.4로 마이그레이션

Red Hat Customer Content Services

초록

이 가이드에서는 JBoss Server 마이그레이션 툴을 사용하여 애플리케이션 서버 구성을 이전 버전의 JBoss EAP 7.4로 마이그레이션하는 방법을 설명합니다.

JBoss EAP 문서에 대한 피드백 제공

오류를 보고하거나 문서를 개선하기 위해 Red Hat Jira 계정에 로그인하여 문제를 제출하십시오. Red Hat Jira 계정이 없는 경우 계정을 생성하라는 메시지가 표시됩니다.

절차

  1. 티켓을 생성하려면 다음 링크를 클릭하십시오.
  2. 문서 URL, 섹션 번호 를 포함하고 문제를 설명하십시오.
  3. 요약 에 문제에 대한 간략한 설명을 입력합니다.
  4. 설명에서 문제 또는 개선 사항에 대한 자세한 설명을 제공합니다. 문서에서 문제가 발생한 위치에 URL을 포함합니다.
  5. Submit 을 클릭하고 문제를 적절한 문서 팀으로 라우팅합니다.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 용어를 교체하기 위해 최선을 다하고 있습니다. 먼저 마스터(master), 슬레이브(slave), 블랙리스트(blacklist), 화이트리스트(whitelist) 등 네 가지 용어를 교체하고 있습니다. 이러한 변경 작업은 작업 범위가 크므로 향후 여러 릴리스에 걸쳐 점차 구현할 예정입니다. 자세한 내용은 CTO Chris Wright의 메시지를 참조하십시오.

1장. 소개

1.1. Red Hat JBoss Enterprise Application Platform 7 정보

Red Hat JBoss Enterprise Application Platform 7(JBoss EAP)은 Jakarta Enterprise Edition 8 사양과 호환되는 오픈 표준을 기반으로 구축된 미들웨어 플랫폼입니다.

JBoss EAP의 7.4 릴리스는 Web Profile 및 Full Platform 사양 모두를 위한 Jakarta EE 8 호환 구현입니다. 7.4 릴리스는 Jakarta EE 8 Web 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. JBoss Server 마이그레이션 툴 정보

한 릴리스에서 다른 릴리스로 기존 애플리케이션 서버 구성을 마이그레이션하는 것은 복잡한 작업입니다. 성공적인 마이그레이션을 계획하고 실행하려면 현재 서버 구성을 완전히 이해하고 대상 서버 구성의 기능 및 변경 사항에 대한 지식도 필요합니다. 수동 마이그레이션을 사용하면 일반적으로 여러 구성 파일을 복사하고 편집한 다음 대상 릴리스에서 동일한 동작을 유지하는 데 필요한 업데이트를 만듭니다. 이 작업이 제대로 수행되지 않으면 대상 서버가 예상대로 작동하지 않습니다. 이는 종종 대상 서버에서 일부 기능을 지원하지 않기 때문입니다.

JBoss Server 마이그레이션 도구는 최소한의 상호 작용 없이 JBoss EAP 서버 구성을 자동으로 마이그레이션하는 Java 애플리케이션입니다. 기존 구성을 유지하면서 JBoss EAP 7에 새로운 기능 및 설정을 포함하도록 JBoss EAP 서버 구성을 업데이트하는 것이 좋습니다. JBoss Server 마이그레이션 도구는 기존 소스 서버 구성 파일을 읽고 새 하위 시스템에 대한 구성을 추가하고, 기존 하위 시스템 구성을 새 기능으로 업데이트하고, 더 이상 사용되지 않는 하위 시스템 구성을 제거합니다.

JBoss Server 마이그레이션 툴은 다음 구성에 대해 독립 실행형 서버 및 관리형 도메인의 마이그레이션을 지원합니다.

JBoss EAP 7.4로 마이그레이션

JBoss Server 마이그레이션 도구는 JBoss EAP 7.4와 함께 제공되므로 별도의 다운로드 또는 설치가 필요하지 않습니다. 이 툴은 JBoss EAP 6.4 및 JBoss EAP 7.3인 제품의 이전 마이너 릴리스인 제품의 이전 주요 릴리스에서 JBoss EAP 7.4로의 마이그레이션을 지원합니다.

EAP_HOME/bin 디렉터리에 있는 jboss-server-migration 스크립트를 실행하여 툴을 실행합니다. 툴 실행에 대한 자세한 내용은 JBoss Server 마이그레이션 도구 실행을 참조하십시오.

이 버전의 JBoss Server 마이그레이션 툴을 사용하여 서버 구성을 JBoss EAP 7.4로 마이그레이션하는 것이 좋습니다.

WildFly에서 JBoss EAP로 마이그레이션

WildFly 서버에서 JBoss EAP로 마이그레이션하려면 wildfly-server-migration GitHub 리포지토리에서 JBoss Server Migration Tool의 최신 바이너리 배포를 다운로드해야 합니다. 툴의 독립 실행형 이 오픈 소스에서는 WildFly 서버의 여러 버전에서 JBoss EAP로 마이그레이션을 지원합니다. 이 버전의 툴을 설치하고 실행하는 방법에 대한 자세한 내용은 JBoss Server 마이그레이션 도구 사용자 가이드를 참조하십시오.

중요

JBoss Server 마이그레이션 툴의 바이너리 배포는 지원되지 않습니다. 이전 JBoss EAP 릴리스에서 마이그레이션하는 경우 지원되는 툴 버전을 사용하여 서버 구성을 JBoss EAP 7.4로 마이그레이션하는 것이 좋습니다.

1.3. 이 문서에서 EAP_HOME 사용 정보

이 문서에서 변수 EAP_HOME 은 대상 서버 설치 경로를 나타내는 데 사용됩니다. 이 변수를 서버 설치의 실제 경로로 바꿉니다.

참고

EAP_HOME 은 환경 변수가 아닌 대체 가능한 변수입니다. NetNamespace_HOME 은 스크립트에서 사용되는 환경 변수입니다.

JBoss EAP 설치 경로

  • ZIP 설치 방법을 사용하여 JBoss EAP를 설치한 경우 설치 디렉터리는 ZIP 아카이브를 추출한 jboss-eap-7.4 디렉터리입니다.
  • RPM 설치 방법을 사용하여 JBoss EAP를 설치한 경우 설치 디렉터리는 /opt/rh/eap7/root/usr/share/wildfly/ 입니다.
  • 설치 프로그램을 사용하여 JBoss EAP를 설치하는 경우 EAP_HOME 의 기본 경로는 ${user.home}/EAP-7.4.0 입니다.

    • Red Hat Enterprise Linux, Solaris 및 HP-UX의 경우: /home/USER_NAME/EAP-7.4.0/
    • Microsoft Windows의 경우: C:\Users\USER_NAME\EAP-7.4.0\
  • JBoss Developer Studio 설치 프로그램을 사용하여 JBoss EAP 서버를 설치하고 구성하는 경우 EAP_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\jboss-eap\

2장. 시작하기 전에

2.1. 대상 서버 업데이트

대상 서버에는 JBoss EAP 마이그레이션 도구가 포함되어 있으며 이 툴에 대한 최신 버그 수정이 포함되어 있습니다. JBoss EAP 마이그레이션 툴을 사용하여 JBoss EAP의 하나의 마이너 릴리스에서 다른 마이너 릴리스로 마이그레이션할 수 있습니다.

마이그레이션 프로세스 전에 JBoss EAP 마이그레이션 툴에서 최신 JBoss EAP 업데이트를 수신하여 툴에 이미 수정된 버그를 다시 도입하지 않도록 해야 합니다. 최신 JBoss EAP 업데이트를 대상 서버에 적용하여 툴을 업데이트할 수 있습니다.

예를 들어 기존 소스 서버 구성을 JBoss EAP 6.4에서 JBoss EAP 7.4로 마이그레이션하려면 툴을 실행하기 전에 최신 JBoss EAP Migration Tool 업데이트를 JBoss EAP 7.4에 적용해야 합니다. 그렇지 않으면 JBoss EAP 6.4에서 JBoss EAP 7.4로 마이그레이션한 후 새 소스 서버 구성에 문제가 발생할 수 있습니다.

참고

JBoss EAP 6.4 이전의 릴리스는 JBoss EAP 마이그레이션 툴을 지원하지 않습니다. JBoss EAP 6.4와 함께 툴을 사용하려면 JBoss EAP 6.4로 업그레이드해야 합니다. 또한 JBoss EAP 6.0에서 JBoss EAP 6.4로 소스 구성 파일을 복사해야 합니다.

추가 리소스

2.2. 정리 대상 서버 설치로 실행

JBoss Server 마이그레이션 도구는 이전 릴리스의 구성을 기반으로 구성 파일을 생성하므로, 정리되지 않고 구성되지 않은 대상 서버 설치에서 실행되도록 설계되었습니다. JBoss Server 마이그레이션 도구는 파일 이름에 .beforeMigration 을 추가하여 대상 서버의 구성 파일의 백업을 생성합니다. 그런 다음 소스 서버의 구성 파일을 사용하여 대상 서버에 대해 완전히 새로운 구성 파일을 생성하고 대상 서버 구성에서 실행할 구성을 마이그레이션합니다.

주의

JBoss Server 마이그레이션 도구를 실행하면 설치 및 마이그레이션 도구 실행 사이에 수행된 대상 서버의 모든 변경 사항이 손실됩니다.

또한 대상 서버 디렉토리에 대해 두 번 이상 툴을 실행하는 경우 후속 실행은 도구의 첫 번째 실행 시 백업된 원래 대상 구성 파일을 덮어씁니다. 이는 툴의 각 실행이 .beforeMigration 을 추가하여 구성 파일을 백업하므로 기존 백업 구성 파일이 손실되기 때문입니다.

2.3. 마이그레이션 사용자 정의

JBoss Server 마이그레이션 도구는 로깅, 보고 및 마이그레이션 작업 실행을 구성하는 기능을 제공합니다. 기본적으로 비대화형 모드에서 JBoss Server 마이그레이션 도구를 실행하면 전체 서버 구성을 마이그레이션합니다. JBoss Server 마이그레이션 도구를 구성하여 로깅 및 보고 출력을 사용자 지정할 수 있습니다. 마이그레이션하지 않으려는 구성의 일부를 건너뛰도록 구성할 수도 있습니다.

마이그레이션 프로세스를 제어하기 위해 속성을 구성하는 방법에 대한 자세한 내용은 JBoss Server 마이그레이션 툴 구성을 참조하십시오.

3장. JBoss Server 마이그레이션 툴 실행

다음 방법 중 하나로 JBoss Server 마이그레이션 툴을 실행할 수 있습니다.

  • 대화형 모드: 기본값인 이 모드에서는 마이그레이션할 구성을 정확하게 선택할 수 있습니다.
  • 비대화 모드:이 모드를 사용하면 프롬프트 없이 도구를 실행할 수 있습니다.
중요

JBoss Server 마이그레이션 툴을 실행하기 전에 소스와 대상 JBoss EAP 서버를 모두 중지해야 합니다.

3.1. 대화형 모드에서 JBoss Server 마이그레이션 툴 실행

기본적으로 JBoss Server 마이그레이션 도구는 대화식으로 실행됩니다. 이 모드를 사용하면 마이그레이션할 서버 구성을 정확하게 선택할 수 있습니다.

참고

대화형 모드에서는 마이그레이션할 하위 시스템을 선택할 수 없습니다. 하위 시스템 또는 작업 수준에서 도구를 구성하는 방법에 대한 자세한 내용은 JBoss Server 마이그레이션 툴에서 수행하는 마이그레이션 작업 구성을 참조하십시오.

다음은 최소 마이그레이션을 위해 수행되는 기본 단계입니다. 마이그레이션하는 서버에 사용자 정의 구성(예: 배포) 또는 기본 리소스가 누락된 경우 툴에서 추가 프롬프트를 제공합니다.

  1. 대화형 모드에서 도구를 실행하려면 대상 서버 설치 디렉터리로 이동하여 다음 명령을 실행하여 소스 서버 설치 경로로 소스 인수를 제공합니다.

    $ EAP_HOME/bin/jboss-server-migration.sh --source EAP_PREVIOUS_HOME
  2. EAP_PREVIOUS_HOME/standalone/configuration/ 디렉터리에 있는 소스 서버의 독립 실행형 구성을EAP_HOME/standalone/configuration/ 디렉터리에 있는 대상 서버의 독립 실행형 구성으로 마이그레이션할지 여부를 결정하라는 메시지가 표시됩니다.

    Migrate the source's standalone server?
    yes/no? yes

    .으로 응답하는 경우 독립 실행형 서버 마이그레이션을 건너뛰고 독립 실행형 서버 구성 파일이 마이그레이션되지 않습니다.

    yes 로 응답하는 경우 다음 프롬프트가 표시됩니다.

    Migrate all configurations?
    yes/no? yes

    yes 로 응답하여 모든 소스 서버의 독립 실행형 서버 구성 파일을 마이그레이션합니다.

    no 로 응답하여 각 개별 standalone*.xml 구성 파일에 대한 프롬프트를 받을 수 있습니다.

  3. 다음으로 EAP_PREVIOUS_HOME/domain/configuration/ 디렉터리에 있는 소스 서버의 관리형 도메인 구성을EAP_HOME/domain/configuration/ 디렉터리에 있는 대상 서버의 관리형 도메인 구성으로 마이그레이션할지 여부를 결정하라는 메시지가 표시됩니다.

    Migrate the source's managed domain?
    yes/no? yes

    .을 사용하지 않으면 관리형 도메인 마이그레이션을 건너뛰고 관리형 도메인 구성 파일이 마이그레이션되지 않습니다.

    yes 로 응답하는 경우 툴은 소스 서버의 관리형 도메인 콘텐츠 마이그레이션을 시작합니다. 암호화된 리포지토리는 소스 서버의 관리형 도메인 및 호스트 구성에서 참조하는 배포 및 배포 오버레이와 같은 데이터를 저장하는 데 사용됩니다. 소스 및 대상 서버는 유사한 콘텐츠 리포지토리를 사용하므로 툴에서 소스 서버에서 대상 서버로 데이터를 복사하고 결과를 콘솔 및 서버 로그에 출력합니다.

    INFO  [ServerMigrationTask#397] Migrating domain content found:  [22/caa450a9ba3b84eaf5a15b6da418b92ce6c98e/content, 23/b62a37ba8a4830622bfcdb960280577cc6796e/content]
    INFO  [ServerMigrationTask#398] Resource with path /EAP_HOME/domain/data/content/22/caa450a9ba3b84eaf5a15b6da418b92ce6c98e/content migrated.
    INFO  [ServerMigrationTask#399] Resource with path /EAP_HOME/domain/data/content/23/b62a37ba8a4830622bfcdb960280577cc6796e/content migrated.
  4. 다음으로 마이그레이션 툴에서는 관리형 도메인 구성 파일의 소스 서버를 스캔하고, 결과를 콘솔에 출력하고, 다음 프롬프트를 제공합니다.

    Migrate all configurations?
    yes/no? yes

    yes 로 응답하여 모든 소스 서버의 관리형 도메인 구성 파일을 마이그레이션합니다.

    no 로 응답하여 각 개별 관리형 도메인 구성 파일에 대한 프롬프트를 받을 수 있습니다.

  5. 다음으로 마이그레이션 툴에서는 소스 서버에서 호스트 구성 파일의 소스 서버를 검사하고, 결과를 콘솔에 출력하고, 다음 프롬프트를 제공합니다.

    INFO  [ServerMigrationTask#457] Retrieving source's host configurations...
    INFO  [ServerMigrationTask#457] /jboss-eap-6.4/domain/configuration/host-master.xml
    INFO  [ServerMigrationTask#457] /jboss-eap-6.4/domain/configuration/host-slave.xml
    INFO  [ServerMigrationTask#457] /jboss-eap-6.4/domain/configuration/host.xml
    
    Migrate all configurations?
    yes/no? yes

    yes 로 응답하여 모든 소스 서버의 호스트 구성 파일을 마이그레이션합니다.

    no 로 응답하여 각 호스트 구성 파일에 대한 프롬프트를 수신합니다.

  6. 완료되면 서버 콘솔에 다음 메시지가 표시됩니다.

     Migration Result: SUCCESS

3.2. 비대화형 모드에서 JBoss Server 마이그레이션 툴 실행

비대화형 모드에서 JBoss Server 마이그레이션 도구를 실행할 수 있습니다. 이 모드를 사용하면 프롬프트 없이 실행할 수 있습니다.

참고

JBoss Server 마이그레이션 도구는 모든 서버 구성 파일에 대한 모든 하위 시스템 구성을 자동으로 마이그레이션합니다. 하위 시스템 또는 작업 수준에서 도구를 구성하는 방법에 대한 자세한 내용은 JBoss Server 마이그레이션 툴에서 수행하는 마이그레이션 작업 구성을 참조하십시오.

  1. 비대화형 모드에서 도구를 실행하려면 대상 서버 설치 디렉터리로 이동하여 다음 명령을 실행하여 소스 서버 설치 경로로 소스 인수를 제공하고 --interactive 또는 -i 인수를 false 로 설정합니다.

    $ EAP_HOME/bin/jboss-server-migration.sh --source EAP_PREVIOUS_HOME --interactive false
  2. 기본적으로 이 툴은 모든 소스 서버의 독립 실행형 및 관리형 도메인 구성 파일을 자동으로 마이그레이션합니다. 그러나 특정 구성의 마이그레이션을 건너뛰도록 도구의 속성을 구성할 수 있습니다. 완료되면 서버 콘솔에 다음 메시지가 표시됩니다.

     Migration Result: SUCCESS

4장. JBoss Server 마이그레이션 툴 실행 결과 검토

4.1. 마이그레이션된 구성 파일 검토

마이그레이션이 완료되면 EAP_HOME/standalone/configuration/ 및 EAP_HOME/domain/configuration/ 디렉터리에서 마이그레이션된 서버 구성 파일을 검토합니다.

  • 마이그레이션을 위해 선택한 원래 EAP_HOME 대상 서버 구성 파일 이름이 백업되어 이제 .beforeMigration 이 추가됩니다.
  • 이제 .beforeMigration 과 함께 추가되지 않은 EAP_HOME 대상 서버 구성 파일 이름이 EAP_PREVIOUS_HOME 소스 서버 구성에서 마이그레이션된 컨텐츠를 사용하여 업데이트됩니다.
  • EAP_PREVIOUS_HOME 소스 서버 구성 디렉터리에 있는 원래 구성 파일은 그대로 유지됩니다.
  • 대상 구성 디렉터리의 logging.propertiesstandalone-load-balancer.xml 파일은 그대로 유지됩니다.

사용 가능한 구성을 모두 마이그레이션하도록 선택하는 경우 대상 서버 디렉터리에 다음 구성 파일이 표시되어야 합니다.

예: 대상 서버의 구성 파일 목록

$ ls EAP_HOME/standalone/configuration/
application-roles.properties
application-roles.properties.beforeMigration
application-users.properties
application-users.properties.beforeMigration
logging.properties
mgmt-groups.properties
mgmt-groups.properties.beforeMigration
mgmt-users.properties
mgmt-users.properties.beforeMigration
standalone-full-ha.xml
standalone-full-ha.xml.beforeMigration
standalone-full.xml
standalone-full.xml.beforeMigration
standalone-ha.xml
standalone-ha.xml.beforeMigration
standalone-load-balancer.xml
standalone-osgi.xml
standalone-osgi.xml.beforeMigration
standalone.xml
standalone.xml.beforeMigration

$ ls EAP_HOME/domain/configuration/
application-roles.properties
application-roles.properties.beforeMigration
application-users.properties
application-users.properties.beforeMigration
domain.xml
domain.xml.beforeMigration
host-master.xml
host-master.xml.beforeMigration
host-slave.xml
host-slave.xml.beforeMigration
host.xml
host.xml.beforeMigration
logging.properties
mgmt-groups.properties
mgmt-groups.properties.beforeMigration
mgmt-users.properties
mgmt-users.properties.beforeMigration

4.2. 마이그레이션 작업 실행 추적

JBoss Server 마이그레이션 툴은 루트 작업을 실행하여 각 대상 서버 마이그레이션을 시작하고 하위 작업을 실행할 수 있습니다. 이러한 하위 작업은 추가 작업과 하위 작업을 실행할 수도 있습니다. 툴은 실행 시 하위 작업과 함께 각 마이그레이션 작업을 추적하고 나중에 보고서를 빌드하는 데 사용되는 트리 구조에 결과를 저장합니다.

각 마이그레이션 작업에는 다음 구문을 사용하여 선택적 속성과 연결된 작업 이름으로 구성된 이름이 지정됩니다.

TASK_NAME(ATTRIBUTE_1_NAME=ATTRIBUTE_1_VALUE,ATTRIBUTE_2_NAME=ATTRIBUTE_2_VALUE, ...​)

이름은 작업 제목 또는 유형을 정의하고 속성은 하위 작업과 형제 작업을 구별하는 데 사용됩니다. 예를 들어, 다음 내용은 모두 Jakarta Enterprisetektons 하위 시스템 업데이트 작업을 구분하기 위한 이름입니다.

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)

마이그레이션 작업은 다른 상위 작업에서 여러 번 실행될 수 있으므로 각 작업은 > 문자로 구분된 root로 시작하는 각 상위 작업 이름을 사용하여 트리에 저장됩니다. 작업 실행 트리는 마이그레이션 보고서를 빌드하는 데 사용됩니다.

작업 실행으로 인해 다음 상태 중 하나가 발생할 수 있습니다.

상태설명

성공

작업이 성공적으로 실행되었습니다.

건너뛰기

작업이 필요하지 않았거나 건너뛰도록 구성되어 있기 때문에 실행을 건너뜁니다.

실패

작업 실행에 실패했습니다.

4.3. 작업 요약 로그 검토

작업 요약이 생성되고 마이그레이션 콘솔 및 JBoss Server 마이그레이션 툴 로그 파일에 인쇄됩니다. 구성 요소 및 하위 작업에 의해 계층적 목록으로 마이그레이션 결과에 대한 상위 수준 개요를 제공합니다.

작업 요약 보고서의 예는 이 가이드의 부록에 있습니다.

결과 출력을 구성하려면 작업 요약 옵션 구성을 참조하십시오.

4.4. JBoss Server 마이그레이션 툴 보고서 검토

JBoss Server 마이그레이션 툴은 EAP_HOME/migration/reports/ 디렉터리에 잘 포맷된 HTML 및 XML 보고서를 생성합니다. 이러한 보고서는 마이그레이션 프로세스에 대한 자세한 분석과 마이그레이션 중에 대상 서버가 구성된 방식을 제공합니다. 이러한 보고서의 기본 이름은 migration-report.htmlmigration-report.xml 입니다. 이러한 각 이름은 구성 가능합니다. 보고서를 구성하는 방법에 대한 자세한 내용은 JBoss Server 마이그레이션 툴에 대한 보고 구성을 참조하십시오.

이 섹션에서는 이러한 보고서의 콘텐츠에 대한 간략한 개요를 제공합니다.

4.4.1. JBoss Server 마이그레이션 툴 HTML 보고서

HTML 보고서는 세 가지 섹션으로 구성되어 있습니다.

요약
이 섹션에서는 실행 시작 시간, 소스 및 대상 서버에 대한 정보, 마이그레이션 결과를 제공합니다.
환경
이 섹션에는 마이그레이션에 사용된 환경 속성이 나열되어 있습니다.
Task

일관성 있는 하위 섹션이 포함된 이 섹션에서는 실행된 마이그레이션 작업의 통계와 맵을 제공합니다. 각 작업은 이름으로 나열되며 작업 완료 상태에 따라 색상이 코딩됩니다.

  • 녹색이면 성공한 것입니다.
  • 오류가 발생한 경우 Red Hat.
  • 건너 뛰는 경우 회색입니다.

예제 HTML 보고서는 이 가이드의 부록에 있습니다.

결과 출력을 구성하기 위한 옵션에 대한 HTML Report 구성을 참조하십시오.

4.4.2. JBoss Server 마이그레이션 툴 XML 보고서

XML Report는 도구에서 수집한 모든 마이그레이션 데이터를 제공하는 낮은 수준 보고서입니다. 타사 스프레드 시트 또는 기타 데이터 조작 도구로 가져오고 조작할 수 있는 방식으로 포맷됩니다.

예제 XML 보고서는 이 가이드의 부록에 있습니다.

결과 출력을 구성하려면 옵션에서 XML Report 구성을 참조하십시오.

5장. JBoss Server 마이그레이션 툴 구성

5.1. JBoss Server 마이그레이션 툴 속성 구성

속성을 사용하여 JBoss Server 마이그레이션 툴 로깅 및 출력을 보고하고 마이그레이션할 구성 요소와 구성을 결정합니다. 다음 메서드의 조합을 사용하여 이러한 속성을 구성할 수 있습니다.

5.1.1. 툴 속성을 사용하여 JBoss Server 마이그레이션 툴 구성

EAP_HOME/migration/configuration/ 디렉터리에 있는 environment.properties 파일을 사용하여 JBoss Server 마이그레이션 도구를 구성할 수 있습니다. 이 표준 Java 속성 파일은 대상 서버로 마이그레이션할 때 구성할 수 있는 모든 유효한 속성에 대한 기본값을 제공합니다. 기본값을 변경하려면 속성 앞에 있는 # 주석 문자를 제거하고 필요한 값으로 설정합니다.

5.1.2. 사용자 속성을 사용하여 JBoss Server 마이그레이션 툴 구성

원하는 경우 JBoss Server Migration Tool 구성 속성을 정의하는 표준 Java 속성 파일을 만들고 --environment 또는 -e 인수를 사용하여 명령줄에서 해당 경로를 전달할 수 있습니다. 이 경로는 절대 경로이거나 현재 디렉터리를 기준으로 하는 경로일 수 있습니다.

$ EAP_HOME/bin/jboss-server-migration.sh --source EAP_PREVIOUS_HOME --environment path/to/my-server-migration.properties

--environment 또는 -e 인수를 사용하여 명령줄에 전달된 파일에 정의된 속성이 EAP_HOME/migration/configuration/environment.properties 파일에 정의된 속성을 재정의합니다.

5.1.3. 시스템 속성을 사용하여 JBoss Server 마이그레이션 툴 구성

다음 구문을 사용하여 명령줄에서 시스템 속성을 전달하여 JBoss Server 마이그레이션 도구를 구성할 수 있습니다.

$ EAP_HOME/bin/jboss-server-migration.sh --source EAP_PREVIOUS_HOME -Djboss.server.migration.PROPERTY_NAME=PROPERTY_VALUE

시스템 속성 이름은 jboss.server.migration. concatenated 환경 속성 이름과 연결되어야 합니다. 다음 예제에서는 JBoss Server 마이그레이션 도구를 시작할 때 XML 보고서의 이름을 migration-report.xml 로 지정하는 방법을 보여줍니다.

$ EAP_HOME/bin/jboss-server-migration.sh --source EAP_PREVIOUS_HOME  -Djboss.server.migration.report.xml.fileName=migration-report.xml

명령줄에서 지정된 환경 속성은 사용자 구성 속성과 툴 구성 속성을 모두 재정의합니다.

주의

명령줄에서 시스템 속성을 전달하여 JBoss Server 마이그레이션 툴을 구성하면 현재 다음 속성이 작동하지 않습니다.

  • report.html.fileName
  • report.html.maxTaskPathSizeToDisplaySubtasks
  • report.html.templateFileName
  • report.summary.maxTaskPathSizeToDisplaySubtasks
  • report.xml.fileName

이는 JBoss EAP의 다음 버전에서 해결해야 하는 알려진 문제입니다. 이 문제에 대한 자세한 내용은 JBEAP-12901 에서 참조하십시오.

5.2. JBoss Server 마이그레이션 툴의 로깅 구성

JBoss Server 마이그레이션 툴은 JBoss Logging 프레임워크를 사용하여 마이그레이션 진행 상황을 기록합니다. 결과는 콘솔에 작성되었으며 EAP_HOME/migration/logs/ 디렉터리에 있는 migration.log 라는 파일에 작성됩니다. 이 로그 파일은 아직 없는 경우 생성되며 툴의 후속 실행마다 해당 콘텐츠를 덮어씁니다.

로깅 구성은 EAP_HOME/migration/logging.properties 파일에서 제공합니다. 이 구성 파일을 수정하거나 명령줄에서 logging.configuration 시스템 속성을 사용하여 대체 로깅 구성 파일을 지정할 수 있습니다.

$ EAP_HOME/bin/jboss-server-migration.sh --source EAP_PREVIOUS_HOME -Dlogging.configuration=file:EAP_PREVIOUS_HOME/migration/configuration/my-alternate-logging.properties

5.3. 모듈 마이그레이션 구성

JBoss Server 마이그레이션 도구는 해당 모듈이 대상 서버에 설치되어 있지 않은 한 소스 서버에 설치된 모든 모듈을 마이그레이션할 수 있습니다. 모듈 마이그레이션은 요청 시 명시적으로 수행하거나 다른 모듈 또는 마이그레이션된 서버 구성이 종속되므로 암시적으로 수행할 수 있습니다.

5.3.1. 모듈 환경 속성

modules.includesmodules.excludes 환경 속성을 사용하여 모듈을 마이그레이션해야 하는지 여부를 제어할 수 있습니다. 모듈 ID의 구문은 name:slot 입니다. :slot 는 선택 사항이며 기본값이 지정되지 않은 경우 기본값은 main 입니다.

  • modules.excludes 환경 속성에서 ID를 참조하는 모듈은 마이그레이션되지 않습니다.
  • modules.includes 환경 속성에서 참조하지 않는 한, modules. includes 환경 속성이 참조되는 모듈입니다.

5.3.2. 모듈 속성 구성

모듈을 마이그레이션하는 데 사용되는 환경 속성은 다음 방법 중 하나로 구성할 수 있습니다.

  • 도구의 EAP_HOME/migration/configuration/environment.properties 파일에서 속성을 구성할 수 있습니다.

    modules.includes=com.example.moduleA,com.example.moduleB
    modules.excludes=com.example.moduleC
  • 위의 속성을 자체 사용자 지정 속성 파일에 포함시킨 다음 --environment 인수를 사용하여 명령줄에서 속성 파일 이름을 전달할 수 있습니다.

    $ EAP_HOME/bin/jboss-server-migration.sh --source EAP_PREVIOUS_HOME --environment PATH_TO_MY_PROPERTIES_FILE
  • 시스템 속성을 사용하여 명령줄에 대한 정보를 전달할 수 있습니다. 환경 속성 이름 앞에 jboss.server.migration이 있어야 합니다. 예를 들면 다음과 같습니다.

    $ EAP_HOME/bin/jboss-server-migration.sh --source EAP_PREVIOUS_HOME -Djboss.server.migration.modules.includes="com.example.moduleA" -Djboss.server.migration.modules.excludes="com.example.moduleC,com.example.moduleD"
주의

JBoss Server 마이그레이션 도구는 소스 모듈이 대상 서버와 호환되는지 확인하지 않습니다. 호환되지 않는 마이그레이션된 모듈은 대상 서버가 손상되었거나 전혀 작동하지 않을 수 있습니다. 소스와 대상 서버 모두에 설치된 모듈에 대한 종속성으로 인해 모듈이 호환되지 않을 수 있지만 각 서버에 다른 리소스를 포함하거나 노출합니다.

5.4. JBoss Server 마이그레이션 툴에 대한 보고 구성

5.4.1. 작업 요약 로그 구성

다음 환경 속성을 사용하여 작업 요약 생성을 사용자 지정할 수 있습니다.

속성 이름유형속성 설명 및 기본값

report.summary.maxTaskPathSizeToDisplaySubtasks

정수

수준이 지정된 정수보다 작거나 같은 요약에 마이그레이션된 하위 작업을 포함합니다.

기본값은 5 입니다.

5.4.2. HTML 보고서 구성

다음 환경 속성을 사용하여 HTML 보고서를 사용자 지정할 수 있습니다.

속성 이름유형속성 설명 및 기본값

report.html.fileName

문자열

HTML 보고서 파일의 이름입니다. 설정하지 않으면 보고서가 생성되지 않습니다.

기본값은 EAP_HOME/migration/reports/migration-report.html 입니다.

report.html.maxTaskPathSizeToDisplaySubtasks

정수

수준이 지정된 정수보다 작거나 같은 요약에 마이그레이션된 하위 작업을 포함합니다.

기본값은 4 입니다.

report.html.templateFileName

문자열

HTML 보고서 템플릿 파일 이름입니다.

기본값은 migration-report-template.html 입니다.

5.4.3. XML 보고서 구성

다음 환경 속성을 사용하여 XML 보고서를 사용자 지정할 수 있습니다.

속성 이름유형속성 설명 및 기본값

report.xml.fileName

문자열

XML 보고서 파일의 이름입니다. 설정하지 않으면 보고서가 생성되지 않습니다.

기본값은 EAP_HOME/migration/reports/migration-report.xml.

5.5. 독립 실행형 서버 구성의 마이그레이션 구성

독립 실행형 서버의 마이그레이션을 완전히 건너뛰거나, 마이그레이션할 구성 파일 이름을 제공하거나, 소스 또는 대상 서버의 기본 및 구성 디렉터리에 대한 대체 경로를 제공하기 위해 JBoss Server Migration Tool을 구성할 수 있습니다.

다음 환경 속성을 사용하여 독립 실행형 서버 구성의 마이그레이션을 사용자 지정할 수 있습니다.

표 5.1. 독립 실행형 서버 마이그레이션 환경 속성

속성 이름속성 설명

standalone.skip

true 로 설정하면 툴에서 전체 독립 실행형 서버 마이그레이션을 건너뜁니다.

server.source.standalone.serverDir

소스 서버의 독립 실행형 디렉터리에 대한 대체 경로를 정의합니다. 기본값은 소스 서버의 EAP_HOME/standalone/ 디렉터리로 설정됩니다.

server.source.standalone.configDir

소스 서버의 독립 실행형 구성 디렉터리에 대한 대체 경로를 정의합니다. 기본값은 소스 서버의 EAP_HOME/standalone/configuration/ 디렉터리로 설정됩니다.

server.source.standalone.configFiles

마이그레이션할 소스 서버의 독립 실행형 구성의 쉼표로 구분된 목록입니다.

server.target.standalone.serverDir

대상 서버의 독립 실행형 디렉터리에 대한 대체 경로를 정의합니다. 이 디렉터리는 기본적으로 대상 서버의 EAP_HOME/standalone/ 디렉터리로 설정됩니다.

server.target.standalone.configDir

대상 서버의 독립 실행형 구성 디렉터리에 대한 대체 경로를 정의합니다. 기본값은 대상 서버의 EAP_HOME/standalone/configuration/ 디렉터리로 설정됩니다.

이러한 속성을 사용하여 JBoss Server 마이그레이션 툴을 구성하는 방법에 대한 자세한 내용은 JBoss Server 마이그레이션 툴 구성을 참조하십시오.

5.6. 관리형 도메인 구성의 마이그레이션 구성

관리형 도메인의 마이그레이션을 완전히 건너뛰거나, 마이그레이션할 구성 파일 이름을 제공하거나, 소스 또는 대상 서버의 기본 및 구성 디렉터리에 대한 대체 경로를 제공하기 위해 JBoss Server Migration Tool을 구성할 수 있습니다.

다음 환경 속성을 사용하여 관리형 도메인 구성의 마이그레이션을 사용자 지정할 수 있습니다.

표 5.2. 관리형 도메인 마이그레이션 환경 속성

속성 이름속성 설명

domain.skip

true 로 설정하면 툴에서 전체 관리형 도메인 마이그레이션을 건너뜁니다.

server.source.domain.domainDir

소스 서버의 관리형 도메인 디렉터리의 대체 경로를 정의합니다. 기본값은 소스 서버의 EAP_HOME/domain/ 디렉터리로 설정됩니다.

server.source.domain.configDir

소스 서버의 관리형 도메인 구성 디렉터리의 대체 경로를 정의합니다. 기본값은 소스 서버의 EAP_HOME/domain/configuration/ 디렉터리로 설정됩니다.

server.source.domain.domainConfigFiles

마이그레이션할 소스 서버의 관리형 도메인 구성 파일의 쉼표로 구분된 목록입니다.

server.source.domain.hostConfigFiles

마이그레이션할 소스 서버의 호스트 구성 파일의 쉼표로 구분된 목록입니다.

server.target.domain.domainDir

대상 서버의 관리형 도메인 디렉터리의 대체 경로를 정의합니다. 기본값은 대상 서버의 EAP_HOME/domain/ 디렉터리로 설정됩니다.

server.target.domain.configDir

대상 서버의 관리형 도메인 구성 디렉터리의 대체 경로를 정의합니다. 기본값은 대상 서버의 EAP_HOME/domain/configuration/ 디렉터리로 설정됩니다.

이러한 속성을 사용하여 JBoss Server 마이그레이션 툴을 구성하는 방법에 대한 자세한 내용은 JBoss Server 마이그레이션 툴 구성을 참조하십시오.

5.7. JBoss Server 마이그레이션 툴에서 수행하는 마이그레이션 작업 구성

기본적으로 JBoss Server 마이그레이션 도구는 마이그레이션할 각 독립 실행형 서버, 관리형 도메인 및 호스트 구성에 대한 모든 구성 요소와 하위 시스템을 자동으로 마이그레이션합니다. 환경 속성을 사용하여 툴에서 수행하는 특정 작업 및 하위 작업의 실행을 사용자 지정할 수 있습니다. 예를 들어 지원되지 않는 하위 시스템 제거를 건너뛰거나 배포 마이그레이션을 건너뛰도록 도구를 구성할 수 있습니다. 툴에서 수행하는 작업은 서버 구성 유형 및 마이그레이션 중인 소스 서버의 버전에 따라 달라집니다.

JBoss Server 마이그레이션 툴에서 수행한 작업을 사용자 지정하도록 환경 속성을 구성하는 방법에 대한 정보는 다음 섹션에서 확인할 수 있습니다.

6장. JBoss EAP 6.4 구성을 JBoss EAP 7.4로 마이그레이션

6.1. JBoss EAP 6.4 독립 실행형 서버를 JBoss EAP 7.4로 마이그레이션

기본적으로 JBoss Server 마이그레이션 도구는 독립 실행형 서버 구성을 JBoss EAP 6.4에서 JBoss EAP 7.4로 마이그레이션할 때 다음 작업을 수행합니다.

6.1.1. 지원되지 않는 하위 시스템 제거

다음 JBoss EAP 6.4 하위 시스템은 JBoss EAP 7.4에서 지원되지 않습니다.

하위 시스템 이름구성 네임스페이스확장 모듈

cmp

urn:jboss:domain:cmp:*

org.jboss.as.cmp

configadmin

urn:jboss:domain:configadmin:*

org.jboss.as.configadmin

jaxr

urn:jboss:domain:jaxr:*

org.jboss.as.jaxr

NetNamespace

urn:jboss:domain:osgi:*

org.jboss.as.osgi

스레드

urn:jboss:domain:threads:*

org.jboss.as.threads

JBoss Server 마이그레이션 도구는 지원되지 않는 모든 하위 시스템 구성과 마이그레이션된 서버 구성에서 확장 기능을 제거합니다. 툴은 각 하위 시스템과 확장 기능을 해당 로그 파일 및 제거 시 콘솔에 기록합니다.

지원되지 않는 하위 시스템 제거를 건너뛰려면 subsystems.remove-unsupported-subsystems.skip 환경 속성을 true 로 설정합니다.

JBoss Server 마이그레이션 툴의 기본 동작을 재정의하고 다음 환경 속성을 사용하여 마이그레이션 중에 포함하거나 제외해야 하는 하위 시스템과 확장을 지정할 수 있습니다.

속성 이름속성 설명

extensions.excludes

마이그레이션해서는 안 되는 확장 프로그램의 모듈 이름(예: com.example.extension1,com.example.extension 3)입니다.

extensions.includes

항상 마이그레이션해야 하는 확장의 모듈 이름 목록입니다(예: com.example.extension2,com.example.extension4 ).

subsystems.excludes

urn:jboss:domain: logging, urn:jboss:domain:tekton3 과 같이 마이그레이션해서는 안 되는 하위 시스템 네임스페이스 목록입니다.

subsystems.includes

항상 마이그레이션해야 하는 하위 시스템 네임스페이스 목록입니다(예: urn:jboss:domain:security, urn:jboss:domain:ee ).

6.1.2. 마이그레이션 참조 모듈

소스 서버에서 대상 서버로 마이그레이션된 구성은 참조되거나 대상 서버에 설치되지 않은 모듈을 사용할 수 있습니다. JBoss Server 마이그레이션 도구는 이를 감지하고 참조된 모듈과 종속 모듈을 소스 서버에서 대상 서버로 자동으로 마이그레이션합니다.

독립 실행형 서버 구성에서 참조하는 모듈은 다음 프로세스를 사용하여 마이그레이션됩니다.

  • 보안 영역 구성에서 참조하는 모듈이 플러그인 모듈로 마이그레이션됩니다.
  • 데이터 소스 하위 시스템 구성에서 참조하는 모듈이 데이터 소스 드라이버 모듈로 마이그레이션됩니다.
  • ee 하위 시스템 구성에서 참조하는 모듈이 전역 모듈로 마이그레이션됩니다.
  • 이름 지정 하위 시스템 구성에서 참조하는 모듈이 오브젝트 팩토리 모듈로 마이그레이션됩니다.
  • 메시징 하위 시스템 구성에서 참조하는 모듈이 Jakarta Messaging 브리지 모듈로 마이그레이션됩니다.
  • 자격 증명 모음 구성에서 참조하는 모듈이 새 구성으로 마이그레이션됩니다.
  • 대상 구성에 설치되지 않은 확장 기능은 대상 서버 구성으로 마이그레이션됩니다.

콘솔은 마이그레이션된 모든 모듈의 모듈 ID를 알리는 메시지를 기록합니다. modules.excludes 환경 속성에 모듈 ID를 지정하여 특정 모듈의 마이그레이션을 제외할 수 있습니다. 자세한 내용은 모듈 마이그레이션 구성을 참조하십시오.

6.1.3. 참조 경로 마이그레이션

소스 서버에서 대상 서버로 마이그레이션된 구성이 참조되거나 대상 서버로 마이그레이션되어야 하는 파일 경로 및 디렉터리에 종속될 수 있습니다. JBoss Server 마이그레이션 도구는 절대 경로 참조를 마이그레이션하지 않습니다. 소스 구성을 기준으로 구성된 파일 또는 디렉터리만 마이그레이션합니다. 콘솔은 마이그레이션된 각 경로를 알리는 메시지를 기록합니다.

JBoss Server 마이그레이션 도구는 다음 경로 참조를 자동으로 마이그레이션합니다.

  • Vault 키 저장소 및 암호화된 파일의 디렉터리.

참조 경로의 마이그레이션을 건너뛰려면 paths.migrate-paths-requested-by-configuration.vault.skip 환경 속성을 true 로 설정합니다.

6.1.4. Jacorb 하위 시스템 마이그레이션

jacorb 하위 시스템은 JBoss EAP 7.4에서 더 이상 사용되지 않으며 iiop-openjdk 하위 시스템으로 대체됩니다. 기본적으로 JBoss Server 마이그레이션 도구는 jacorb 하위 시스템 구성을 대체 iiop-openjdk 하위 시스템 구성으로 자동 마이그레이션하고 결과를 로그 파일 및 콘솔에 기록합니다.

iiop-openjdk 하위 시스템 구성으로 자동 마이그레이션을 건너뛰려면 subsystem.jacorb.migrate.skip 환경 속성 값을 true 로 설정합니다.

6.1.5. 웹 하위 시스템 마이그레이션

하위 시스템은 JBoss EAP 7.4에서 더 이상 사용되지 않으며 VDDK 하위 시스템으로 대체됩니다. 기본적으로 JBoss Server 마이그레이션 툴은 하위 시스템 구성을 교체된 Gradle 하위 시스템 구성으로 자동으로 마이그레이션하고 결과를 로그 파일 및 콘솔에 기록합니다.

하위 시스템의 자동 마이그레이션을 건너뛰려면 subsystem.web.migrate.skip 환경 속성 값을 true 로 설정합니다.

6.1.6. 메시징 하위 시스템 마이그레이션

메시징 하위 시스템은 JBoss EAP 7.4에서 더 이상 사용되지 않으며 messaging-tekton 하위 시스템으로 대체됩니다. JBoss Server 마이그레이션 툴은 메시징 하위 시스템 구성을 대체 messaging- tekton 하위 시스템 구성으로 자동으로 마이그레이션하고 결과를 로그 파일 및 콘솔에 기록합니다.

메시징 하위 시스템의 자동 마이그레이션을 건너뛰려면 subsystem.messaging.migrate.skip 환경 속성 값을 true 로 설정합니다.

6.1.7. NetNamespace 하위 시스템 업데이트

JBoss Server 마이그레이션 도구는 기본 JBoss EAP 7.4 구성과 더 잘 조정되도록 infinispan 하위 시스템 구성을 업데이트합니다.

  • JBoss EAP 7.4 기본 구성에 있는 Jakarta Enterprise1.8.0s 캐시 컨테이너를 아직 포함되지 않은 구성에 추가합니다.
  • JBoss EAP 7.4 기본 구성에 있는 서버 캐시 컨테이너를 추가합니다.
  • Hibernate 캐시 컨테이너 구성에서 모듈 이름을 업데이트합니다.
  • JBoss EAP 7.4 기본 구성에 있는 웹 캐시 컨테이너에 동시 캐시를 추가합니다.

JBoss Server 마이그레이션 도구는 infinispan 하위 시스템 구성을 자동으로 업데이트하고 결과를 로그 파일 및 콘솔에 기록합니다.

다음 환경 속성을 설정하여 infinispan 시스템의 업데이트를 사용자 지정할 수 있습니다.

속성 이름속성 설명

subsystem.infinispan.update.skip

true 로 설정하면 infinispan 하위 시스템의 업데이트를 건너뜁니다.

subsystem.infinispan.update.add-infinispan-ejb-cache.skip <<<<<<< HEAD

true 로 설정하는 경우 EJB 캐시 컨테이너를 추가하지 마십시오. ======

true 로 설정하는 경우 Jakarta EnterpriseSockets 캐시 컨테이너를 추가하지 마십시오. >>>>>>efEAP-21560

subsystem.infinispan.update.add-infinispan-server-cache.skip

true 로 설정하는 경우 서버 캐시 컨테이너를 추가하지 마십시오.

subsystem.infinispan.update.fix-hibernate-cache-module-name.skip

true 로 설정하는 경우 Hibernate 캐시 컨테이너 구성에서 모듈 이름을 업데이트하지 마십시오.

subsystem.infinispan.update-infinispan-web-cache

6.1.8. EE 하위 시스템 업데이트

JBoss Server 마이그레이션 툴은 JBoss EAP 7.4에서 지원되는 Jakarta EE 기능을 구성하도록 ee 하위 시스템을 업데이트합니다.

  • JBoss EAP 7.4 기본 구성에 있는 컨테이너 관리 executors와 같은 Jakarta EE 동시성 유틸리티 인스턴스를 구성하고 결과를 로그 파일 및 콘솔에 기록합니다.
  • 기본 JBoss EAP 6.4 구성에 있는 기본 데이터 소스(예: 기본 데이터 소스)를 정의합니다. 리소스를 찾을 수 없는 경우 도구는 구성에서 사용 가능한 모든 리소스를 나열한 다음 목록에서 리소스를 선택하거나 기본값으로 설정해야 하는 리소스의 Java Naming 및 Directory Interface 주소를 제공하는 프롬프트를 제공합니다.

    참고

    지정된 Java Naming and Directory Interface 이름이 유효한 것으로 가정합니다. Java Naming and Directory Interface 이름은 도구에서 검증되지 않습니다.

JBoss Server 마이그레이션 도구는 ee 하위 시스템 구성을 자동으로 업데이트하고 결과를 로그 파일 및 콘솔에 기록합니다.

다음 환경 속성을 설정하여 ee 시스템의 업데이트를 사용자 지정할 수 있습니다.

속성 이름속성 설명

subsystem.ee.update.skip

true 로 설정하면 ee 하위 시스템의 업데이트를 건너뜁니다.

subsystem.ee.update.setup-ee-concurrency-utilities.skip

true 로 설정하는 경우 동시성 유틸리티의 기본 인스턴스를 추가하지 마십시오.

subsystem.ee.update.setup-javaee7-default-bindings.skip

true 로 설정하면 Jakarta EE 기본 리소스를 설정하지 마십시오.

subsystem.ee.update.setup-javaee7-default-bindings.defaultDataSourceName

소스 구성에서 검색할 기본 데이터 소스의 이름을 지정합니다.

subsystem.ee.update.setup-javaee7-default-bindings.defaultDataSourceJndiName

기본 데이터 소스에 대한 Java Naming and Directory Interface 이름을 지정합니다.

subsystem.ee.update.setup-javaee7-default-bindings.defaultJmsConnectionFactoryName

기본 Jakarta Messaging 연결 팩토리의 이름을 지정합니다.

subsystem.ee.update.setup-javaee7-default-bindings.defaultJmsConnectionFactoryJndiName

기본 Jakarta Messaging 연결 팩토리의 Java Naming 및 디렉터리 인터페이스 이름을 지정합니다.

EE 하위 시스템에서 동시성 examples 구성

Jakarta EE 동시성 유틸리티를 구성하도록 선택하는 경우 툴에서 기본 JBoss EAP 7.4 구성에 있는 인스턴스를 자동으로 구성하고 결과를 로그 파일 및 콘솔에 기록합니다.

INFO  [ServerMigrationTask#49] Default ContextService added to EE subsystem configuration.
INFO  [ServerMigrationTask#49] Default ManagedThreadFactory added to EE subsystem configuration.
INFO  [ServerMigrationTask#49] Default ManagedExecutorService added to EE subsystem configuration.
INFO  [ServerMigrationTask#49] Default ManagedScheduledExecutorService added to EE subsystem configuration.

EE 하위 시스템에서 기본 리소스 구성

Jakarta EE 기본 리소스를 정의할 때 툴은 기본 JBoss EAP 7.4 구성에 있는 항목을 자동으로 선택합니다.

INFO  [ServerMigrationTask#50] Java EE Default Datasource configured with Java Naming and Directory Interface and name java:jboss/datasources/ExampleDS.

기본 리소스를 찾을 수 없는 경우 도구는 구성에서 사용할 수 있는 모든 리소스를 나열한 다음 기본 리소스를 선택하거나 기본값으로 설정해야 하는 리소스의 Java Naming 및 Directory Interface 주소를 제공하는 프롬프트를 제공합니다.

다음은 ExampleDS 데이터 소스를 사용하여 구성 파일을 마이그레이션할 때 발생하는 상호 작용의 예입니다.

INFO  [ServerMigrationTask#22] Default datasource not found.
0. ExampleDS
1. Unconfigured data source, I want to enter the Java Naming and Directory Interface name...
Please select Java EE's Default Datasource: (0): 0
INFO  [ServerMigrationTask#22] Java EE Default Datasource configured with Java Naming and Directory Interface name java:jboss/datasources/ExampleDS.

Save this Java EE Default Datasource Java Naming and Directory Interface name and use it when migrating other config files?
yes/no? y
참고

비대화형 모드에서 JBoss Server 마이그레이션 도구를 실행하고 기본 Jakarta Messaging 연결 팩토리와 같은 예상 JBoss EAP 6.4 기본 리소스를 사용할 수 없는 경우 툴에서 해당 리소스를 구성하지 않습니다.

6.1.9. Jakarta Enterprise generics 하위 시스템 업데이트

JBoss Server 마이그레이션 툴을 사용하면 기본 JBoss EAP 7.4 구성과 더 잘 조정되도록 Jakarta EnterpriseSockets 하위 시스템을 다음과 같이 업데이트합니다.

  • HTTP 커넥터를 참조하도록 원격 서비스 구성을 업데이트합니다.
  • default-sfsb-passivation-disabled-cache 특성을 구성하여 default-sfsb-cache 를 사용합니다.
  • 레거시 비활성화 저장소 및 캐시 구성을 JBoss EAP 7.4 기본값으로 교체합니다.

JBoss Server 마이그레이션 도구는 Jakarta Enterprise Tokens 하위 시스템 구성을 자동으로 업데이트하고 결과를 로그 파일 및 콘솔에 기록합니다.

Jakarta Enterprise Tokens 하위 시스템 구성이 성공적으로 업데이트되면 JBoss Server 마이그레이션 도구는 결과를 로그 파일 및 콘솔에 기록합니다.

 INFO  Subsystem ejb3 updated.

다음 환경 속성을 설정하여 Jakarta Enterprise Tokens 하위 시스템의 업데이트를 사용자 지정할 수 있습니다.

속성 이름속성 설명

subsystem.ejb3.update.skip

true 로 설정하면 Jakarta Enterprisetektons 하위 시스템의 업데이트를 건너뜁니다.

subsystem.ejb3.update.add-infinispan-passivation-store-and-distributable-cache.skip

true 로 설정하는 경우 비활성화 저장소 및 캐시 구성을 교체하지 마십시오.

subsystem.ejb3.update.setup-default-sfsb-passivation-disabled-cache.skip

true 로 설정하면 default-sfsb-passivation-disabled-cache 구성을 업데이트하지 마십시오.

subsystem.ejb3.update.activate-ejb3-remoting-http-connector.skip

true 로 설정하면 centos3 하위 시스템 리모팅 구성을 업데이트하지 마십시오.

6.1.10. VDDK 하위 시스템 업데이트

JBoss Server 마이그레이션 툴은 JBoss EAP 7.4 구성과 일치하도록 VDDK 하위 시스템을 업데이트합니다.

  • MERGE2 프로토콜을 MERGE3 으로 대체합니다.
  • FD 프로토콜을 FD_ALL 로 바꿉니다.
  • pbcast.NAKACK 프로토콜을 pbcast.NAKACK2 로 대체합니다.
  • UNICAST2 프로토콜을 UNICAST3 로 대체합니다.
  • RSVP 프로토콜을 제거합니다.
  • FRAG2 프로토콜을 FRAG3 프로토콜로 대체합니다.

VDDK 하위 시스템 구성을 성공적으로 마이그레이션하면 JBoss Server 마이그레이션 툴에서 결과를 로그 파일 및 콘솔에 기록합니다.

 INFO  Subsystem jgroups updated.

VDDK 하위 시스템의 자동 마이그레이션을 건너뛰려면 subsystem. jgroups.update.skip 환경 속성을 true 로 설정합니다.

6.1.11. Remoting 하위 시스템 업데이트

JBoss EAP 7.4에는 단일 포트를 사용하여 모든 레거시 리모팅 프로토콜 및 포트를 대체하는 HTTP 커넥터가 포함되어 있습니다. JBoss Server 마이그레이션 도구는 HTTP 커넥터를 사용하도록 remoting 하위 시스템을 자동으로 업데이트합니다.

remoting 하위 시스템 구성의 자동 업데이트를 건너뛰려면 subsystem.remoting.update.skip 환경 속성을 true 로 설정합니다.

6.1.12. 트랜잭션 하위 시스템 업데이트

JBoss Server 마이그레이션 툴은 JBoss EAP 7.4 서버에 필요한 구성 변경 사항으로 트랜잭션 하위 시스템을 업데이트합니다.

JBoss Server 마이그레이션 도구는 트랜잭션 하위 시스템에서 경로 및 상대적 간 속성을 제거하고 해당 속성을 동등한 object-store-pathobject-store- relative-to 속성으로 대체합니다.

트랜잭션 하위 시스템 구성의 자동 업데이트를 건너뛰려면 subsystem.tektons.update-xml-object-store-paths.skip 환경 속성을 true 로 설정합니다.

6.1.13. NetNamespace 하위 시스템 업데이트

JBoss EAP 7.4에 대한 하위 시스템을 마이그레이션하는 것 외에도 JBoss Server 마이그레이션 툴은 대체 VDDK 하위 시스템을 업데이트하여 지원하는 기능을 추가합니다.

  • 기본 HTTP 리스너 리디렉션 소켓을 설정합니다.
  • Jakarta WebSockets에 대한 지원이 추가되었습니다.
  • 기본 HTTPS 리스너를 설정합니다.
  • HTTP2 지원이 추가되었습니다.
  • Server 응답 헤더를 제거합니다.
  • X-Powered-By 응답 헤더를 제거합니다.
  • 기본 HTTP tekton r를 설정합니다.

JBoss Server 마이그레이션 툴은 VDD K 하위 시스템 구성을 자동으로 업데이트하고 결과를 로그 파일 및 콘솔에 기록합니다.

VDDK 하위 시스템 구성을 성공적으로 마이그레이션하면 JBoss Server 마이그레이션 툴에서 결과를 로그 파일 및 콘솔에 기록합니다.

 INFO  Subsystem undertow updated.

다음 환경 속성을 설정하여 Gradle 시스템의 업데이트를 사용자 지정할 수 있습니다.

속성 이름속성 설명

subsystem.undertow.update.skip

true 로 설정하면 VDDK 하위 시스템의 업데이트를 건너뜁니다.

subsystem.undertow.update.set-default-http-listener-redirect-socket.skip

true 로 설정하면 기본 HTTP 리스너 리디렉션 소켓을 설정하지 마십시오.

subsystem.undertow.update.add-undertow-websockets.skip

true 로 설정하는 경우 WebSockets에 대한 지원을 추가하지 마십시오.

subsystem.undertow.update.add-undertow-https-listener.skip

true 로 설정하는 경우 기본 HTTPS 리스너를 설정하지 마십시오.

subsystem.undertow.update.enable-http2.skip

true 로 설정하는 경우 HTTP2에 대한 지원을 추가하지 마십시오.

subsystem.undertow.update.add-response-header.server-header.skip

true 로 설정하면 기본 Server 응답 헤더를 설정하지 마십시오.

subsystem.undertow.update.add-response-header.x-powered-by-header.skip

true 로 설정하면 기본 X-Powered-By 응답 헤더를 설정하지 마십시오.

subsystem.undertow.update.add-http-invoker.skip

true 로 설정하면 기본 HTTP databind r를 설정하지 마십시오.

6.1.14. Messaging-ActiveMQ 하위 시스템 업데이트

JBoss EAP 7.4의 메시징 하위 시스템을 마이그레이션하는 것 외에도 JBoss Server 마이그레이션 툴은 대체 messaging- tekton 하위 시스템을 업데이트하여 지원하는 새로운 기능을 추가합니다.

  • HTTP 기반 원격 메시징 클라이언트를 활성화하기 위해 기본 HTTP 커넥터와 어셉터를 추가합니다.

JBoss Server 마이그레이션 도구는 messaging- tekton 하위 시스템 구성을 자동으로 업데이트하고 결과를 로그 파일 및 콘솔에 기록합니다.

messaging- tekton 하위 시스템의 자동 업데이트를 건너뛰려면 subsystem.messaging-tekton.update.skip 환경 속성을 true 로 설정합니다.

6.1.15. Batch JBeret 하위 시스템 추가

JBoss EAP 7.4 batch-jberet 하위 시스템은 Jakarta Batch 1.0 사양 을 지원합니다. JBoss Server 마이그레이션 도구는 기본 batch-jberet 하위 시스템 구성을 마이그레이션된 구성에 자동으로 추가합니다.

batch-jberet 하위 시스템 구성 추가를 건너뛰려면 subsystem.batch-jberet.add.skip 환경 속성을 true 로 설정합니다.

6.1.16. 코어 관리 하위 시스템 추가

JBoss EAP 7.4 core-management 하위 시스템은 관리 코어 서비스에서 이전에 구성한 관리 관련 리소스를 제공합니다. 이러한 리소스의 예로는 서버에 대한 구성 변경 내역과 서버 라이프사이클 이벤트를 모니터링할 수 있는 기능이 있습니다. JBoss Server 마이그레이션 도구는 기본 core-management 하위 시스템 구성을 마이그레이션된 구성 파일에 자동으로 추가합니다.

core-management 하위 시스템 구성 추가를 건너뛰려면 subsystem.core-management.add.skip 환경 속성을 true 로 설정합니다.

6.1.17. Discovery 하위 시스템 추가

JBoss Server 마이그레이션 툴은 마이그레이션된 구성 파일에 기본 검색 하위 시스템 구성을 자동으로 추가합니다.

검색 하위 시스템 구성 추가를 건너뛰려면 subsystem.discovery.add.skip 환경 속성을 true 로 설정합니다.

6.1.18. EE 보안 하위 시스템 추가

JBoss EAP 7.4 ee-security 하위 시스템은 Jakarta Security 에 대한 지원 및 준수를 제공합니다. JBoss Server 마이그레이션 도구는 기본 ee-security 하위 시스템 구성을 마이그레이션된 구성 파일에 자동으로 추가합니다.

ee-security 하위 시스템 구성 추가를 건너뛰려면 subsystem.ee-security.add.skip 환경 속성을 true 로 설정합니다.

6.1.19. Elytron subsystem 추가

JBoss EAP 7.4 elytron 하위 시스템은 독립 실행형 서버와 관리형 도메인에 대한 액세스를 관리하고 구성할 수 있는 단일 통합 보안 프레임워크를 제공합니다. JBoss EAP 서버에 배포된 애플리케이션에 대한 보안 액세스를 구성하는 데도 사용할 수 있습니다. JBoss Server 마이그레이션 도구는 기본 elytron 하위 시스템 구성을 마이그레이션된 구성 파일에 자동으로 추가합니다.

elytron 하위 시스템 구성을 건너뛰려면 subsystem.elytron.add.skip 환경 속성을 true 로 설정합니다.

6.1.20. 상태 하위 시스템 추가

JBoss EAP 7.4 상태 하위 시스템은 서버의 상태 기능을 지원합니다. JBoss Server 마이그레이션 툴은 마이그레이션된 구성 파일에 기본 상태 하위 시스템 구성을 자동으로 추가합니다.

상태 하위 시스템 구성 추가를 건너뛰려면 subsystem.health.add.skip 환경 속성을 true 로 설정합니다.

상태 하위 시스템을 JBoss EAP 7.4에 추가한 후 웹 콘솔에 다음 메시지가 표시됩니다.

INFO  Subsystem health added.

6.1.21. 지표 하위 시스템 추가

JBoss EAP 7.4 지표 하위 시스템은 서버의 지표 기능을 지원합니다. JBoss Server 마이그레이션 도구는 마이그레이션된 구성 파일에 기본 지표 하위 시스템 구성을 자동으로 추가합니다.

지표 하위 시스템 구성 추가를 건너뛰려면 subsystem.metrics.add.skip 환경 속성을 true 로 설정합니다.

지표 하위 시스템을 JBoss EAP 7.4에 추가한 후 웹 콘솔에 다음 메시지가 표시됩니다.

INFO  Subsystem metrics added.

6.1.22. 요청 컨트롤러 하위 시스템 추가

JBoss EAP 7.4 request-controller 하위 시스템은 정체 제어 및 정상 종료 기능을 제공합니다. JBoss Server 마이그레이션 툴은 마이그레이션된 구성 파일에 기본 request-controller 하위 시스템 구성을 자동으로 추가합니다.

request-controller 하위 시스템 구성 추가를 건너뛰려면 subsystem.request-controller.add.skip 환경 속성을 true 로 설정합니다.

6.1.23. 보안 관리자 하위 시스템 추가

JBoss EAP 7.4 security-manager 하위 시스템은 Jakarta Security 권한에 대한 지원을 제공합니다. JBoss Server 마이그레이션 툴은 마이그레이션된 구성 파일에 기본 security-manager 하위 시스템 구성을 자동으로 추가합니다.

security-manager 하위 시스템 구성 추가를 건너뛰려면 subsystem.security-manager.add.skip 환경 속성을 true 로 설정합니다.

6.1.24. Singleton 하위 시스템 추가

JBoss EAP 7.4 singleton 하위 시스템은 Singleton 기능을 제공합니다. JBoss Server 마이그레이션 툴은 마이그레이션된 구성 파일에 기본 Singleton 하위 시스템 구성을 자동으로 추가합니다.

Singleton 하위 시스템 구성 추가를 건너뛰려면 subsystem.singleton.add.skip 환경 속성을 true 로 설정합니다.

6.1.25. HTTP 업그레이드 관리 설정

JBoss EAP 7.4에 지원팀이 추가된 HTTP 업그레이드를 추가하여 단일 포트를 통해 여러 프로토콜을 멀티플렉싱할 수 있었습니다. 즉 관리 클라이언트는 HTTP를 통해 초기 연결을 만들 수 있지만 해당 연결을 다른 프로토콜로 업그레이드하라는 요청을 보냅니다. JBoss Server 마이그레이션 도구는 HTTP 업그레이드 관리를 지원하도록 구성을 자동으로 업데이트합니다.

HTTP 업그레이드 관리 구성을 건너뛰려면 management.setup-http-upgrade.skip 환경 속성을 true 로 설정합니다.

6.1.26. 개인 인터페이스 설정

JBoss EAP 7.4 기본 구성에서는 모든 NetNamespace 소켓 바인딩에서 개인 인터페이스를 사용합니다. JBoss Server 마이그레이션 도구는 동일한 구성을 사용하도록 마이그레이션 된 Gradle 소켓 바인딩을 자동으로 업데이트합니다.

개인 인터페이스의 구성을 건너뛰려면 interface.private. setup.skip 환경 속성을 true 로 설정합니다.

6.1.27. 소켓 바인딩 포트 추가

JBoss EAP 7.4 기본 구성에서는 다음 소켓 바인딩의 port 속성에 value 표현식을 사용합니다.

  • ajp
  • http
  • https

JBoss Server 마이그레이션 도구는 마이그레이션된 서버 구성에 이러한 값 표현식을 자동으로 추가합니다.

소켓 바인딩 포트 표현식의 업데이트를 건너뛰려면 socket-bindings.add-port-expressions.skip 환경 속성을 true 로 설정합니다.

6.1.28. 소켓 바인딩 멀티캐스트 주소 표현식 추가

JBoss EAP 7.4 기본 구성에서는 mod_cluster 소켓 바인딩의 multicast-address 특성에 value 표현식을 사용합니다. JBoss Server 마이그레이션 도구는 마이그레이션된 구성 파일에 이러한 값 표현식을 자동으로 추가합니다.

이러한 표현식의 추가를 건너뛰려면 socket-bindings.multicast-address.add-expressions.skip 환경 속성을 true 로 설정합니다.

6.1.29. 호환 가능한 보안 realms 마이그레이션

JBoss EAP 7.4 보안 영역 구성은 JBoss EAP 6.4 보안 영역 구성과 완전히 호환되므로 JBoss Server 마이그레이션 툴에 의해 업데이트가 필요하지 않습니다. 그러나 application-users.properties,application-roles.properties, tekton-users.properties, tekton -groups.properties 파일이 절대 경로를 사용하여 참조되지 않는 경우 툴은 마이그레이션된 구성 파일에서 예상한 경로에 파일을 복사합니다.

보안 영역 마이그레이션을 건너뛰려면 security-realms.migrate-properties.skip 환경 속성을 true 로 설정합니다.

6.1.30. ApplicationRealm에 기본 SSL 서버 ID 추가

JBoss EAP 7.4 기본 구성에는 기본 ApplicationRealm 보안 영역에 대한 SSL 서버 ID가 포함됩니다. JBoss Server 마이그레이션 도구는 마이그레이션된 구성 파일에 이 ID를 자동으로 추가합니다.

이 ID 추가를 건너뛰려면 security-realm.ApplicationRealm.add-ssl-server-identity.skip 환경 속성을 true 로 설정합니다.

6.1.31. Deployments 마이그레이션

JBoss Server 마이그레이션 도구는 다음과 같은 유형의 독립 실행형 서버 배포 구성을 마이그레이션할 수 있습니다.

배포 마이그레이션은 대상 서버에 관련 파일 리소스를 설치하고 마이그레이션된 구성을 업데이트하도록 구성됩니다.

JBoss Server 마이그레이션 도구는 비대화형 모드로 실행될 때 기본적으로 배포를 건너뛰도록 사전 구성됩니다. 배포 마이그레이션을 활성화하려면 deployments.migrate-deployments.skip 환경 속성을 false 로 설정합니다.

중요

대화형 모드에서 JBoss Server Migration Tool을 실행하고 유효하지 않은 입력을 입력하면 결과 동작은 배포 값에 따라 달라집니다.migrate-deployments 환경 속성.

  • deployments.migrate-deployments.skipfalse 로 설정되어 유효하지 않은 입력을 입력하면 툴에서 배포를 마이그레이션합니다.
  • deployments.migrate-deployments.skiptrue 로 설정되어 유효하지 않은 입력을 입력하면 툴에서 배포 마이그레이션을 건너뜁니다.

특정 유형의 배포를 마이그레이션할 수 있도록 하려면 다음 섹션을 참조하십시오.

주의

JBoss Server 마이그레이션 도구는 배포된 리소스가 대상 서버와 호환되는지 여부를 확인하지 않습니다. 즉, 애플리케이션 또는 리소스가 배포되지 않거나, 예상대로 작동하지 않거나, 전혀 작동하지 않을 수 있습니다. 또한 JBoss EAP 6.4 *-jms.xml 구성 파일과 같은 아티팩트는 수정 없이 복사되며 JBoss EAP 서버가 오류로 부팅될 수 있습니다.

Red Hat은 MTA(Migration Toolkit for Applications)를 사용하여 배포를 분석하여 서로 다른 JBoss EAP 서버 간의 호환성을 확인하는 것이 좋습니다. 자세한 내용은 Application Documentation for Migration Toolkit for Applications를 참조하십시오.

6.1.31.1. 영구 배포 마이그레이션

비대화형 모드에서 실행할 때 영구 배포를 마이그레이션할 수 있도록 deployment .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]

그런 다음 처리 워크플로는 아래 설명된 대로 대화형 모드에서 도구를 실행 중인지 또는 비대화형 모드에서 실행 중인지에 따라 달라집니다.

비대화형 모드에서 영구 배포 마이그레이션

비대화형 모드에서 도구를 실행하는 경우 툴은 사전 구성된 속성을 사용하여 영구 배포를 마이그레이션할지 여부를 결정합니다. 영구 배포는 deployments.migrate-deployments.skip 및 deployment.migrate- persistent-deployments.skip 속성 모두 false 로 설정된 경우에만 마이그레이션됩니다.

대화형 모드에서 영구 배포 마이그레이션

대화형 모드에서 툴을 실행하면 JBoss Server 마이그레이션 툴에서 다음 워크플로를 사용하여 각 배포에 대해 프롬프트를 표시합니다.

  1. 영구 배포를 인쇄한 후 콘솔에 대해 찾은 후 다음 프롬프트가 표시됩니다.

    This tool is not able to assert if persistent deployments found are compatible with the target server, skip persistent deployments migration?
    yes/no?
    • yes 로 응답하여 영구 배포 마이그레이션을 건너뜁니다. 마이그레이션된 구성에서 모든 배포 참조가 제거되고 마이그레이션 프로세스의 이 부분을 종료합니다.
    • 마이그레이션 진행을 위해 no 로 응답합니다.
  2. 계속을 선택하면 다음 프롬프트가 표시됩니다.

    Migrate all persistent deployments found?
    yes/no?
    • yes 로 응답하여 모든 배포를 자동으로 마이그레이션하고 마이그레이션 프로세스의 이 부분을 종료합니다.
    • 마이그레이션 진행을 위해 no 로 응답합니다.
  3. 계속하도록 선택하는 경우 참조된 각 배포에 대한 마이그레이션을 확인하라는 프롬프트가 표시됩니다.

    Migrate persistent deployment 'helloworld01.war'?
    yes/no?
    • Yes로 응답하여 배포를 마이그레이션합니다.
    • 마이그레이션된 구성에서 배포를 제거하지 않으려면 no 로 응답합니다.

      INFO  [ServerMigrationTask#68] Removed persistent deployment from configuration /deployment=helloworld01.war

6.1.31.2. 배포 스캐너 배포 마이그레이션

배포 스캐너는 독립 실행형 서버 구성에서만 사용되며, 새 파일의 디렉터리를 모니터링하고, 배포를 자동으로 또는 특수 배포 마커 파일을 통해 관리합니다.

비대화 모드에서 실행할 때 배포 스캐너에 의해 감시되는 디렉터리에 있는 배포를 활성화하려면 deployments.migrate-deployment-tekton-deployments.skip 환경 속성을 false 로 설정합니다.

독립 실행형 서버 구성을 마이그레이션할 때 JBoss Server 마이그레이션 툴은 먼저 구성된 모든 배포 스캐너를 검색합니다. 발견된 각 스캐너에 대해 배포된 배포가 모니터링되는 디렉터리를 검색하고 해당 결과를 콘솔에 인쇄합니다.

그런 다음 처리 워크플로는 아래 설명된 대로 대화형 모드에서 도구를 실행 중인지 또는 비대화형 모드에서 실행 중인지에 따라 달라집니다.

비대화 모드에서 배포 스캐너 배포 마이그레이션

비대화형 모드에서 도구를 실행하는 경우 툴은 사전 구성된 속성을 사용하여 배포 스캐너 배포를 마이그레이션할지 여부를 결정합니다. 배포 스캐너 배포는 deployments.migrate-deployments.skip 및deployment .migrate-deployment-deployments.skip 속성이 모두 false 로 설정된 경우에만 마이그레이션됩니다.

대화형 모드에서 배포 스캐너 배포 마이그레이션

대화형 모드에서 툴을 실행하면 JBoss Server 마이그레이션 툴에서 다음 워크플로를 사용하여 각 배포에 대해 프롬프트를 표시합니다.

  1. 배포 스캐너 배포를 인쇄하면 콘솔에 다음 프롬프트가 표시됩니다.

    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?
    • yes 로 응답하여 배포 스캐너 배포 마이그레이션을 건너뜁니다. 마이그레이션된 구성에서 모든 배포 참조가 제거되고 마이그레이션 프로세스의 이 부분을 종료합니다.
    • 마이그레이션 진행을 위해 no 로 응답합니다.
  2. 계속을 선택하면 다음 프롬프트가 표시됩니다.

    Migrate all scanner's deployments found?
    yes/no?
    • yes 로 응답하여 모든 배포를 자동으로 마이그레이션하고 마이그레이션 프로세스의 이 부분을 종료합니다.
    • 마이그레이션 진행을 위해 no 로 응답합니다.
  3. 계속하도록 선택하는 경우 참조된 각 배포에 대한 마이그레이션을 확인하라는 프롬프트가 표시됩니다.

    Migrate scanner's deployment 'helloworld02.war'?
    yes/no?
    • Yes로 응답하여 배포를 마이그레이션합니다.
    • 마이그레이션된 구성에서 배포를 제거하지 않으려면 no 로 응답합니다.

      INFO  [ServerMigrationTask#69] Resource with path EAP_HOME/standalone/deployments/helloworld02.war migrated.

6.1.31.3. Deployment Overlays 마이그레이션

배포 오버레이를 마이그레이션하는 것은 완전히 자동화된 프로세스입니다. deployments.migrate-deployments.skip 환경 속성을 false 로 설정하여 배포를 활성화한 경우, JBoss Server 마이그레이션 툴은 배포를 마이그레이션하기 위해 연결된 독립 실행형 서버 구성에서 참조하는 배포 오버레이를 검색합니다. 찾은 항목을 자동으로 마이그레이션하고, 참조되지 않는 항목을 제거하고, 결과를 로그 파일 및 콘솔에 기록합니다.

6.2. JBoss EAP 6.4 관리형 도메인을 JBoss EAP 7.4로 마이그레이션

주의

JBoss Server 마이그레이션 도구를 사용할 때 호스트를 마이그레이션하기 전에 도메인 컨트롤러를 마이그레이션하여 호스트에서 사용하는 버전과 비교할 때 도메인 컨트롤러의 최신 버전의 EAP를 사용해야 합니다. 예를 들어 EAP 7.3에서 실행되는 도메인 컨트롤러는 EAP 7.4에서 실행되는 호스트를 처리할 수 없습니다.

JBoss EAP용 구성 가이드 의 JBoss EAP 6 인스턴스에 JBoss EAP 7.x 도메인 컨트롤러 구성을 검토합니다. JBoss EAP 7 업데이트 수신에서 JBoss EAP 6 인스턴스 비활성화 섹션에 특별히 주의하십시오.

지원되는 구성에 대한 자세한 내용은 JBoss EAP 구성 가이드여러 JBoss EAP 버전 관리를 참조하십시오.

기본적으로 JBoss Server 마이그레이션 툴은 관리형 도메인 구성을 JBoss EAP 6.4에서 JBoss EAP 7.4로 마이그레이션할 때 다음과 같은 작업을 수행합니다.

6.2.1. 지원되지 않는 하위 시스템 제거

다음 JBoss EAP 6.4 하위 시스템은 JBoss EAP 7.4에서 지원되지 않습니다.

하위 시스템 이름구성 네임스페이스확장 모듈

cmp

urn:jboss:domain:cmp:*

org.jboss.as.cmp

configadmin

urn:jboss:domain:configadmin:*

org.jboss.as.configadmin

jaxr

urn:jboss:domain:jaxr:*

org.jboss.as.jaxr

NetNamespace

urn:jboss:domain:osgi:*

org.jboss.as.osgi

스레드

urn:jboss:domain:threads:*

org.jboss.as.threads

JBoss Server 마이그레이션 도구는 지원되지 않는 모든 하위 시스템 구성과 마이그레이션된 서버 구성에서 확장 기능을 제거합니다. 툴은 각 하위 시스템과 확장 기능을 해당 로그 파일 및 제거 시 콘솔에 기록합니다.

지원되지 않는 하위 시스템 제거를 건너뛰려면 subsystems.remove-unsupported-subsystems.skip 환경 속성을 true 로 설정합니다.

JBoss Server 마이그레이션 툴의 기본 동작을 재정의하고 다음 환경 속성을 사용하여 마이그레이션 중에 포함하거나 제외해야 하는 하위 시스템과 확장을 지정할 수 있습니다.

속성 이름속성 설명

extensions.excludes

마이그레이션해서는 안 되는 확장 프로그램의 모듈 이름(예: com.example.extension1,com.example.extension 3)입니다.

extensions.includes

항상 마이그레이션해야 하는 확장의 모듈 이름 목록입니다(예: com.example.extension2,com.example.extension4 ).

subsystems.excludes

urn:jboss:domain: logging, urn:jboss:domain:tekton3 과 같이 마이그레이션해서는 안 되는 하위 시스템 네임스페이스 목록입니다.

subsystems.includes

항상 마이그레이션해야 하는 하위 시스템 네임스페이스 목록입니다(예: urn:jboss:domain:security, urn:jboss:domain:ee ).

6.2.2. 마이그레이션 참조 모듈

소스 서버에서 대상 서버로 마이그레이션된 구성은 참조되거나 대상 서버에 설치되지 않은 모듈을 사용할 수 있습니다. JBoss Server 마이그레이션 도구는 이를 감지하고 참조된 모듈과 종속 모듈을 소스 서버에서 대상 서버로 자동으로 마이그레이션합니다.

관리형 도메인 구성에서 참조하는 모듈이 다음 프로세스를 사용하여 마이그레이션됩니다.

  • 보안 영역 구성에서 참조하는 모듈이 플러그인 모듈로 마이그레이션됩니다.
  • 데이터 소스 하위 시스템 구성에서 참조하는 모듈이 데이터 소스 드라이버 모듈로 마이그레이션됩니다.
  • ee 하위 시스템 구성에서 참조하는 모듈이 전역 모듈로 마이그레이션됩니다.
  • 이름 지정 하위 시스템 구성에서 참조하는 모듈이 오브젝트 팩토리 모듈로 마이그레이션됩니다.
  • 메시징 하위 시스템 구성에서 참조하는 모듈이 Jakarta Messaging 브리지 모듈로 마이그레이션됩니다.
  • 자격 증명 모음 구성에서 참조하는 모듈이 새 구성으로 마이그레이션됩니다.
  • 대상 구성에 설치되지 않은 확장 기능은 대상 서버 구성으로 마이그레이션됩니다.

콘솔은 마이그레이션된 모든 모듈의 모듈 ID를 알리는 메시지를 기록합니다. modules.excludes 환경 속성에 모듈 ID를 지정하여 특정 모듈의 마이그레이션을 제외할 수 있습니다. 자세한 내용은 모듈 마이그레이션 구성을 참조하십시오.

6.2.3. 참조 경로 마이그레이션

소스 서버에서 대상 서버로 마이그레이션된 구성이 참조되거나 대상 서버로 마이그레이션되어야 하는 파일 경로 및 디렉터리에 종속될 수 있습니다. JBoss Server 마이그레이션 도구는 절대 경로 참조를 마이그레이션하지 않습니다. 소스 구성을 기준으로 구성된 파일 또는 디렉터리만 마이그레이션합니다. 콘솔은 마이그레이션된 각 경로를 알리는 메시지를 기록합니다.

JBoss Server 마이그레이션 도구는 다음 경로 참조를 자동으로 마이그레이션합니다.

  • Vault 키 저장소 및 암호화된 파일의 디렉터리.

참조 경로의 마이그레이션을 건너뛰려면 paths.migrate-paths-requested-by-configuration.vault.skip 환경 속성을 true 로 설정합니다.

6.2.4. Jacorb 하위 시스템 마이그레이션

jacorb 하위 시스템은 JBoss EAP 7.4에서 더 이상 사용되지 않으며 iiop-openjdk 하위 시스템으로 대체됩니다. 기본적으로 JBoss Server 마이그레이션 도구는 jacorb 하위 시스템 구성을 대체 iiop-openjdk 하위 시스템 구성으로 자동 마이그레이션하고 결과를 로그 파일 및 콘솔에 기록합니다.

iiop-openjdk 하위 시스템 구성으로 자동 마이그레이션을 건너뛰려면 subsystem.jacorb.migrate.skip 환경 속성 값을 true 로 설정합니다.

6.2.5. 웹 하위 시스템 마이그레이션

하위 시스템은 JBoss EAP 7.4에서 더 이상 사용되지 않으며 VDDK 하위 시스템으로 대체됩니다. 기본적으로 JBoss Server 마이그레이션 툴은 하위 시스템 구성을 교체된 Gradle 하위 시스템 구성으로 자동으로 마이그레이션하고 결과를 로그 파일 및 콘솔에 기록합니다.

하위 시스템의 자동 마이그레이션을 건너뛰려면 subsystem.web.migrate.skip 환경 속성 값을 true 로 설정합니다.

6.2.6. 메시징 하위 시스템 마이그레이션

메시징 하위 시스템은 JBoss EAP 7.4에서 더 이상 사용되지 않으며 messaging-tekton 하위 시스템으로 대체됩니다. JBoss Server 마이그레이션 툴은 메시징 하위 시스템 구성을 대체 messaging- tekton 하위 시스템 구성으로 자동으로 마이그레이션하고 결과를 로그 파일 및 콘솔에 기록합니다.

메시징 하위 시스템의 자동 마이그레이션을 건너뛰려면 subsystem.messaging.migrate.skip 환경 속성 값을 true 로 설정합니다.

6.2.7. NetNamespace 하위 시스템 업데이트

JBoss Server 마이그레이션 도구는 기본 JBoss EAP 7.4 구성과 더 잘 조정되도록 infinispan 하위 시스템 구성을 업데이트합니다.

  • JBoss EAP 7.4 기본 구성에 있는 Jakarta Enterprise1.8.0s 캐시 컨테이너를 아직 포함되지 않은 구성에 추가합니다.
  • JBoss EAP 7.4 기본 구성에 있는 서버 캐시 컨테이너를 추가합니다.
  • Hibernate 캐시 컨테이너 구성에서 모듈 이름을 업데이트합니다.
  • JBoss EAP 7.4 기본 구성에 있는 웹 캐시 컨테이너에 동시 캐시를 추가합니다.

JBoss Server 마이그레이션 도구는 infinispan 하위 시스템 구성을 자동으로 업데이트하고 결과를 로그 파일 및 콘솔에 기록합니다.

다음 환경 속성을 설정하여 infinispan 시스템의 업데이트를 사용자 지정할 수 있습니다.

속성 이름속성 설명

subsystem.infinispan.update.skip

true 로 설정하면 infinispan 하위 시스템의 업데이트를 건너뜁니다.

subsystem.infinispan.update.add-infinispan-ejb-cache.skip <<<<<<< HEAD

true 로 설정하는 경우 EJB 캐시 컨테이너를 추가하지 마십시오. ======

true 로 설정하는 경우 Jakarta EnterpriseSockets 캐시 컨테이너를 추가하지 마십시오. >>>>>>efEAP-21560

subsystem.infinispan.update.add-infinispan-server-cache.skip

true 로 설정하는 경우 서버 캐시 컨테이너를 추가하지 마십시오.

subsystem.infinispan.update.fix-hibernate-cache-module-name.skip

true 로 설정하는 경우 Hibernate 캐시 컨테이너 구성에서 모듈 이름을 업데이트하지 마십시오.

subsystem.infinispan.update-infinispan-web-cache

6.2.8. EE 하위 시스템 업데이트

JBoss Server 마이그레이션 툴은 JBoss EAP 7.4에서 지원되는 Jakarta EE 기능을 구성하도록 ee 하위 시스템을 업데이트합니다.

  • JBoss EAP 7.4 기본 구성에 있는 컨테이너 관리 executors와 같은 Jakarta EE 동시성 유틸리티 인스턴스를 구성하고 결과를 로그 파일 및 콘솔에 기록합니다.
  • 기본 JBoss EAP 6.4 구성에 있는 기본 데이터 소스(예: 기본 데이터 소스)를 정의합니다. 리소스를 찾을 수 없는 경우 도구는 구성에서 사용 가능한 모든 리소스를 나열한 다음 목록에서 리소스를 선택하거나 기본값으로 설정해야 하는 리소스의 Java Naming 및 Directory Interface 주소를 제공하는 프롬프트를 제공합니다.

    참고

    지정된 Java Naming and Directory Interface 이름이 유효한 것으로 가정합니다. Java Naming and Directory Interface 이름은 도구에서 검증되지 않습니다.

JBoss Server 마이그레이션 도구는 ee 하위 시스템 구성을 자동으로 업데이트하고 결과를 로그 파일 및 콘솔에 기록합니다.

다음 환경 속성을 설정하여 ee 시스템의 업데이트를 사용자 지정할 수 있습니다.

속성 이름속성 설명

subsystem.ee.update.skip

true 로 설정하면 ee 하위 시스템의 업데이트를 건너뜁니다.

subsystem.ee.update.setup-ee-concurrency-utilities.skip

true 로 설정하는 경우 동시성 유틸리티의 기본 인스턴스를 추가하지 마십시오.

subsystem.ee.update.setup-javaee7-default-bindings.skip

true 로 설정하면 Jakarta EE 기본 리소스를 설정하지 마십시오.

subsystem.ee.update.setup-javaee7-default-bindings.defaultDataSourceName

소스 구성에서 검색할 기본 데이터 소스의 이름을 지정합니다.

subsystem.ee.update.setup-javaee7-default-bindings.defaultDataSourceJndiName

기본 데이터 소스에 대한 Java Naming and Directory Interface 이름을 지정합니다.

subsystem.ee.update.setup-javaee7-default-bindings.defaultJmsConnectionFactoryName

기본 Jakarta Messaging 연결 팩토리의 이름을 지정합니다.

subsystem.ee.update.setup-javaee7-default-bindings.defaultJmsConnectionFactoryJndiName

기본 Jakarta Messaging 연결 팩토리의 Java Naming 및 디렉터리 인터페이스 이름을 지정합니다.

EE 하위 시스템에서 동시성 examples 구성

Jakarta EE 동시성 유틸리티를 구성하도록 선택하는 경우 툴에서 기본 JBoss EAP 7.4 구성에 있는 인스턴스를 자동으로 구성하고 결과를 로그 파일 및 콘솔에 기록합니다.

INFO  [ServerMigrationTask#49] Default ContextService added to EE subsystem configuration.
INFO  [ServerMigrationTask#49] Default ManagedThreadFactory added to EE subsystem configuration.
INFO  [ServerMigrationTask#49] Default ManagedExecutorService added to EE subsystem configuration.
INFO  [ServerMigrationTask#49] Default ManagedScheduledExecutorService added to EE subsystem configuration.

EE 하위 시스템에서 기본 리소스 구성

Jakarta EE 기본 리소스를 정의할 때 툴은 기본 JBoss EAP 7.4 구성에 있는 항목을 자동으로 선택합니다.

INFO  [ServerMigrationTask#50] Java EE Default Datasource configured with Java Naming and Directory Interface and name java:jboss/datasources/ExampleDS.

기본 리소스를 찾을 수 없는 경우 도구는 구성에서 사용할 수 있는 모든 리소스를 나열한 다음 기본 리소스를 선택하거나 기본값으로 설정해야 하는 리소스의 Java Naming 및 Directory Interface 주소를 제공하는 프롬프트를 제공합니다.

다음은 ExampleDS 데이터 소스를 사용하여 구성 파일을 마이그레이션할 때 발생하는 상호 작용의 예입니다.

INFO  [ServerMigrationTask#22] Default datasource not found.
0. ExampleDS
1. Unconfigured data source, I want to enter the Java Naming and Directory Interface name...
Please select Java EE's Default Datasource: (0): 0
INFO  [ServerMigrationTask#22] Java EE Default Datasource configured with Java Naming and Directory Interface name java:jboss/datasources/ExampleDS.

Save this Java EE Default Datasource Java Naming and Directory Interface name and use it when migrating other config files?
yes/no? y
참고

비대화형 모드에서 JBoss Server 마이그레이션 도구를 실행하고 기본 Jakarta Messaging 연결 팩토리와 같은 예상 JBoss EAP 6.4 기본 리소스를 사용할 수 없는 경우 툴에서 해당 리소스를 구성하지 않습니다.

6.2.9. Jakarta Enterprise generics 하위 시스템 업데이트

JBoss Server 마이그레이션 툴을 사용하면 기본 JBoss EAP 7.4 구성과 더 잘 조정되도록 Jakarta EnterpriseSockets 하위 시스템을 다음과 같이 업데이트합니다.

  • HTTP 커넥터를 참조하도록 원격 서비스 구성을 업데이트합니다.
  • default-sfsb-passivation-disabled-cache 특성을 구성하여 default-sfsb-cache 를 사용합니다.
  • 레거시 비활성화 저장소 및 캐시 구성을 JBoss EAP 7.4 기본값으로 교체합니다.

JBoss Server 마이그레이션 도구는 Jakarta Enterprise Tokens 하위 시스템 구성을 자동으로 업데이트하고 결과를 로그 파일 및 콘솔에 기록합니다.

Jakarta Enterprise Tokens 하위 시스템 구성이 성공적으로 업데이트되면 JBoss Server 마이그레이션 도구는 결과를 로그 파일 및 콘솔에 기록합니다.

 INFO  Subsystem ejb3 updated.

다음 환경 속성을 설정하여 Jakarta Enterprise Tokens 하위 시스템의 업데이트를 사용자 지정할 수 있습니다.

속성 이름속성 설명

subsystem.ejb3.update.skip

true 로 설정하면 Jakarta Enterprisetektons 하위 시스템의 업데이트를 건너뜁니다.

subsystem.ejb3.update.add-infinispan-passivation-store-and-distributable-cache.skip

true 로 설정하는 경우 비활성화 저장소 및 캐시 구성을 교체하지 마십시오.

subsystem.ejb3.update.setup-default-sfsb-passivation-disabled-cache.skip

true 로 설정하면 default-sfsb-passivation-disabled-cache 구성을 업데이트하지 마십시오.

subsystem.ejb3.update.activate-ejb3-remoting-http-connector.skip

true 로 설정하면 centos3 하위 시스템 리모팅 구성을 업데이트하지 마십시오.

6.2.10. VDDK 하위 시스템 업데이트

JBoss Server 마이그레이션 툴은 JBoss EAP 7.4 구성과 일치하도록 VDDK 하위 시스템을 업데이트합니다.

  • MERGE2 프로토콜을 MERGE3 으로 대체합니다.
  • FD 프로토콜을 FD_ALL 로 바꿉니다.
  • pbcast.NAKACK 프로토콜을 pbcast.NAKACK2 로 대체합니다.
  • UNICAST2 프로토콜을 UNICAST3 로 대체합니다.
  • RSVP 프로토콜을 제거합니다.
  • FRAG2 프로토콜을 FRAG3 프로토콜로 대체합니다.

VDDK 하위 시스템 구성을 성공적으로 마이그레이션하면 JBoss Server 마이그레이션 툴에서 결과를 로그 파일 및 콘솔에 기록합니다.

 INFO  Subsystem jgroups updated.

VDDK 하위 시스템의 자동 마이그레이션을 건너뛰려면 subsystem. jgroups.update.skip 환경 속성을 true 로 설정합니다.

6.2.11. Remoting 하위 시스템 업데이트

JBoss EAP 7.4에는 단일 포트를 사용하여 모든 레거시 리모팅 프로토콜 및 포트를 대체하는 HTTP 커넥터가 포함되어 있습니다. JBoss Server 마이그레이션 도구는 HTTP 커넥터를 사용하도록 remoting 하위 시스템을 자동으로 업데이트합니다.

remoting 하위 시스템 구성의 자동 업데이트를 건너뛰려면 subsystem.remoting.update.skip 환경 속성을 true 로 설정합니다.

6.2.12. 트랜잭션 하위 시스템 업데이트

JBoss Server 마이그레이션 툴은 JBoss EAP 7.4 서버에 필요한 구성 변경 사항으로 트랜잭션 하위 시스템을 업데이트합니다.

JBoss Server 마이그레이션 도구는 트랜잭션 하위 시스템에서 경로 및 상대적 간 속성을 제거하고 해당 속성을 동등한 object-store-pathobject-store- relative-to 속성으로 대체합니다.

트랜잭션 하위 시스템 구성의 자동 업데이트를 건너뛰려면 subsystem.tektons.update-xml-object-store-paths.skip 환경 속성을 true 로 설정합니다.

6.2.13. NetNamespace 하위 시스템 업데이트

JBoss EAP 7.4에 대한 하위 시스템을 마이그레이션하는 것 외에도 JBoss Server 마이그레이션 툴은 대체 VDDK 하위 시스템을 업데이트하여 지원하는 기능을 추가합니다.

  • 기본 HTTP 리스너 리디렉션 소켓을 설정합니다.
  • Jakarta WebSockets에 대한 지원이 추가되었습니다.
  • 기본 HTTPS 리스너를 설정합니다.
  • HTTP2 지원이 추가되었습니다.
  • Server 응답 헤더를 제거합니다.
  • X-Powered-By 응답 헤더를 제거합니다.
  • 기본 HTTP tekton r를 설정합니다.

JBoss Server 마이그레이션 툴은 VDD K 하위 시스템 구성을 자동으로 업데이트하고 결과를 로그 파일 및 콘솔에 기록합니다.

VDDK 하위 시스템 구성을 성공적으로 마이그레이션하면 JBoss Server 마이그레이션 툴에서 결과를 로그 파일 및 콘솔에 기록합니다.

 INFO  Subsystem undertow updated.

다음 환경 속성을 설정하여 Gradle 시스템의 업데이트를 사용자 지정할 수 있습니다.

속성 이름속성 설명

subsystem.undertow.update.skip

true 로 설정하면 VDDK 하위 시스템의 업데이트를 건너뜁니다.

subsystem.undertow.update.set-default-http-listener-redirect-socket.skip

true 로 설정하면 기본 HTTP 리스너 리디렉션 소켓을 설정하지 마십시오.

subsystem.undertow.update.add-undertow-websockets.skip

true 로 설정하는 경우 WebSockets에 대한 지원을 추가하지 마십시오.

subsystem.undertow.update.add-undertow-https-listener.skip

true 로 설정하는 경우 기본 HTTPS 리스너를 설정하지 마십시오.

subsystem.undertow.update.enable-http2.skip

true 로 설정하는 경우 HTTP2에 대한 지원을 추가하지 마십시오.

subsystem.undertow.update.add-response-header.server-header.skip

true 로 설정하면 기본 Server 응답 헤더를 설정하지 마십시오.

subsystem.undertow.update.add-response-header.x-powered-by-header.skip

true 로 설정하면 기본 X-Powered-By 응답 헤더를 설정하지 마십시오.

subsystem.undertow.update.add-http-invoker.skip

true 로 설정하면 기본 HTTP databind r를 설정하지 마십시오.

6.2.14. Messaging-ActiveMQ 하위 시스템 업데이트

JBoss EAP 7.4의 메시징 하위 시스템을 마이그레이션하는 것 외에도 JBoss Server 마이그레이션 툴은 대체 messaging- tekton 하위 시스템을 업데이트하여 지원하는 새로운 기능을 추가합니다.

  • HTTP 기반 원격 메시징 클라이언트를 활성화하기 위해 기본 HTTP 커넥터와 어셉터를 추가합니다.

JBoss Server 마이그레이션 도구는 messaging- tekton 하위 시스템 구성을 자동으로 업데이트하고 결과를 로그 파일 및 콘솔에 기록합니다.

messaging- tekton 하위 시스템의 자동 업데이트를 건너뛰려면 subsystem.messaging-tekton.update.skip 환경 속성을 true 로 설정합니다.

6.2.15. Batch JBeret 하위 시스템 추가

JBoss EAP 7.4 batch-jberet 하위 시스템은 Jakarta Batch 1.0 사양 을 지원합니다. JBoss Server 마이그레이션 도구는 기본 batch-jberet 하위 시스템 구성을 마이그레이션된 구성에 자동으로 추가합니다.

batch-jberet 하위 시스템 구성 추가를 건너뛰려면 subsystem.batch-jberet.add.skip 환경 속성을 true 로 설정합니다.

6.2.16. 코어 관리 하위 시스템 추가

JBoss EAP 7.4 core-management 하위 시스템은 관리 코어 서비스에서 이전에 구성한 관리 관련 리소스를 제공합니다. 이러한 리소스의 예로는 서버에 대한 구성 변경 내역과 서버 라이프사이클 이벤트를 모니터링할 수 있는 기능이 있습니다. JBoss Server 마이그레이션 도구는 기본 core-management 하위 시스템 구성을 마이그레이션된 구성 파일에 자동으로 추가합니다.

core-management 하위 시스템 구성 추가를 건너뛰려면 subsystem.core-management.add.skip 환경 속성을 true 로 설정합니다.

6.2.17. Discovery 하위 시스템 추가

JBoss Server 마이그레이션 툴은 마이그레이션된 구성 파일에 기본 검색 하위 시스템 구성을 자동으로 추가합니다.

검색 하위 시스템 구성 추가를 건너뛰려면 subsystem.discovery.add.skip 환경 속성을 true 로 설정합니다.

6.2.18. EE 보안 하위 시스템 추가

JBoss EAP 7.4 ee-security 하위 시스템은 Jakarta Security 에 대한 지원 및 준수를 제공합니다. JBoss Server 마이그레이션 도구는 기본 ee-security 하위 시스템 구성을 마이그레이션된 구성 파일에 자동으로 추가합니다.

ee-security 하위 시스템 구성 추가를 건너뛰려면 subsystem.ee-security.add.skip 환경 속성을 true 로 설정합니다.

6.2.19. Elytron subsystem 추가

JBoss EAP 7.4 elytron 하위 시스템은 독립 실행형 서버와 관리형 도메인에 대한 액세스를 관리하고 구성할 수 있는 단일 통합 보안 프레임워크를 제공합니다. JBoss EAP 서버에 배포된 애플리케이션에 대한 보안 액세스를 구성하는 데도 사용할 수 있습니다. JBoss Server 마이그레이션 도구는 기본 elytron 하위 시스템 구성을 마이그레이션된 구성 파일에 자동으로 추가합니다.

elytron 하위 시스템 구성을 건너뛰려면 subsystem.elytron.add.skip 환경 속성을 true 로 설정합니다.

6.2.20. 요청 컨트롤러 하위 시스템 추가

JBoss EAP 7.4 request-controller 하위 시스템은 정체 제어 및 정상 종료 기능을 제공합니다. JBoss Server 마이그레이션 툴은 마이그레이션된 구성 파일에 기본 request-controller 하위 시스템 구성을 자동으로 추가합니다.

request-controller 하위 시스템 구성 추가를 건너뛰려면 subsystem.request-controller.add.skip 환경 속성을 true 로 설정합니다.

6.2.21. 보안 관리자 하위 시스템 추가

JBoss EAP 7.4 security-manager 하위 시스템은 Jakarta Security 권한에 대한 지원을 제공합니다. JBoss Server 마이그레이션 툴은 마이그레이션된 구성 파일에 기본 security-manager 하위 시스템 구성을 자동으로 추가합니다.

security-manager 하위 시스템 구성 추가를 건너뛰려면 subsystem.security-manager.add.skip 환경 속성을 true 로 설정합니다.

6.2.22. Singleton 하위 시스템 추가

JBoss EAP 7.4 singleton 하위 시스템은 Singleton 기능을 제공합니다. JBoss Server 마이그레이션 툴은 마이그레이션된 구성 파일에 기본 Singleton 하위 시스템 구성을 자동으로 추가합니다.

Singleton 하위 시스템 구성 추가를 건너뛰려면 subsystem.singleton.add.skip 환경 속성을 true 로 설정합니다.

6.2.23. 비보안 인터페이스 업데이트

JBoss Server 마이그레이션 도구는 JBoss EAP 7.4 기본 구성에 맞게 안전하지 않은 인터페이스 구성을 자동으로 업데이트합니다.

비보안 인터페이스의 구성을 건너뛰려면 interface. unsecure.update.skip 환경 속성을 true 로 설정합니다.

6.2.24. 개인 인터페이스 설정

JBoss EAP 7.4 기본 구성에서는 모든 NetNamespace 소켓 바인딩에서 개인 인터페이스를 사용합니다. JBoss Server 마이그레이션 도구는 동일한 구성을 사용하도록 마이그레이션 된 Gradle 소켓 바인딩을 자동으로 업데이트합니다.

개인 인터페이스의 구성을 건너뛰려면 interface.private. setup.skip 환경 속성을 true 로 설정합니다.

6.2.25. 소켓 바인딩 포트 추가

JBoss EAP 7.4 기본 구성에서는 다음 소켓 바인딩의 port 속성에 value 표현식을 사용합니다.

  • ajp
  • http
  • https

JBoss Server 마이그레이션 도구는 마이그레이션된 서버 구성에 이러한 값 표현식을 자동으로 추가합니다.

소켓 바인딩 포트 표현식의 업데이트를 건너뛰려면 socket-bindings.add-port-expressions.skip 환경 속성을 true 로 설정합니다.

6.2.26. 소켓 바인딩 멀티캐스트 주소 표현식 추가

JBoss EAP 7.4 기본 구성에서는 mod_cluster 소켓 바인딩의 multicast-address 특성에 value 표현식을 사용합니다. JBoss Server 마이그레이션 도구는 마이그레이션된 구성 파일에 이러한 값 표현식을 자동으로 추가합니다.

이러한 표현식의 추가를 건너뛰려면 socket-bindings.multicast-address.add-expressions.skip 환경 속성을 true 로 설정합니다.

6.2.27. 로드 밸런서 프로필 추가

JBoss EAP 7.4에는 로드 밸런서 장치 역할을 하는 호스트에 맞게 특별히 조정된 기본 프로필이 포함되어 있습니다. JBoss Server 마이그레이션 도구는 마이그레이션된 모든 관리형 도메인 구성에 이 프로필을 자동으로 추가하고 구성합니다.

이 프로필의 추가를 건너뛰려면 profile.load-balancer.add.skip 환경 속성을 true 로 설정합니다.

6.2.28. 호스트 제외 추가

JBoss EAP 7.4 도메인 컨트롤러에는 이전 버전의 서버에서 실행 중인 호스트에서 지원하지 않는 기능이 포함될 수 있습니다. host-exclude 구성은 이전 버전에서 숨겨야 하는 리소스를 지정합니다.

도메인 컨트롤러 구성을 마이그레이션할 때 JBoss Server 마이그레이션 도구는 소스 서버의 호스트 호스트 - 제외 구성을 대상 JBoss EAP 7.4 서버의 구성으로 추가하거나 교체합니다.

JBoss Server 마이그레이션 도구는 host-exclude 구성을 자동으로 업데이트하고 결과를 로그 파일 및 콘솔에 기록합니다.

  INFO  Host-excludes configuration added.

6.2.29. JVM 구성에서 PermGen Attributes 제거

JVM 구성에서 PermGen 속성 사용은 JBoss EAP 7에서 더 이상 사용되지 않습니다. JBoss Server 마이그레이션 도구는 모든 서버 그룹에 대한 모든 JVM 구성에서 자동으로 제거합니다.

PermGen 속성 제거를 건너뛰려면 jvms.remove-permgen-attributes.skip 환경 속성 값을 true 로 설정합니다.

6.2.30. Deployments 마이그레이션

JBoss Server 마이그레이션 도구는 다음과 같은 관리형 도메인 배포 구성을 마이그레이션할 수 있습니다.

배포 마이그레이션은 대상 서버에 관련 파일 리소스를 설치하고 마이그레이션된 구성을 업데이트하도록 구성됩니다.

JBoss Server 마이그레이션 도구는 비대화형 모드로 실행될 때 기본적으로 배포를 건너뛰도록 사전 구성됩니다. 배포 마이그레이션을 활성화하려면 deployments.migrate-deployments.skip 환경 속성을 false 로 설정합니다.

중요

대화형 모드에서 JBoss Server Migration Tool을 실행하고 유효하지 않은 입력을 입력하면 결과 동작은 배포 값에 따라 달라집니다.migrate-deployments 환경 속성.

  • deployments.migrate-deployments.skipfalse 로 설정되어 유효하지 않은 입력을 입력하면 툴에서 배포를 마이그레이션합니다.
  • deployments.migrate-deployments.skiptrue 로 설정되어 유효하지 않은 입력을 입력하면 툴에서 배포 마이그레이션을 건너뜁니다.

특정 유형의 배포를 마이그레이션할 수 있도록 하려면 다음 섹션을 참조하십시오.

주의

JBoss Server 마이그레이션 도구는 배포된 리소스가 대상 서버와 호환되는지 여부를 확인하지 않습니다. 즉, 애플리케이션 또는 리소스가 배포되지 않거나, 예상대로 작동하지 않거나, 전혀 작동하지 않을 수 있습니다. 또한 JBoss EAP 6.4 *-jms.xml 구성 파일과 같은 아티팩트는 수정 없이 복사되며 JBoss EAP 서버가 오류로 부팅될 수 있습니다.

Red Hat은 MTA(Migration Toolkit for Applications)를 사용하여 배포를 분석하여 서로 다른 JBoss EAP 서버 간의 호환성을 확인하는 것이 좋습니다. 자세한 내용은 Application Documentation for Migration Toolkit for Applications를 참조하십시오.

6.2.30.1. 영구 배포 마이그레이션

비대화형 모드에서 실행할 때 영구 배포를 마이그레이션할 수 있도록 deployment .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]

그런 다음 처리 워크플로는 아래 설명된 대로 대화형 모드에서 도구를 실행 중인지 또는 비대화형 모드에서 실행 중인지에 따라 달라집니다.

비대화형 모드에서 영구 배포 마이그레이션

비대화형 모드에서 도구를 실행하는 경우 툴은 사전 구성된 속성을 사용하여 영구 배포를 마이그레이션할지 여부를 결정합니다. 영구 배포는 deployments.migrate-deployments.skip 및 deployment.migrate- persistent-deployments.skip 속성 모두 false 로 설정된 경우에만 마이그레이션됩니다.

대화형 모드에서 영구 배포 마이그레이션

대화형 모드에서 툴을 실행하면 JBoss Server 마이그레이션 툴에서 다음 워크플로를 사용하여 각 배포에 대해 프롬프트를 표시합니다.

  1. 영구 배포를 인쇄한 후 콘솔에 대해 찾은 후 다음 프롬프트가 표시됩니다.

    This tool is not able to assert if persistent deployments found are compatible with the target server, skip persistent deployments migration?
    yes/no?
    • yes 로 응답하여 영구 배포 마이그레이션을 건너뜁니다. 마이그레이션된 구성에서 모든 배포 참조가 제거되고 마이그레이션 프로세스의 이 부분을 종료합니다.
    • 마이그레이션 진행을 위해 no 로 응답합니다.
  2. 계속을 선택하면 다음 프롬프트가 표시됩니다.

    Migrate all persistent deployments found?
    yes/no?
    • yes 로 응답하여 모든 배포를 자동으로 마이그레이션하고 마이그레이션 프로세스의 이 부분을 종료합니다.
    • 마이그레이션 진행을 위해 no 로 응답합니다.
  3. 계속하도록 선택하는 경우 참조된 각 배포에 대한 마이그레이션을 확인하라는 프롬프트가 표시됩니다.

    Migrate persistent deployment 'helloworld01.war'?
    yes/no?
    • Yes로 응답하여 배포를 마이그레이션합니다.
    • 마이그레이션된 구성에서 배포를 제거하지 않으려면 no 로 응답합니다.

      INFO  [ServerMigrationTask#68] Removed persistent deployment from configuration /deployment=helloworld01.war

6.2.30.2. Deployment Overlays 마이그레이션

배포 오버레이를 마이그레이션하는 것은 완전히 자동화된 프로세스입니다. deployments.migrate-deployments.skip 환경 속성을 false 로 설정하여 배포를 활성화한 경우, JBoss Server 마이그레이션 툴은 배포를 마이그레이션하기 위해 연결된 독립 실행형 서버 구성에서 참조하는 배포 오버레이를 검색합니다. 찾은 항목을 자동으로 마이그레이션하고, 참조되지 않는 항목을 제거하고, 결과를 로그 파일 및 콘솔에 기록합니다.

6.3. JBoss EAP 6.4 호스트 구성을 JBoss EAP 7.4로 마이그레이션

기본적으로 JBoss Server 마이그레이션 도구는 호스트 서버 구성을 JBoss EAP 6.4에서 JBoss EAP 7.4로 마이그레이션할 때 다음과 같은 작업을 수행합니다.

6.3.1. 마이그레이션 참조 모듈

소스 서버에서 대상 서버로 마이그레이션된 구성은 참조되거나 대상 서버에 설치되지 않은 모듈을 사용할 수 있습니다. JBoss Server 마이그레이션 도구는 이를 감지하고 참조된 모듈과 종속 모듈을 소스 서버에서 대상 서버로 자동으로 마이그레이션합니다.

호스트 서버 구성에서 참조하는 모듈이 다음 프로세스를 사용하여 마이그레이션됩니다.

  • 보안 영역 구성에서 참조하는 모듈이 플러그인 모듈로 마이그레이션됩니다.

콘솔은 마이그레이션된 모든 모듈의 모듈 ID를 알리는 메시지를 기록합니다. modules.excludes 환경 속성에 모듈 ID를 지정하여 특정 모듈의 마이그레이션을 제외할 수 있습니다. 자세한 내용은 모듈 마이그레이션 구성을 참조하십시오.

6.3.2. 참조 경로 마이그레이션

소스 서버에서 대상 서버로 마이그레이션된 구성이 참조되거나 대상 서버로 마이그레이션되어야 하는 파일 경로 및 디렉터리에 종속될 수 있습니다. JBoss Server 마이그레이션 도구는 절대 경로 참조를 마이그레이션하지 않습니다. 소스 구성을 기준으로 구성된 파일 또는 디렉터리만 마이그레이션합니다. 콘솔은 마이그레이션된 각 경로를 알리는 메시지를 기록합니다.

JBoss Server 마이그레이션 도구는 다음 경로 참조를 자동으로 마이그레이션합니다.

  • Vault 키 저장소 및 암호화된 파일의 디렉터리.

참조 경로의 마이그레이션을 건너뛰려면 paths.migrate-paths-requested-by-configuration.vault.skip 환경 속성을 true 로 설정합니다.

6.3.3. 코어 관리 하위 시스템 추가

JBoss EAP 7.4 core-management 하위 시스템은 관리 코어 서비스에서 이전에 구성한 관리 관련 리소스를 제공합니다. 이러한 리소스의 예로는 서버에 대한 구성 변경 내역과 서버 라이프사이클 이벤트를 모니터링할 수 있는 기능이 있습니다. JBoss Server 마이그레이션 도구는 기본 core-management 하위 시스템 구성을 마이그레이션된 구성 파일에 자동으로 추가합니다.

core-management 하위 시스템 구성 추가를 건너뛰려면 subsystem.core-management.add.skip 환경 속성을 true 로 설정합니다.

6.3.4. Elytron subsystem 추가

JBoss EAP 7.4 elytron 하위 시스템은 독립 실행형 서버와 관리형 도메인에 대한 액세스를 관리하고 구성할 수 있는 단일 통합 보안 프레임워크를 제공합니다. JBoss EAP 서버에 배포된 애플리케이션에 대한 보안 액세스를 구성하는 데도 사용할 수 있습니다. JBoss Server 마이그레이션 도구는 기본 elytron 하위 시스템 구성을 마이그레이션된 구성 파일에 자동으로 추가합니다.

elytron 하위 시스템 구성을 건너뛰려면 subsystem.elytron.add.skip 환경 속성을 true 로 설정합니다.

6.3.5. 호스트 구성에 Wildfly 하위 시스템 추가

JBoss EAP 7.4 jmx 하위 시스템은 시스템을 관리하고 모니터링하는 기능을 제공합니다. JBoss Server 마이그레이션 도구는 이 하위 시스템을 마이그레이션된 구성 파일에 자동으로 추가합니다.

jmx 하위 시스템 구성 추가를 건너뛰려면 subsystem.jmx.add.skip 환경 속성을 true 로 설정합니다.

6.3.6. 안전하지 않은 인터페이스 제거

JBoss Server 마이그레이션 도구는 JBoss EAP 7.4 기본 구성에 맞게 안전하지 않은 인터페이스 구성을 자동으로 제거합니다.

비보안 인터페이스 제거를 건너뛰려면 interface. unsecure.remove.skip 환경 속성을 true 로 설정합니다.

6.3.7. HTTP 업그레이드 관리 설정

JBoss EAP 7.4에 지원팀이 추가된 HTTP 업그레이드를 추가하여 단일 포트를 통해 여러 프로토콜을 멀티플렉싱할 수 있었습니다. 즉 관리 클라이언트는 HTTP를 통해 초기 연결을 만들 수 있지만 해당 연결을 다른 프로토콜로 업그레이드하라는 요청을 보냅니다. JBoss Server 마이그레이션 도구는 HTTP 업그레이드 관리를 지원하도록 구성을 자동으로 업데이트합니다.

HTTP 업그레이드 관리 구성을 건너뛰려면 management.setup-http-upgrade.skip 환경 속성을 true 로 설정합니다.

6.3.8. JVM 구성에서 PermGen Attributes 제거

JVM 구성에서 PermGen 속성 사용은 JBoss EAP 7에서 더 이상 사용되지 않습니다. JBoss Server 마이그레이션 도구는 모든 서버 그룹에 대한 모든 JVM 구성에서 자동으로 제거합니다.

PermGen 속성 제거를 건너뛰려면 jvms.remove-permgen-attributes.skip 환경 속성 값을 true 로 설정합니다.

6.3.9. 호환 가능한 보안 realms 마이그레이션

JBoss EAP 7.4 보안 영역 구성은 JBoss EAP 6.4 보안 영역 구성과 완전히 호환되므로 JBoss Server 마이그레이션 툴에 의해 업데이트가 필요하지 않습니다. 그러나 application-users.properties,application-roles.properties, tekton-users.properties, tekton -groups.properties 파일이 절대 경로를 사용하여 참조되지 않는 경우 툴은 마이그레이션된 구성 파일에서 예상한 경로에 파일을 복사합니다.

보안 영역 마이그레이션을 건너뛰려면 security-realms.migrate-properties.skip 환경 속성을 true 로 설정합니다.

6.3.10. ApplicationRealm에 기본 SSL 서버 ID 추가

JBoss EAP 7.4 기본 구성에는 기본 ApplicationRealm 보안 영역에 대한 SSL 서버 ID가 포함됩니다. JBoss Server 마이그레이션 도구는 마이그레이션된 구성 파일에 이 ID를 자동으로 추가합니다.

이 ID 추가를 건너뛰려면 security-realm.ApplicationRealm.add-ssl-server-identity.skip 환경 속성을 true 로 설정합니다.

7장. JBoss EAP 7.3 구성을 JBoss EAP 7.4로 마이그레이션

7.1. JBoss EAP 7.3 독립 실행형 서버를 JBoss EAP 7.4로 마이그레이션

기본적으로 JBoss Server 마이그레이션 도구는 독립 실행형 서버 구성을 JBoss EAP 7.3에서 JBoss EAP 7.4로 마이그레이션할 때 다음 작업을 수행합니다.

7.1.1. 지원되지 않는 하위 시스템 제거

JBoss Server 마이그레이션 도구는 지원되지 않는 모든 하위 시스템 구성과 마이그레이션된 서버 구성에서 확장 기능을 제거합니다. 툴은 각 하위 시스템과 확장 기능을 해당 로그 파일 및 제거 시 콘솔에 기록합니다.

참고
JBoss EAP 7.3에서 지원되지 않았지만 관리자가 해당 서버에 추가된 하위 시스템은 JBoss EAP 7.4에서도 지원되지 않으며 제거됩니다.

지원되지 않는 하위 시스템 제거를 건너뛰려면 subsystems.remove-unsupported-subsystems.skip 환경 속성을 true 로 설정합니다.

JBoss Server 마이그레이션 툴의 기본 동작을 재정의하고 다음 환경 속성을 사용하여 마이그레이션 중에 포함하거나 제외해야 하는 하위 시스템과 확장을 지정할 수 있습니다.

속성 이름속성 설명

extensions.excludes

마이그레이션해서는 안 되는 확장 프로그램의 모듈 이름(예: com.example.extension1,com.example.extension 3)입니다.

extensions.includes

항상 마이그레이션해야 하는 확장의 모듈 이름 목록입니다(예: com.example.extension2,com.example.extension4 ).

subsystems.excludes

urn:jboss:domain: logging, urn:jboss:domain:tekton3 과 같이 마이그레이션해서는 안 되는 하위 시스템 네임스페이스 목록입니다.

subsystems.includes

항상 마이그레이션해야 하는 하위 시스템 네임스페이스 목록입니다(예: urn:jboss:domain:security, urn:jboss:domain:ee ).

7.1.2. 마이그레이션 참조 모듈

소스 서버에서 대상 서버로 마이그레이션된 구성은 참조되거나 대상 서버에 설치되지 않은 모듈을 사용할 수 있습니다. JBoss Server 마이그레이션 도구는 이를 감지하고 참조된 모듈과 종속 모듈을 소스 서버에서 대상 서버로 자동으로 마이그레이션합니다.

독립 실행형 서버 구성에서 참조하는 모듈은 다음 프로세스를 사용하여 마이그레이션됩니다.

  • 보안 영역 구성에서 참조하는 모듈이 플러그인 모듈로 마이그레이션됩니다.
  • 데이터 소스 하위 시스템 구성에서 참조하는 모듈이 데이터 소스 드라이버 모듈로 마이그레이션됩니다.
  • ee 하위 시스템 구성에서 참조하는 모듈이 전역 모듈로 마이그레이션됩니다.
  • 이름 지정 하위 시스템 구성에서 참조하는 모듈이 오브젝트 팩토리 모듈로 마이그레이션됩니다.
  • 메시징 하위 시스템 구성에서 참조하는 모듈이 Jakarta Messaging 브리지 모듈로 마이그레이션됩니다.
  • 자격 증명 모음 구성에서 참조하는 모듈이 새 구성으로 마이그레이션됩니다.
  • 대상 구성에 설치되지 않은 확장 기능은 대상 서버 구성으로 마이그레이션됩니다.

콘솔은 마이그레이션된 모든 모듈의 모듈 ID를 알리는 메시지를 기록합니다. modules.excludes 환경 속성에 모듈 ID를 지정하여 특정 모듈의 마이그레이션을 제외할 수 있습니다. 자세한 내용은 모듈 마이그레이션 구성을 참조하십시오.

7.1.3. 참조 경로 마이그레이션

소스 서버에서 대상 서버로 마이그레이션된 구성이 참조되거나 대상 서버로 마이그레이션되어야 하는 파일 경로 및 디렉터리에 종속될 수 있습니다. JBoss Server 마이그레이션 도구는 절대 경로 참조를 마이그레이션하지 않습니다. 소스 구성을 기준으로 구성된 파일 또는 디렉터리만 마이그레이션합니다. 콘솔은 마이그레이션된 각 경로를 알리는 메시지를 기록합니다.

JBoss Server 마이그레이션 도구는 다음 경로 참조를 자동으로 마이그레이션합니다.

  • Vault 키 저장소 및 암호화된 파일의 디렉터리.

참조 경로의 마이그레이션을 건너뛰려면 paths.migrate-paths-requested-by-configuration.vault.skip 환경 속성을 true 로 설정합니다.

7.1.4. 상태 하위 시스템 추가

JBoss EAP 7.4 상태 하위 시스템은 서버의 상태 기능을 지원합니다. JBoss Server 마이그레이션 툴은 마이그레이션된 구성 파일에 기본 상태 하위 시스템 구성을 자동으로 추가합니다.

상태 하위 시스템 구성 추가를 건너뛰려면 subsystem.health.add.skip 환경 속성을 true 로 설정합니다.

상태 하위 시스템을 JBoss EAP 7.4에 추가한 후 웹 콘솔에 다음 메시지가 표시됩니다.

INFO  Subsystem health added.

7.1.5. 지표 하위 시스템 추가

JBoss EAP 7.4 지표 하위 시스템은 서버의 지표 기능을 지원합니다. JBoss Server 마이그레이션 도구는 마이그레이션된 구성 파일에 기본 지표 하위 시스템 구성을 자동으로 추가합니다.

지표 하위 시스템 구성 추가를 건너뛰려면 subsystem.metrics.add.skip 환경 속성을 true 로 설정합니다.

지표 하위 시스템을 JBoss EAP 7.4에 추가한 후 웹 콘솔에 다음 메시지가 표시됩니다.

INFO  Subsystem metrics added.

7.1.6. 호환 가능한 보안 realms 마이그레이션

JBoss EAP 7.4 보안 영역 구성은 JBoss EAP 7.3 보안 영역 구성과 완전히 호환되므로 JBoss Server 마이그레이션 툴에 의해 업데이트가 필요하지 않습니다. 그러나 application-users.properties,application-roles.properties, tekton-users.properties, tekton -groups.properties 파일이 절대 경로를 사용하여 참조되지 않는 경우 툴은 마이그레이션된 구성 파일에서 예상한 경로에 파일을 복사합니다.

보안 영역 마이그레이션을 건너뛰려면 security-realms.migrate-properties.skip 환경 속성을 true 로 설정합니다.

7.1.7. Deployments 마이그레이션

JBoss Server 마이그레이션 도구는 다음과 같은 유형의 독립 실행형 서버 배포 구성을 마이그레이션할 수 있습니다.

배포 마이그레이션은 대상 서버에 관련 파일 리소스를 설치하고 마이그레이션된 구성을 업데이트하도록 구성됩니다.

JBoss Server 마이그레이션 도구는 비대화형 모드로 실행될 때 기본적으로 배포를 건너뛰도록 사전 구성됩니다. 배포 마이그레이션을 활성화하려면 deployments.migrate-deployments.skip 환경 속성을 false 로 설정합니다.

중요

대화형 모드에서 JBoss Server Migration Tool을 실행하고 유효하지 않은 입력을 입력하면 결과 동작은 배포 값에 따라 달라집니다.migrate-deployments 환경 속성.

  • deployments.migrate-deployments.skipfalse 로 설정되어 유효하지 않은 입력을 입력하면 툴에서 배포를 마이그레이션합니다.
  • deployments.migrate-deployments.skiptrue 로 설정되어 유효하지 않은 입력을 입력하면 툴에서 배포 마이그레이션을 건너뜁니다.

특정 유형의 배포를 마이그레이션할 수 있도록 하려면 다음 섹션을 참조하십시오.

주의

JBoss Server 마이그레이션 도구는 배포된 리소스가 대상 서버와 호환되는지 여부를 확인하지 않습니다. 즉, 애플리케이션 또는 리소스가 배포되지 않거나, 예상대로 작동하지 않거나, 전혀 작동하지 않을 수 있습니다. 또한 JBoss EAP 7.3 *-jms.xml 구성 파일과 같은 아티팩트는 수정없이 복사되며 JBoss EAP 서버가 오류로 부팅될 수 있습니다.

Red Hat은 MTA(Migration Toolkit for Applications)를 사용하여 배포를 분석하여 서로 다른 JBoss EAP 서버 간의 호환성을 확인하는 것이 좋습니다. 자세한 내용은 Application Documentation for Migration Toolkit for Applications를 참조하십시오.

7.1.7.1. 영구 배포 마이그레이션

비대화형 모드에서 실행할 때 영구 배포를 마이그레이션할 수 있도록 deployment .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]

그런 다음 처리 워크플로는 아래 설명된 대로 대화형 모드에서 도구를 실행 중인지 또는 비대화형 모드에서 실행 중인지에 따라 달라집니다.

비대화형 모드에서 영구 배포 마이그레이션

비대화형 모드에서 도구를 실행하는 경우 툴은 사전 구성된 속성을 사용하여 영구 배포를 마이그레이션할지 여부를 결정합니다. 영구 배포는 deployments.migrate-deployments.skip 및 deployment.migrate- persistent-deployments.skip 속성 모두 false 로 설정된 경우에만 마이그레이션됩니다.

대화형 모드에서 영구 배포 마이그레이션

대화형 모드에서 툴을 실행하면 JBoss Server 마이그레이션 툴에서 다음 워크플로를 사용하여 각 배포에 대해 프롬프트를 표시합니다.

  1. 영구 배포를 인쇄한 후 콘솔에 대해 찾은 후 다음 프롬프트가 표시됩니다.

    This tool is not able to assert if persistent deployments found are compatible with the target server, skip persistent deployments migration?
    yes/no?
    • yes 로 응답하여 영구 배포 마이그레이션을 건너뜁니다. 마이그레이션된 구성에서 모든 배포 참조가 제거되고 마이그레이션 프로세스의 이 부분을 종료합니다.
    • 마이그레이션 진행을 위해 no 로 응답합니다.
  2. 계속을 선택하면 다음 프롬프트가 표시됩니다.

    Migrate all persistent deployments found?
    yes/no?
    • yes 로 응답하여 모든 배포를 자동으로 마이그레이션하고 마이그레이션 프로세스의 이 부분을 종료합니다.
    • 마이그레이션 진행을 위해 no 로 응답합니다.
  3. 계속하도록 선택하는 경우 참조된 각 배포에 대한 마이그레이션을 확인하라는 프롬프트가 표시됩니다.

    Migrate persistent deployment 'helloworld01.war'?
    yes/no?
    • Yes로 응답하여 배포를 마이그레이션합니다.
    • 마이그레이션된 구성에서 배포를 제거하지 않으려면 no 로 응답합니다.

      INFO  [ServerMigrationTask#68] Removed persistent deployment from configuration /deployment=helloworld01.war

7.1.7.2. 배포 스캐너 배포 마이그레이션

배포 스캐너는 독립 실행형 서버 구성에서만 사용되며, 새 파일의 디렉터리를 모니터링하고, 배포를 자동으로 또는 특수 배포 마커 파일을 통해 관리합니다.

비대화 모드에서 실행할 때 배포 스캐너에 의해 감시되는 디렉터리에 있는 배포를 활성화하려면 deployments.migrate-deployment-tekton-deployments.skip 환경 속성을 false 로 설정합니다.

독립 실행형 서버 구성을 마이그레이션할 때 JBoss Server 마이그레이션 툴은 먼저 구성된 모든 배포 스캐너를 검색합니다. 발견된 각 스캐너에 대해 배포된 배포가 모니터링되는 디렉터리를 검색하고 해당 결과를 콘솔에 인쇄합니다.

그런 다음 처리 워크플로는 아래 설명된 대로 대화형 모드에서 도구를 실행 중인지 또는 비대화형 모드에서 실행 중인지에 따라 달라집니다.

비대화 모드에서 배포 스캐너 배포 마이그레이션

비대화형 모드에서 도구를 실행하는 경우 툴은 사전 구성된 속성을 사용하여 배포 스캐너 배포를 마이그레이션할지 여부를 결정합니다. 배포 스캐너 배포는 deployments.migrate-deployments.skip 및deployment .migrate-deployment-deployments.skip 속성이 모두 false 로 설정된 경우에만 마이그레이션됩니다.

대화형 모드에서 배포 스캐너 배포 마이그레이션

대화형 모드에서 툴을 실행하면 JBoss Server 마이그레이션 툴에서 다음 워크플로를 사용하여 각 배포에 대해 프롬프트를 표시합니다.

  1. 배포 스캐너 배포를 인쇄하면 콘솔에 다음 프롬프트가 표시됩니다.

    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?
    • yes 로 응답하여 배포 스캐너 배포 마이그레이션을 건너뜁니다. 마이그레이션된 구성에서 모든 배포 참조가 제거되고 마이그레이션 프로세스의 이 부분을 종료합니다.
    • 마이그레이션 진행을 위해 no 로 응답합니다.
  2. 계속을 선택하면 다음 프롬프트가 표시됩니다.

    Migrate all scanner's deployments found?
    yes/no?
    • yes 로 응답하여 모든 배포를 자동으로 마이그레이션하고 마이그레이션 프로세스의 이 부분을 종료합니다.
    • 마이그레이션 진행을 위해 no 로 응답합니다.
  3. 계속하도록 선택하는 경우 참조된 각 배포에 대한 마이그레이션을 확인하라는 프롬프트가 표시됩니다.

    Migrate scanner's deployment 'helloworld02.war'?
    yes/no?
    • Yes로 응답하여 배포를 마이그레이션합니다.
    • 마이그레이션된 구성에서 배포를 제거하지 않으려면 no 로 응답합니다.

      INFO  [ServerMigrationTask#69] Resource with path EAP_HOME/standalone/deployments/helloworld02.war migrated.

7.1.7.3. Deployment Overlays 마이그레이션

배포 오버레이를 마이그레이션하는 것은 완전히 자동화된 프로세스입니다. deployments.migrate-deployments.skip 환경 속성을 false 로 설정하여 배포를 활성화한 경우, JBoss Server 마이그레이션 툴은 배포를 마이그레이션하기 위해 연결된 독립 실행형 서버 구성에서 참조하는 배포 오버레이를 검색합니다. 찾은 항목을 자동으로 마이그레이션하고, 참조되지 않는 항목을 제거하고, 결과를 로그 파일 및 콘솔에 기록합니다.

7.2. JBoss EAP 7.3 관리형 도메인을 JBoss EAP 7.4로 마이그레이션

주의

JBoss Server 마이그레이션 도구를 사용할 때 호스트를 마이그레이션하기 전에 도메인 컨트롤러를 마이그레이션하여 호스트에서 사용하는 버전과 비교할 때 도메인 컨트롤러의 최신 버전의 EAP를 사용해야 합니다. 예를 들어 EAP 7.3에서 실행되는 도메인 컨트롤러는 EAP 7.4에서 실행되는 호스트를 처리할 수 없습니다.

지원되는 구성에 대한 자세한 내용은 JBoss EAP 구성 가이드여러 JBoss EAP 버전 관리를 참조하십시오.

기본적으로 JBoss Server 마이그레이션 툴은 관리형 도메인 구성을 JBoss EAP 7.3에서 JBoss EAP 7.4로 마이그레이션할 때 다음과 같은 작업을 수행합니다.

7.2.1. 지원되지 않는 하위 시스템 제거

JBoss Server 마이그레이션 도구는 지원되지 않는 모든 하위 시스템 구성과 마이그레이션된 서버 구성에서 확장 기능을 제거합니다. 툴은 각 하위 시스템과 확장 기능을 해당 로그 파일 및 제거 시 콘솔에 기록합니다.

참고
JBoss EAP 7.3에서 지원되지 않았지만 관리자가 해당 서버에 추가된 하위 시스템은 JBoss EAP 7.4에서도 지원되지 않으며 제거됩니다.

지원되지 않는 하위 시스템 제거를 건너뛰려면 subsystems.remove-unsupported-subsystems.skip 환경 속성을 true 로 설정합니다.

JBoss Server 마이그레이션 툴의 기본 동작을 재정의하고 다음 환경 속성을 사용하여 마이그레이션 중에 포함하거나 제외해야 하는 하위 시스템과 확장을 지정할 수 있습니다.

속성 이름속성 설명

extensions.excludes

마이그레이션해서는 안 되는 확장 프로그램의 모듈 이름(예: com.example.extension1,com.example.extension 3)입니다.

extensions.includes

항상 마이그레이션해야 하는 확장의 모듈 이름 목록입니다(예: com.example.extension2,com.example.extension4 ).

subsystems.excludes

urn:jboss:domain: logging, urn:jboss:domain:tekton3 과 같이 마이그레이션해서는 안 되는 하위 시스템 네임스페이스 목록입니다.

subsystems.includes

항상 마이그레이션해야 하는 하위 시스템 네임스페이스 목록입니다(예: urn:jboss:domain:security, urn:jboss:domain:ee ).

7.2.2. 마이그레이션 참조 모듈

소스 서버에서 대상 서버로 마이그레이션된 구성은 참조되거나 대상 서버에 설치되지 않은 모듈을 사용할 수 있습니다. JBoss Server 마이그레이션 도구는 이를 감지하고 참조된 모듈과 종속 모듈을 소스 서버에서 대상 서버로 자동으로 마이그레이션합니다.

관리형 도메인 구성에서 참조하는 모듈이 다음 프로세스를 사용하여 마이그레이션됩니다.

  • 보안 영역 구성에서 참조하는 모듈이 플러그인 모듈로 마이그레이션됩니다.
  • 데이터 소스 하위 시스템 구성에서 참조하는 모듈이 데이터 소스 드라이버 모듈로 마이그레이션됩니다.
  • ee 하위 시스템 구성에서 참조하는 모듈이 전역 모듈로 마이그레이션됩니다.
  • 이름 지정 하위 시스템 구성에서 참조하는 모듈이 오브젝트 팩토리 모듈로 마이그레이션됩니다.
  • 메시징 하위 시스템 구성에서 참조하는 모듈이 Jakarta Messaging 브리지 모듈로 마이그레이션됩니다.
  • 자격 증명 모음 구성에서 참조하는 모듈이 새 구성으로 마이그레이션됩니다.
  • 대상 구성에 설치되지 않은 확장 기능은 대상 서버 구성으로 마이그레이션됩니다.

콘솔은 마이그레이션된 모든 모듈의 모듈 ID를 알리는 메시지를 기록합니다. modules.excludes 환경 속성에 모듈 ID를 지정하여 특정 모듈의 마이그레이션을 제외할 수 있습니다. 자세한 내용은 모듈 마이그레이션 구성을 참조하십시오.

7.2.3. 참조 경로 마이그레이션

소스 서버에서 대상 서버로 마이그레이션된 구성이 참조되거나 대상 서버로 마이그레이션되어야 하는 파일 경로 및 디렉터리에 종속될 수 있습니다. JBoss Server 마이그레이션 도구는 절대 경로 참조를 마이그레이션하지 않습니다. 소스 구성을 기준으로 구성된 파일 또는 디렉터리만 마이그레이션합니다. 콘솔은 마이그레이션된 각 경로를 알리는 메시지를 기록합니다.

JBoss Server 마이그레이션 도구는 다음 경로 참조를 자동으로 마이그레이션합니다.

  • Vault 키 저장소 및 암호화된 파일의 디렉터리.

참조 경로의 마이그레이션을 건너뛰려면 paths.migrate-paths-requested-by-configuration.vault.skip 환경 속성을 true 로 설정합니다.

7.2.4. 호스트 제외 추가

JBoss EAP 7.4 도메인 컨트롤러에는 이전 버전의 서버에서 실행 중인 호스트에서 지원하지 않는 기능이 포함될 수 있습니다. host-exclude 구성은 이전 버전에서 숨겨야 하는 리소스를 지정합니다.

도메인 컨트롤러 구성을 마이그레이션할 때 JBoss Server 마이그레이션 도구는 소스 서버의 호스트 호스트 - 제외 구성을 대상 JBoss EAP 7.4 서버의 구성으로 추가하거나 교체합니다.

JBoss Server 마이그레이션 도구는 host-exclude 구성을 자동으로 업데이트하고 결과를 로그 파일 및 콘솔에 기록합니다.

  INFO  Host-excludes configuration added.

7.2.5. Deployments 마이그레이션

JBoss Server 마이그레이션 도구는 다음과 같은 관리형 도메인 배포 구성을 마이그레이션할 수 있습니다.

배포 마이그레이션은 대상 서버에 관련 파일 리소스를 설치하고 마이그레이션된 구성을 업데이트하도록 구성됩니다.

JBoss Server 마이그레이션 도구는 비대화형 모드로 실행될 때 기본적으로 배포를 건너뛰도록 사전 구성됩니다. 배포 마이그레이션을 활성화하려면 deployments.migrate-deployments.skip 환경 속성을 false 로 설정합니다.

중요

대화형 모드에서 JBoss Server Migration Tool을 실행하고 유효하지 않은 입력을 입력하면 결과 동작은 배포 값에 따라 달라집니다.migrate-deployments 환경 속성.

  • deployments.migrate-deployments.skipfalse 로 설정되어 유효하지 않은 입력을 입력하면 툴에서 배포를 마이그레이션합니다.
  • deployments.migrate-deployments.skiptrue 로 설정되어 유효하지 않은 입력을 입력하면 툴에서 배포 마이그레이션을 건너뜁니다.

특정 유형의 배포를 마이그레이션할 수 있도록 하려면 다음 섹션을 참조하십시오.

주의

JBoss Server 마이그레이션 도구는 배포된 리소스가 대상 서버와 호환되는지 여부를 확인하지 않습니다. 즉, 애플리케이션 또는 리소스가 배포되지 않거나, 예상대로 작동하지 않거나, 전혀 작동하지 않을 수 있습니다. 또한 JBoss EAP 7.3 *-jms.xml 구성 파일과 같은 아티팩트는 수정없이 복사되며 JBoss EAP 서버가 오류로 부팅될 수 있습니다.

Red Hat은 MTA(Migration Toolkit for Applications)를 사용하여 배포를 분석하여 서로 다른 JBoss EAP 서버 간의 호환성을 확인하는 것이 좋습니다. 자세한 내용은 Application Documentation for Migration Toolkit for Applications를 참조하십시오.

7.2.5.1. 영구 배포 마이그레이션

비대화형 모드에서 실행할 때 영구 배포를 마이그레이션할 수 있도록 deployment .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]

그런 다음 처리 워크플로는 아래 설명된 대로 대화형 모드에서 도구를 실행 중인지 또는 비대화형 모드에서 실행 중인지에 따라 달라집니다.

비대화형 모드에서 영구 배포 마이그레이션

비대화형 모드에서 도구를 실행하는 경우 툴은 사전 구성된 속성을 사용하여 영구 배포를 마이그레이션할지 여부를 결정합니다. 영구 배포는 deployments.migrate-deployments.skip 및 deployment.migrate- persistent-deployments.skip 속성 모두 false 로 설정된 경우에만 마이그레이션됩니다.

대화형 모드에서 영구 배포 마이그레이션

대화형 모드에서 툴을 실행하면 JBoss Server 마이그레이션 툴에서 다음 워크플로를 사용하여 각 배포에 대해 프롬프트를 표시합니다.

  1. 영구 배포를 인쇄한 후 콘솔에 대해 찾은 후 다음 프롬프트가 표시됩니다.

    This tool is not able to assert if persistent deployments found are compatible with the target server, skip persistent deployments migration?
    yes/no?
    • yes 로 응답하여 영구 배포 마이그레이션을 건너뜁니다. 마이그레이션된 구성에서 모든 배포 참조가 제거되고 마이그레이션 프로세스의 이 부분을 종료합니다.
    • 마이그레이션 진행을 위해 no 로 응답합니다.
  2. 계속을 선택하면 다음 프롬프트가 표시됩니다.

    Migrate all persistent deployments found?
    yes/no?
    • yes 로 응답하여 모든 배포를 자동으로 마이그레이션하고 마이그레이션 프로세스의 이 부분을 종료합니다.
    • 마이그레이션 진행을 위해 no 로 응답합니다.
  3. 계속하도록 선택하는 경우 참조된 각 배포에 대한 마이그레이션을 확인하라는 프롬프트가 표시됩니다.

    Migrate persistent deployment 'helloworld01.war'?
    yes/no?
    • Yes로 응답하여 배포를 마이그레이션합니다.
    • 마이그레이션된 구성에서 배포를 제거하지 않으려면 no 로 응답합니다.

      INFO  [ServerMigrationTask#68] Removed persistent deployment from configuration /deployment=helloworld01.war

7.2.5.2. Deployment Overlays 마이그레이션

배포 오버레이를 마이그레이션하는 것은 완전히 자동화된 프로세스입니다. deployments.migrate-deployments.skip 환경 속성을 false 로 설정하여 배포를 활성화한 경우, JBoss Server 마이그레이션 툴은 배포를 마이그레이션하기 위해 연결된 독립 실행형 서버 구성에서 참조하는 배포 오버레이를 검색합니다. 찾은 항목을 자동으로 마이그레이션하고, 참조되지 않는 항목을 제거하고, 결과를 로그 파일 및 콘솔에 기록합니다.

7.3. JBoss EAP 7.3 호스트 구성을 JBoss EAP 7.4로 마이그레이션

기본적으로 JBoss Server 마이그레이션 도구는 호스트 서버 구성을 JBoss EAP 6.4에서 JBoss EAP 7.4로 마이그레이션할 때 다음과 같은 작업을 수행합니다.

7.3.1. 마이그레이션 참조 모듈

소스 서버에서 대상 서버로 마이그레이션된 구성은 참조되거나 대상 서버에 설치되지 않은 모듈을 사용할 수 있습니다. JBoss Server 마이그레이션 도구는 이를 감지하고 참조된 모듈과 종속 모듈을 소스 서버에서 대상 서버로 자동으로 마이그레이션합니다.

호스트 서버 구성에서 참조하는 모듈이 다음 프로세스를 사용하여 마이그레이션됩니다.

  • 보안 영역 구성에서 참조하는 모듈이 플러그인 모듈로 마이그레이션됩니다.

콘솔은 마이그레이션된 모든 모듈의 모듈 ID를 알리는 메시지를 기록합니다. modules.excludes 환경 속성에 모듈 ID를 지정하여 특정 모듈의 마이그레이션을 제외할 수 있습니다. 자세한 내용은 모듈 마이그레이션 구성을 참조하십시오.

7.3.2. 참조 경로 마이그레이션

소스 서버에서 대상 서버로 마이그레이션된 구성이 참조되거나 대상 서버로 마이그레이션되어야 하는 파일 경로 및 디렉터리에 종속될 수 있습니다. JBoss Server 마이그레이션 도구는 절대 경로 참조를 마이그레이션하지 않습니다. 소스 구성을 기준으로 구성된 파일 또는 디렉터리만 마이그레이션합니다. 콘솔은 마이그레이션된 각 경로를 알리는 메시지를 기록합니다.

JBoss Server 마이그레이션 도구는 다음 경로 참조를 자동으로 마이그레이션합니다.

  • Vault 키 저장소 및 암호화된 파일의 디렉터리.

참조 경로의 마이그레이션을 건너뛰려면 paths.migrate-paths-requested-by-configuration.vault.skip 환경 속성을 true 로 설정합니다.

7.3.3. 호환 가능한 보안 realms 마이그레이션

JBoss EAP 7.4 보안 영역 구성은 JBoss EAP 7.3 보안 영역 구성과 완전히 호환되므로 JBoss Server 마이그레이션 툴에 의해 업데이트가 필요하지 않습니다. 그러나 application-users.properties,application-roles.properties, tekton-users.properties, tekton -groups.properties 파일이 절대 경로를 사용하여 참조되지 않는 경우 툴은 마이그레이션된 구성 파일에서 예상한 경로에 파일을 복사합니다.

보안 영역 마이그레이션을 건너뛰려면 security-realms.migrate-properties.skip 환경 속성을 true 로 설정합니다.

부록 A. 참고 material

A.1. 작업 요약 보고서 예

다음은 작업 요약 보고서의 예입니다.

-------------
 Task Summary
-------------

 server ............................................................................................................ SUCCESS
  standalone ....................................................................................................... SUCCESS
   standalone-configurations ....................................................................................... SUCCESS
    standalone-configuration(source=/home/username/jboss-eap-6.4/standalone/configuration/standalone-full-ha.xml) .. SUCCESS
    standalone-configuration(source=/home/username/jboss-eap-6.4/standalone/configuration/standalone-full.xml) ..... SUCCESS
    standalone-configuration(source=/home/username/jboss-eap-6.4/standalone/configuration/standalone-ha.xml) ....... SUCCESS
    standalone-configuration(source=/home/username/jboss-eap-6.4/standalone/configuration/standalone-osgi.xml) ..... SUCCESS
    standalone-configuration(source=/home/username/jboss-eap-6.4/standalone/configuration/standalone.xml) .......... SUCCESS
  domain ........................................................................................................... SUCCESS
   domain-configurations ........................................................................................... SUCCESS
    domain-configuration(source=/home/username/jboss-eap-6.4/domain/configuration/domain.xml) ...................... SUCCESS
   host-configurations ............................................................................................. SUCCESS
    host-configuration(source=/home/username/jboss-eap-6.4/domain/configuration/host-master.xml) ................... SUCCESS
    host-configuration(source=/home/username/jboss-eap-6.4/domain/configuration/host-slave.xml) .................... SUCCESS
    host-configuration(source=/home/username/jboss-eap-6.4/domain/configuration/host.xml) .......................... SUCCESS

--------------------------
 Migration Result: SUCCESS
--------------------------

A.2. HTML Report의 예

다음은 JBoss Server 마이그레이션 HTML 보고서의 예입니다.

그림 A.1. 예: 섹션 개요

HTML Report의 예

그림 A.2. 예: 작업 세부 정보 페이지

HTML Report의 예

A.3. XML Report의 예

다음은 JBoss Server 마이그레이션 XML 보고서의 예입니다.

<?xml version="1.0" ?>

<server-migration-report xmlns="urn:jboss:server-migration:1.0" start-time="Mon, 30 Oct 2017 16:13:30 UTC">
  <servers>
    <source name="EAP" version="6.4.0.GA" base-dir="/home/username/tools/jboss-eap-6.4"/>
    <target name="JBoss EAP" version="7.1.0.GA" base-dir="/home/username/tools/jboss-eap-7.1"/>
  </servers>
  <environment>
    <property name="baseDir" value="/home/username/tools/jboss-eap-7.1/migration"/>
    <property name="deployments.migrate-deployment-scanner-deployments.processedDeploymentScannerDirs" value="/home/username/tools/jboss-eap-6.4/standalone/deployments"/>
    <property name="report.html.fileName" value="migration-report.html"/>
    <property name="report.html.maxTaskPathSizeToDisplaySubtasks" value="4"/>
    <property name="report.html.templateFileName" value="migration-report-template.html"/>
    <property name="report.summary.maxTaskPathSizeToDisplaySubtasks" value="3"/>
    <property name="report.xml.fileName" value="migration-report.xml"/>
    <property name="subsystem.ee.update.setup-javaee7-default-bindings.defaultDataSourceName" value="ExampleDS"/>
    <property name="subsystem.ee.update.setup-javaee7-default-bindings.defaultJmsConnectionFactoryName" value="hornetq-ra"/>
    <property name="subsystem.logging.update.remove-console-handler.skip" value="true"/>
  </environment>
  <task number="1" name="server">
    <logger logger="org.jboss.migration.core.task.ServerMigrationTask#1"/>
    <result status="SUCCESS"/>
    <subtasks>
      <task number="2" name="modules.migrate-modules-requested-by-user">
        <logger logger="org.jboss.migration.core.task.ServerMigrationTask#2"/>
        <result status="SKIPPED"/>
      </task>
      <task number="3" name="standalone">
        <logger logger="org.jboss.migration.core.task.ServerMigrationTask#3"/>
        <result status="SUCCESS"/>
        <subtasks>
          <task number="4" name="contents.standalone.migrate-content-dir">
            <logger logger="org.jboss.migration.core.task.ServerMigrationTask#4"/>
            <result status="SKIPPED"/>
          </task>
          <task number="5" name="standalone-configurations">
            <logger logger="org.jboss.migration.core.task.ServerMigrationTask#5"/>
            <result status="SUCCESS"/>
            <subtasks>
              <task number="6" name="standalone-configuration(source=/home/username/tools/jboss-eap-6.4/standalone/configuration/standalone-full-ha.xml)">
                <logger logger="org.jboss.migration.core.task.ServerMigrationTask#6"/>
                <result status="SUCCESS"/>
                <subtasks>
                  <task number="7" name="subsystems.remove-unsupported-subsystems">
                    <logger logger="org.jboss.migration.core.task.ServerMigrationTask#7"/>
                    <result status="SUCCESS"/>
                    <subtasks>
                      <task number="8" name="subsystems.remove-unsupported-subsystems.remove-unsupported-extension(module=org.jboss.as.cmp)">
                        <logger logger="org.jboss.migration.core.task.ServerMigrationTask#8"/>
                        <result status="SUCCESS"/>
                      </task>
                    </substasks>
                  </task>
                  ...
                  <task number="644" name="hosts">
                    <logger logger="org.jboss.migration.core.task.ServerMigrationTask#644"/>
                    <result status="SUCCESS"/>
                    ...
                    <subtasks>
                      ...
                      <task number="645" name="host(name=master)">
                        <logger logger="org.jboss.migration.core.task.ServerMigrationTask#645"/>
                        <result status="SUCCESS"/>
                        <subtasks>
                          ...
                          <task number="661" name="security-realms.migrate-properties">
                            <logger logger="org.jboss.migration.core.task.ServerMigrationTask#661"/>
                            <result status="SUCCESS"/>
                            <subtasks>
                              <task number="662" name="security-realm.ManagementRealm.migrate-properties">
                                <logger logger="org.jboss.migration.core.task.ServerMigrationTask#662"/>
                                <result status="SUCCESS"/>
                              </task>
                              <task number="663" name="security-realm.ApplicationRealm.migrate-properties">
                                <logger logger="org.jboss.migration.core.task.ServerMigrationTask#663"/>
                                <result status="SUCCESS"/>
                              </task>
                            </subtasks>
                          </task>
                          <task number="664" name="security-realm.ApplicationRealm.add-ssl-server-identity">
                            <logger logger="org.jboss.migration.core.task.ServerMigrationTask#664"/>
                            <result status="SUCCESS"/>
                          </task>
                        </subtasks>
                      </task>
                    </subtasks>
                  </task>
                </subtasks>
              </task>
            </subtasks>
          </task>
        </subtasks>
      </task>
    </subtasks>
  </task>
</server-migration-report>





2024-02-08에 최종 업데이트된 문서

법적 공지

Copyright © 2024 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.