Red Hat Summit Red Hat Summit지원콘솔개발자평가판 시작연락처

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
Copy to Clipboard Toggle word wrap

속성의 이름이 성공적으로 변경되면 다음 메시지가 표시됩니다. 

  INFO JBoss domain properties migrated.
Copy to Clipboard Toggle word wrap

7.1.2. 지원되지 않는 하위 시스템 제거
링크 복사

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

참고

JBoss EAP 7.x에서 지원되지 않았지만 관리자가 해당 서버에 추가한 하위 시스템은 JBoss EAP 8.0에서 지원되지 않으며 제거됩니다.

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

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

Expand
표 7.1. 서버 마이그레이션 환경 속성
속성 이름속성 설명

extensions.excludes

마이그레이션해서는 안 되는 확장 모듈 이름 목록입니다(예: com.example.extension1,com.example.extension3 ).

extensions.includes

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

subsystems.excludes

버전이 제거된 하위 시스템 네임스페이스 목록입니다(예: urn:jboss:domain:logging,urn:jboss:domain: Cryostat3 ).

subsystems.includes

버전이 제거되는 하위 시스템 네임스페이스 목록입니다(예: urn:jboss:domain:security,urn:jboss:domain:ee ).

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.
Copy to Clipboard Toggle word wrap

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!
Copy to Clipboard Toggle word wrap

7.1.7. keycloak 하위 시스템 마이그레이션
링크 복사

keycloak 하위 시스템은 JBoss EAP 8에서 지원되지 않으며 elytron-oidc-client 하위 시스템으로 교체됩니다.

기본적으로 JBoss Server 마이그레이션 도구는 레거시 하위 시스템 구성을 자동으로 마이그레이션합니다. 이 마이그레이션 작업을 건너뛰려면 subsystem.keycloak.migrate.skip 환경 속성 값을 true 로 설정합니다.

레거시 하위 시스템 마이그레이션은 사용자의 상호 작용 없이 수행됩니다.

레거시 keycloak 하위 시스템 마이그레이션이 완료되면 마이그레이션 콘솔에 다음 메시지가 표시됩니다. 

INFO  Subsystem keycloak migrated.
Copy to Clipboard Toggle word wrap

마이그레이션 중에 발생한 문제는 로그 파일에 기록되고 마이그레이션 콘솔에 표시됩니다.

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!
Copy to Clipboard Toggle word wrap

7.1.10. 독립 실행형 서버에 대한 상태 하위 시스템 추가
링크 복사

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

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

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

INFO  Subsystem health added.
Copy to Clipboard Toggle word wrap

7.1.11. 독립 실행형 서버에 대한 지표 하위 시스템 추가
링크 복사

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

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

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

INFO  Subsystem metrics added.
Copy to Clipboard Toggle word wrap

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]
Copy to Clipboard Toggle word wrap

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

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

비대화형 모드로 툴을 실행하는 경우 툴은 사전 구성된 속성을 사용하여 영구 배포를 마이그레이션할지 여부를 결정합니다. 영구 배포는 deployments.migrate-deployments.skip 및 deployments.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?
    Copy to Clipboard Toggle word wrap
    • yes 로 응답하여 영구 배포 마이그레이션을 건너뜁니다. 모든 배포 참조는 마이그레이션된 구성에서 제거되고 마이그레이션 프로세스의 이 부분을 종료합니다.
    • 마이그레이션을 계속하려면 no 와 함께 응답합니다.

  2. 계속하도록 선택하면 다음 프롬프트가 표시됩니다. 

    Migrate all persistent deployments found?
yes/no?
    Copy to Clipboard Toggle word wrap
    • yes 로 응답하여 모든 배포를 자동으로 마이그레이션하고 마이그레이션 프로세스의 이 부분을 종료합니다.
    • 마이그레이션을 계속하려면 no 와 함께 응답합니다.

  3. 계속하도록 선택하면 참조된 각 배포에 대한 마이그레이션을 확인하라는 메시지가 표시됩니다. 

    Migrate persistent deployment 'helloworld01.war'?
yes/no?
    Copy to Clipboard Toggle word wrap
    • yes 로 응답하여 배포를 마이그레이션합니다.

    • no 로 응답하여 마이그레이션된 구성에서 배포를 제거합니다. 

      INFO  [ServerMigrationTask#68] Removed persistent deployment from configuration /deployment=helloworld01.war
      Copy to Clipboard Toggle word wrap

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 마이그레이션 툴에서 다음 워크플로를 사용하여 각 배포에 대한 메시지를 표시합니다.

  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?
    Copy to Clipboard Toggle word wrap
    • yes 로 응답하여 배포 스캐너 배포 마이그레이션을 건너뜁니다. 모든 배포 참조는 마이그레이션된 구성에서 제거되고 마이그레이션 프로세스의 이 부분을 종료합니다.
    • 마이그레이션을 계속하려면 no 와 함께 응답합니다.

  2. 계속하도록 선택하면 다음 프롬프트가 표시됩니다. 

    Migrate all scanner's deployments found?
yes/no?
    Copy to Clipboard Toggle word wrap
    • yes 로 응답하여 모든 배포를 자동으로 마이그레이션하고 마이그레이션 프로세스의 이 부분을 종료합니다.
    • 마이그레이션을 계속하려면 no 와 함께 응답합니다.

  3. 계속하도록 선택하면 참조된 각 배포에 대한 마이그레이션을 확인하라는 메시지가 표시됩니다. 

    Migrate scanner's deployment 'helloworld02.war'?
yes/no?
    Copy to Clipboard Toggle word wrap
    • yes 로 응답하여 배포를 마이그레이션합니다.

    • no 로 응답하여 마이그레이션된 구성에서 배포를 제거합니다. 

      INFO  [ServerMigrationTask#69] Resource with path EAP_NEW_HOME/standalone/deployments/helloworld02.war migrated.
      Copy to Clipboard Toggle word wrap

7.1.12.3. 독립 실행형 서버의 배포 오버레이 마이그레이션
링크 복사

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

Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

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

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

Theme

© 2026 Red Hat맨 위로 이동