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

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

Expand
속성 이름속성 설명

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.skip 가 false 로 설정되어 유효하지 않은 입력을 입력하면 툴에서 배포를 마이그레이션합니다.
  • deployments.migrate-deployments.skip 가 true 로 설정되어 유효하지 않은 입력을 입력하면 툴에서 배포 마이그레이션을 건너뜁니다.

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

주의

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 마이그레이션 툴은 배포를 마이그레이션하기 위해 연결된 독립 실행형 서버 구성에서 참조하는 배포 오버레이를 검색합니다. 찾은 항목을 자동으로 마이그레이션하고, 참조되지 않는 항목을 제거하고, 결과를 로그 파일 및 콘솔에 기록합니다.

Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 소개

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

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

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

Red Hat 문서 정보

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

Legal Notice

Theme

© 2026 Red Hat맨 위로 이동