2장. JBoss EAP 패치

JBoss EAP에 패치를 적용하도록 선택하는 방법은 설치 방법에 따라 다릅니다. 아카이브 또는 설치 프로그램 방법을 사용하여 JBoss EAP를 설치한 경우 패치 관리 .zip 파일을 사용해야 합니다. RPM을 사용하여 Red Hat Enterprise Linux에 JBoss EAP를 설치하는 경우 RPM 패치를 사용해야 합니다.

중요

패치를 적용하거나 롤백하기 전에 모든 배포 및 구성 파일을 포함하여 JBoss EAP 서버를 백업합니다.

로컬로 설치된 JBoss EAP Maven 리포지토리가 있는 경우 Maven 리포지토리를 JBoss EAP 서버와 동일한 누적 패치 버전으로 패치해야 합니다.

2.1. 아카이브 또는 설치 프로그램 설치 패치

Red Hat Customer Portal 에서 JBoss EAP의 아카이브 또는 설치 프로그램 설치에 대한 누적 패치를 다운로드할 수 있습니다. 관리형 도메인 환경에 여러 JBoss EAP 호스트가 있는 경우 JBoss EAP 도메인 컨트롤러에서 개별 호스트를 패치할 수 있습니다.

아카이브 또는 설치 프로그램 설치 패치에 대한 중요 정보

아카이브 또는 설치 프로그램을 패치하기 전에 다음을 기록해야 합니다.

  • 모듈을 업데이트하는 패치를 적용하면 런타임에 사용된 패치된 새로운 JAR이 EAP_HOME/modules/system/layers/base/.overlays/PATCH_ID/MODULE 에 저장됩니다. 패치되지 않은 원본 파일은 EAP_HOME/modules/system/layers/base/MODULE 에 남아 있으며 런타임 시 사용되지 않습니다.
  • JBoss EAP 7의 누적 패치 릴리스 크기를 크게 줄이려면 먼저 누적 패치 업데이트에 문제가 없는지 확인한 다음 이 CLI 명령 /core-service=patching:ageout-history() 를 실행해야 합니다. 이렇게 하면 최신 및 원래 기본 릴리스를 제외한 모든 누적 패치 오버레이가 제거됩니다.

    예를 들어 JBoss EAP 7.0.0이 있고 CP01을 적용한 경우 나중에 CP02를 적용합니다. /core-service=patching:ageout-history() 를 실행하면 CP01로 롤백할 수 없습니다. CP02를 롤백한다는 것은 JBoss EAP 7.0.0으로 롤백해야 합니다. CP01을 다운로드하여 다시 적용해야 합니다.

    참고
    • 패치는 RPM이 아닌 아카이브 설치에서만 작동합니다.
    • 중간 누적 패치를 적용할 필요가 없습니다. 예를 들어, JBoss EAP 7.0.0이 있는 경우 CP01-CP04를 적용하지 않고 CP05를 적용할 수 있습니다.
    • 이전에 설치한 경우에만 이전 누적 패치로 롤백할 수 있습니다.

2.1.1. 관리 CLI를 사용하여 JBoss EAP 패치

관리 CLI를 사용하여 JBoss EAP에 패치를 적용할 수 있습니다.

참고

이러한 지침을 사용하여 RPM 방법을 사용하여 설치한 JBoss EAP 서버를 업데이트할 수 없습니다. 대신 패치 적용에 대한 RPM 지침을 참조하십시오.

절차

  1. Red Hat 고객 포털에 로그인하고 JBoss EAP 소프트웨어 다운로드에서 패치 파일을 다운로드 합니다.
  2. 패치 파일에 대한 적절한 경로를 포함하여 관리 CLI 의 다음 명령을 사용하여 패치를 적용합니다.

    patch apply /path/to/downloaded-patch.zip
    참고

    관리형 도메인에서 JBoss EAP 호스트를 패치하기 위해 --host= 인수를 사용하여 JBoss EAP 호스트 이름을 지정할 수 있습니다. 예를 들면 다음과 같습니다.

    patch apply /path/to/downloaded-patch.zip --host=my-host

    패치를 적용하려고 할 때 충돌이 발생하면 패치 툴에 경고 메시지가 표시됩니다. 충돌이 있는 경우 패치 충돌을 해결하기 위해 사용 가능한 인수에 대해 patch --help를 입력합니다.

  3. 패치가 적용되도록 JBoss EAP 서버를 다시 시작하십시오.

    shutdown --restart=true

검증

  • 관리 CLI를 열고 패치 정보를 실행하여 패치 가 적용되었는지 확인할 수 있습니다.

    예상 출력:

    Version:             <PATCH_VERSION_NUMBER>.GA
    Cumulative patch ID: jboss-eap-<PATCH VERSION NUMBER>.CP
    One-off patches:     none

    새로 적용된 패치의 버전 및 누적 패치 ID가 표시됩니다.

2.1.2. 관리 콘솔을 사용하여 JBoss EAP 패치

관리 콘솔을 사용하여 JBoss EAP에 패치를 적용할 수 있습니다.

참고

이러한 지침을 사용하여 RPM 방법을 사용하여 설치한 JBoss EAP 서버를 업데이트할 수 없습니다. 대신 패치 적용에 대한 RPM 지침을 참조하십시오.

절차

  1. Red Hat 고객 포털에 로그인하고 JBoss EAP 소프트웨어 다운로드에서 패치 파일을 다운로드 합니다.
  2. 관리 콘솔을 열고 패치 탭으로 이동합니다.
  3. 패치 추가 마법사를 사용하여 패치를 추가합니다.

    • 독립 실행형 서버의 경우 다음을 수행합니다.

      1. Add (+)(추가(+)) 버튼을 클릭합니다.
      2. Choose a file(파일 선택)을 클릭하거나 여기에 끌어서 적용할 다운로드 패치를 선택한 다음 Next (다음)를 클릭합니다.
      3. 추가 옵션 중 하나를 구성하고 Finish (완료)를 클릭합니다.
    • 관리형 도메인의 경우:

      1. 패치할 호스트를 선택하고 Add (+)(추가(+)) 버튼을 클릭합니다.
      2. 호스트에서 서버를 종료할지 여부를 선택하고 Next (다음)를 클릭합니다.
      3. Choose a file(파일 선택)을 클릭하거나 여기에 끌어서 적용할 다운로드 패치를 선택한 다음 Next (다음)를 클릭합니다.
      4. 추가 옵션 중 하나를 구성하고 Finish (완료)를 클릭합니다.
    • 패치가 성공적으로 적용된 경우 서버를 다시 시작하여 변경 사항을 적용합니다.
    • 패치 애플리케이션에 실패하면 오류 메시지를 검토합니다. 충돌이 있는 경우 패치 추가 마법사의 Override All, Override Modules, Override All, Override Modules 및 Override 필드를 사용하여 패치가 변경되는 항목에 대한 콘텐츠 확인을 바이패스할 수 있습니다. 충돌을 재정의하면 패치 콘텐츠가 수정 사항을 덮어씁니다.

검증

  • 패치를 성공적으로 적용했는지 확인하려면 콘솔을 열어 누적 패치를 적용합니다. 성공적으로 설치된 경우 관리 콘솔의 패치 탭에 나열되어야 합니다. 독립 실행형 도메인 서버와 관리형 도메인 서버 모두에 대해 동일합니다.

2.1.3. 이전에 적용된 패치로 롤백

관리 CLI 또는 관리 콘솔 을 사용하여 이전에 적용된 JBoss EAP 패치를 롤백할 수 있습니다.

중요

패치 관리 시스템을 사용하여 패치를 롤백하는 것은 일반적인 설치 제거 기능으로 되어 있지 않습니다. 이는 바람직하지 않은 패치를 적용한 직후에만 사용하기 위한 것입니다.

주의

패치를 롤백할 때 설정 재설정 옵션에 올바른 값을 지정해야 합니다. 패치를 롤백하기 전에 다음 두 값 중 하나를 설정해야 합니다.

  • TRUE 로 설정하면 패치 롤백 프로세스가 JBoss EAP 서버 구성 파일을 미리 패치된 상태로 롤백합니다. 패치를 적용한 후 JBoss EAP 서버 구성 파일에 적용된 모든 변경 사항을 복구할 수 없습니다.
  • false 로 설정하면 서버 구성 파일을 롤백할 수 없습니다. 이 경우 패치에서 수동으로 수정할 수 있는 네임스페이스와 같은 구성을 변경할 수 있으므로 롤백 후 서버가 시작되지 않을 수 있습니다.

2.1.4. 관리 CLI를 사용하여 패치 롤백

관리 CLI를 사용하여 JBoss EAP에서 패치를 롤백할 수 있습니다.

절차

  1. 관리 CLI에서 패치 기록 명령을 사용하여 롤백할 패치 ID를 찾습니다.

    참고

    관리형 도메인을 사용하는 경우 JBoss EAP 호스트를 지정하려면 --host=HOSTNAME 인수를 명령에 추가해야 합니다.

  2. 이전 단계의 적절한 패치 ID로 패치를 롤백합니다.

    patch rollback --patch-id=PATCH_ID --reset-configuration=TRUE

    패치를 롤백하려고 할 때 충돌이 있는 경우 패치 툴에 경고합니다. 충돌이 있는 경우 사용 가능한 인수에 대해 patch --help 를 입력하고 충돌을 해결하는 방법을 지정하는 인수를 사용하여 명령을 다시 실행합니다.

  3. 패치 롤백을 위해 JBoss EAP 서버를 다시 시작하여 적용됩니다.

    shutdown --restart=true

검증

  1. 패치가 성공적으로 관리 CLI를 열고 패치 정보를 실행 했는지 확인할 수 있습니다. 이로 인해 이전에 적용된 패치 의 버전 및 누적 패치 ID가 표시됩니다.

2.1.5. 관리 콘솔을 사용하여 패치 롤백

관리 콘솔을 사용하여 JBoss EAP에서 패치를 롤백할 수 있습니다.

절차

  1. 관리 콘솔을 열고 패치 탭으로 이동합니다.
  2. 롤백 마법사를 사용하여 패치를 롤백 합니다.

    • 독립 실행형 서버의 경우 다음을 수행합니다.

      1. 롤백할 패치를 선택하고 롤백 을 클릭합니다.
      2. 추가 옵션 중 하나를 구성하고 Finish (완료)를 클릭합니다.
    • 관리형 도메인의 경우:

      1. 호스트를 선택하고 롤백할 패치를 선택한 다음 롤백 을 클릭합니다.
      2. 호스트에서 서버를 종료할지 여부를 선택하고 Next (다음)를 클릭합니다.
      3. 추가 옵션 중 하나를 구성하고 Finish (완료)를 클릭합니다.
    • 패치가 롤백된 경우 서버를 다시 시작하여 변경 사항을 적용합니다.
    • 패치 롤백에 실패한 경우 오류 메시지를 검토합니다. 충돌이 있는 경우 마법사의 Override All(재정의 모두), Override Modules (재정의 모듈) 및 Override(재정의) 필드를 사용하여 패치의 영향을 받는 항목에 대한 콘텐츠 확인을 바이패스할 수 있습니다.

검증

  • 패치를 성공적으로 롤백했는지 확인하려면 관리 콘솔을 열고 패치 탭으로 이동합니다. 왼쪽에서 이전에 적용된 패치 버전을 볼 수 있습니다. 독립 실행형 도메인 서버와 관리형 도메인 서버 모두에 대해 동일합니다.