2.2. 이전 7.x 버전 업그레이드


2.2.1. 브로커 인스턴스를 7.0.x에서 7.0.y로 업그레이드

AMQ Broker를 한 버전의 7.0에서 다른 버전으로 업그레이드하는 절차는 설치와 유사합니다. 고객 포털에서 아카이브를 다운로드한 후 압축을 풉니다.

다음 하위 섹션에서는 다른 운영 체제를 위해 7.0.x 브로커를 업그레이드하는 방법을 설명합니다.

2.2.1.1. Linux에서 7.0.x에서 7.0.y로 업그레이드

다운로드한 아카이브의 이름은 다음 예제에서 사용되는 것과 다를 수 있습니다.

사전 요구 사항

  • AMQ Broker를 업그레이드하기 전에 대상 릴리스의 릴리스 노트를 검토하십시오.

    릴리스 노트에서는 대상 릴리스의 중요한 개선 사항, 알려진 문제 및 동작 변경 사항에 대해 설명합니다.

    자세한 내용은 AMQ Broker 7.0 릴리스 노트 를 참조하십시오.

프로세스

  1. AMQ Broker 아카이브 다운로드에 제공된 지침에 따라 Red Hat 고객 포털에서 원하는 아카이브를 다운로드합니다.
  2. 아카이브의 소유자를 AMQ Broker 설치를 소유한 동일한 사용자로 업그레이드하도록 변경합니다.

    sudo chown amq-broker:amq-broker jboss-amq-7.x.x.redhat-1.zip
  3. 아카이브를 AMQ Broker의 원래 설치 중에 생성된 디렉터리로 이동합니다. 다음 예에서는 /opt/redhat 디렉터리가 사용됩니다.

    sudo mv jboss-amq-7.x.x.redhat-1.zip /opt/redhat
  4. 디렉터리 소유자로 압축된 아카이브의 내용을 추출합니다. 아카이브는 압축된 형식으로 유지됩니다. 다음 예에서 사용자 amq-broker 는 unzip 명령을 사용하여 아카이브를 추출합니다.

    su - amq-broker
    cd /opt/redhat
    unzip jboss-amq-7.x.x.redhat-1.zip
  5. 실행 중인 경우 브로커를 중지합니다.

    <broker_instance_dir>/bin/artemis stop
  6. 현재 사용자의 홈 디렉터리에 복사하여 브로커의 인스턴스 디렉터리를 백업합니다.

    cp -r <broker_instance_dir> ~/
  7. (선택 사항) 브로커의 현재 버전을 기록해 둡니다. 브로커가 중지되면 로그 파일 끝에 다음과 유사한 행이 표시됩니다. 이 행은 < broker_instance_dir> /log/artemis.log 에서 찾을 수 있습니다.

    INFO  [org.apache.activemq.artemis.core.server] AMQ221002: Apache ActiveMQ Artemis Message Broker version 2.0.0.amq-700005-redhat-1 [4782d50d-47a2-11e7-a160-9801a793ea45] stopped, uptime 28 minutes
  8. < broker_instance_dir> /etc/artemis.profile 구성 파일을 편집하여 ARTEMIS_HOME 속성을 아카이브가 추출되었을 때 생성된 새 디렉터리로 설정합니다.

    ARTEMIS_HOME='/opt/redhat/jboss-amq-7.x.x-redhat-1'
  9. 업그레이드된 브로커를 시작합니다.

    <broker_instance_dir>/bin/artemis run
  10. (선택 사항) 브로커가 실행 중이고 버전이 변경되었는지 확인합니다. 브로커를 시작한 후 로그 파일 < broker_instance_dir> /log/artemis.log 를 열고 아래 행과 유사한 두 행을 찾습니다. 브로커가 활성화된 후 로그에 표시되는 새 버전 번호를 확인합니다.

    INFO  [org.apache.activemq.artemis.core.server] AMQ221007: Server is now live
    ...
    INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.1.0.amq-700005-redhat-1 [0.0.0.0, nodeID=4782d50d-47a2-11e7-a160-9801a793ea45]

2.2.1.2. Windows에서 7.0.x에서 7.0.y로 업그레이드

사전 요구 사항

  • AMQ Broker를 업그레이드하기 전에 대상 릴리스의 릴리스 노트를 검토하십시오.

    릴리스 노트에서는 대상 릴리스의 중요한 개선 사항, 알려진 문제 및 동작 변경 사항에 대해 설명합니다.

    자세한 내용은 AMQ Broker 7.0 릴리스 노트 를 참조하십시오.

프로세스

  1. AMQ Broker 아카이브 다운로드에 제공된 지침에 따라 Red Hat 고객 포털에서 원하는 아카이브를 다운로드합니다.
  2. 파일 관리자를 사용하여 AMQ Broker 마지막 설치 중에 생성한 폴더로 아카이브를 이동합니다.
  3. 아카이브 내용을 추출합니다. .zip 파일을 마우스 오른쪽 버튼으로 클릭하고 Extract All 을 선택합니다.
  4. 다음 명령을 입력하여 실행 중인 브로커를 중지합니다.

    <broker_instance_dir>\bin\artemis-service.exe stop
  5. 파일 관리자를 사용하여 브로커를 백업합니다.

    1. < broker_instance_dir> 폴더를 마우스 오른쪽 버튼으로 클릭하고 Copy 를 선택합니다.
    2. 동일한 창에서 마우스 오른쪽 버튼으로 클릭하고 Paste 를 선택합니다.
  6. (선택 사항) 브로커의 현재 버전을 기록해 둡니다. 브로커가 중지되면 로그 파일 끝에 다음과 유사한 행이 표시됩니다. 이 행은 < broker_instance_dir> \log\artemis.log 에서 찾을 수 있습니다.

    INFO  [org.apache.activemq.artemis.core.server] AMQ221002: Apache ActiveMQ Artemis Message Broker version 2.0.0.amq-700005-redhat-1 [4782d50d-47a2-11e7-a160-9801a793ea45] stopped, uptime 28 minutes
  7. < broker_instance_dir> \etc\artemis.profile 구성 파일을 편집하여 ARTEMIS_HOME 속성을 아카이브가 추출되었을 때 생성된 새 디렉터리로 설정합니다.

    ARTEMIS_HOME=<install_dir>
  8. 업그레이드된 브로커를 시작합니다.

    <broker_instance_dir>\bin\artemis-service.exe start
  9. (선택 사항) 브로커가 실행 중이고 버전이 변경되었는지 확인합니다. 브로커를 시작한 후 로그 파일 < broker_instance_dir> \log\artemis.log 를 열고 아래 행과 유사한 두 행을 찾습니다. 브로커가 활성화된 후 로그에 표시되는 새 버전 번호를 확인합니다.

    INFO  [org.apache.activemq.artemis.core.server] AMQ221007: Server is now live
    ...
    INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.1.0.amq-700005-redhat-1 [0.0.0.0, nodeID=4782d50d-47a2-11e7-a160-9801a793ea45]

2.2.2. 브로커 인스턴스를 7.0.x에서 7.1.0으로 업그레이드

AMQ Broker 7.1.0에는 이전 버전에 포함되지 않은 구성 파일 및 설정이 포함되어 있습니다. 7.0.x에서 7.1.0으로 브로커 인스턴스를 업그레이드하려면 이러한 새 파일과 설정을 기존 7.0.x 브로커 인스턴스에 추가해야 합니다. 다음 하위 섹션에서는 다른 운영 체제의 7.0.x 브로커 인스턴스를 7.1.0으로 업그레이드하는 방법을 설명합니다.

중요

AMQ Broker 7.1.0부터는 기본적으로 로컬 호스트에서만 AMQ 관리 콘솔에 액세스할 수 있습니다. 콘솔에 대한 원격 액세스 구성에 대한 자세한 내용은 AMQ Management Console에 대한 로컬 및 원격 액세스 구성을 참조하십시오.

2.2.2.1. Linux에서 7.0.x에서 7.1.0으로 업그레이드

7.0.x 브로커를 업그레이드하려면 Red Hat AMQ Broker 7.1.0을 설치하고 임시 브로커 인스턴스를 생성해야 합니다. 이렇게 하면 7.0.x 브로커를 업그레이드하는 데 필요한 7.1.0 구성 파일이 생성됩니다.

사전 요구 사항

  • AMQ Broker를 업그레이드하기 전에 대상 릴리스의 릴리스 노트를 검토하십시오.

    릴리스 노트에서는 대상 릴리스의 중요한 개선 사항, 알려진 문제 및 동작 변경 사항에 대해 설명합니다.

    자세한 내용은 AMQ Broker 7.1 릴리스 노트 를 참조하십시오.

  • 7.0.x 브로커를 업그레이드하기 전에 먼저 버전 7.1을 설치해야 합니다.

    Linux에 7.1을 설치하는 단계는 AMQ Broker 설치를 참조하십시오.

프로세스

  1. 실행 중인 경우 업그레이드하려는 7.0.x 브로커를 중지합니다.

    $ <broker_instance_dir>/bin/artemis stop
  2. 현재 사용자의 홈 디렉터리에 복사하여 브로커의 인스턴스 디렉터리를 백업합니다.

    cp -r <broker_instance_dir> ~/
  3. 7.0.x 브로커의 < broker_instance_dir> /etc/ 디렉토리에서 artemis.profile 파일을 엽니다.

    1. 값이 AMQ Broker 7.1.0의 설치 디렉토리를 참조하도록 ARTEMIS_HOME 속성을 업데이트합니다.

      ARTEMIS_HOME="<7.1.0_install_dir>"
    2. 업데이트된 행 아래에 ARTEMIS_INSTANCE_URI 속성을 추가하고 7.0.x 브로커 인스턴스 디렉터리를 참조하는 값을 할당합니다.

      ARTEMIS_INSTANCE_URI="file://<7.0.x_broker_instance_dir>"
    3. jolokia.policyLocation 매개변수를 추가하고 다음 값을 할당하여 JAVA_ARGS 속성을 업데이트합니다.

      -Djolokia.policyLocation=${ARTEMIS_INSTANCE_URI}/etc/jolokia-access.xml
  4. 7.1.0 브로커 인스턴스를 생성합니다. 생성 절차에서는 7.0.x에서 7.1.0으로 업그레이드하는 데 필요한 구성 파일을 생성합니다. 다음 예제에서는 인스턴스가 upgrade_tmp 디렉터리에 생성됩니다.

    $ <7.1.0_install_dir>/bin/artemis create --allow-anonymous --user admin --password admin upgrade_tmp
  5. 임시 7.1.0 인스턴스의 etc 디렉터리의 구성 파일을 7.0.x 브로커의 < broker_instance_dir> /etc/ 디렉터리에 복사합니다.

    1. management.xml 파일을 복사합니다.

      $ cp <temporary_7.1.0_broker_instance_dir>/etc/management.xml <7.0_broker_instance_dir>/etc/
    2. jolokia-access.xml 파일을 복사합니다.

      $ cp <temporary_7.1.0_broker_instance_dir>/etc/jolokia-access.xml <7.0_broker_instance_dir>/etc/
  6. 7.0.x 브로커의 < broker_instance_dir> /etc/ 디렉토리에서 bootstrap.xml 파일을 엽니다.

    1. 다음 두 행을 주석 처리하거나 삭제합니다.

      <app url="jolokia" war="jolokia.war"/>
      <app url="hawtio" war="hawtio-no-slf4j.war"/>
    2. 이전 단계에서 제거된 두 행을 교체하려면 다음을 추가합니다.

      <app url="console" war="console.war"/>
  7. 업그레이드한 브로커를 시작합니다.

    $ <broker_instance_dir>/bin/artemis run

추가 리소스

브로커 인스턴스 생성에 대한 자세한 내용은 브로커 인스턴스 생성을 참조하십시오.

2.2.2.2. Windows에서 7.0.x에서 7.1.0으로 업그레이드

7.0.x 브로커를 업그레이드하려면 Red Hat AMQ Broker 7.1.0을 설치하고 임시 브로커 인스턴스를 생성해야 합니다. 이렇게 하면 7.0.x 브로커를 업그레이드하는 데 필요한 7.1.0 구성 파일이 생성됩니다.

사전 요구 사항

  • AMQ Broker를 업그레이드하기 전에 대상 릴리스의 릴리스 노트를 검토하십시오.

    릴리스 노트에서는 대상 릴리스의 중요한 개선 사항, 알려진 문제 및 동작 변경 사항에 대해 설명합니다.

    자세한 내용은 AMQ Broker 7.1 릴리스 노트 를 참조하십시오.

  • 7.0.x 브로커를 업그레이드하기 전에 먼저 버전 7.1을 설치해야 합니다.

    Windows에 7.1을 설치하는 단계는 AMQ Broker 설치를 참조하십시오.

프로세스

  1. 실행 중인 경우 업그레이드하려는 7.0.x 브로커를 중지합니다.

    > <broker_instance_dir>\bin\artemis-service.exe stop
  2. 파일 관리자를 사용하여 브로커의 인스턴스 디렉터리를 백업합니다.

    1. < broker_instance_dir> 폴더를 마우스 오른쪽 버튼으로 클릭하고 Copy 를 선택합니다.
    2. 동일한 창에서 마우스 오른쪽 버튼으로 클릭하고 Paste 를 선택합니다.
  3. 7.0.x 브로커의 < broker_instance_dir> /etc/ 디렉토리에서 artemis.profile 파일을 엽니다.

    1. 값이 AMQ Broker 7.1.0의 설치 디렉토리를 참조하도록 ARTEMIS_HOME 속성을 업데이트합니다.

      ARTEMIS_HOME="<7.1.0_install_dir>"
    2. 업데이트된 행 아래에 ARTEMIS_INSTANCE_URI 속성을 추가하고 7.0.x 브로커 인스턴스 디렉터리를 참조하는 값을 할당합니다.

      ARTEMIS_INSTANCE_URI="file://<7.0.x_broker_instance_dir>"
    3. jolokia.policyLocation 매개변수를 추가하고 다음 값을 할당하여 JAVA_ARGS 속성을 업데이트합니다.

      -Djolokia.policyLocation=${ARTEMIS_INSTANCE_URI}/etc/jolokia-access.xml
  4. 7.1.0 브로커 인스턴스를 생성합니다. 생성 절차에서는 7.0.x에서 7.1.0으로 업그레이드하는 데 필요한 구성 파일을 생성합니다. 다음 예제에서는 인스턴스가 upgrade_tmp 디렉터리에 생성됩니다.

    > <7.1.0_install_dir>/bin/artemis create --allow-anonymous --user admin --password admin upgrade_tmp
  5. 임시 7.1.0 인스턴스의 etc 디렉터리의 구성 파일을 7.0.x 브로커의 < broker_instance_dir> /etc/ 디렉터리에 복사합니다.

    1. management.xml 파일을 복사합니다.

      > cp <temporary_7.1.0_broker_instance_dir>/etc/management.xml <7.0_broker_instance_dir>/etc/
    2. jolokia-access.xml 파일을 복사합니다.

      > cp <temporary_7.1.0_broker_instance_dir>/etc/jolokia-access.xml <7.0_broker_instance_dir>/etc/
  6. 7.0.x 브로커의 < broker_instance_dir> /etc/ 디렉토리에서 bootstrap.xml 파일을 엽니다.

    1. 다음 두 행을 주석 처리하거나 삭제합니다.

      <app url="jolokia" war="jolokia.war"/>
      <app url="hawtio" war="hawtio-no-slf4j.war"/>
    2. 이전 단계에서 제거된 두 행을 교체하려면 다음을 추가합니다.

      <app url="console" war="console.war"/>
  7. 업그레이드한 브로커를 시작합니다.

    > <broker_instance_dir>\bin\artemis-service.exe start

추가 리소스

브로커 인스턴스 생성에 대한 자세한 내용은 브로커 인스턴스 생성을 참조하십시오.

2.2.3. 브로커 인스턴스를 7.1.x에서 7.2.0으로 업그레이드

AMQ Broker 7.2.0에는 7.0.x 버전에 포함되지 않은 구성 파일 및 설정이 포함되어 있습니다. 7.0.x 인스턴스를 실행하는 경우 7.2.0으로 업그레이드하기 전에 먼저 해당 브로커 인스턴스를 7.0.x에서 7.1.0으로 업그레이드해야 합니다. 다음 하위 섹션에서는 다른 운영 체제의 경우 7.1.x 브로커 인스턴스를 7.2.0으로 업그레이드하는 방법을 설명합니다.

중요

AMQ Broker 7.1.0부터는 기본적으로 로컬 호스트에서만 AMQ 관리 콘솔에 액세스할 수 있습니다. 콘솔에 대한 원격 액세스 구성에 대한 자세한 내용은 AMQ Management Console에 대한 로컬 및 원격 액세스 구성을 참조하십시오.

2.2.3.1. Linux에서 7.1.x에서 7.2.0으로 업그레이드

참고

다운로드한 아카이브의 이름은 다음 예제에서 사용되는 것과 다를 수 있습니다.

프로세스

  1. AMQ Broker 아카이브 다운로드에 제공된 지침에 따라 Red Hat 고객 포털에서 원하는 아카이브를 다운로드합니다.
  2. 아카이브의 소유자를 AMQ Broker 설치를 소유한 동일한 사용자로 업그레이드하도록 변경합니다.

    sudo chown amq-broker:amq-broker amq-7.x.x.redhat-1.zip
  3. 아카이브를 AMQ Broker의 원래 설치 중에 생성된 디렉터리로 이동합니다. 다음 예에서는 /opt/redhat 디렉터리가 사용됩니다.

    sudo mv amq-7.x.x.redhat-1.zip /opt/redhat
  4. 디렉터리 소유자로 압축된 아카이브의 내용을 추출합니다. 다음 예에서 사용자 amq-broker 는 unzip 명령을 사용하여 아카이브를 추출합니다.

    su - amq-broker
    cd /opt/redhat
    unzip jboss-amq-7.x.x.redhat-1.zip
  5. 실행 중인 경우 브로커를 중지합니다.

    <broker_instance_dir>/bin/artemis stop
  6. 현재 사용자의 홈 디렉터리에 복사하여 브로커의 인스턴스 디렉터리를 백업합니다.

    cp -r <broker_instance_dir> ~/
  7. (선택 사항) 브로커의 현재 버전을 기록해 둡니다. 브로커가 중지되면 로그 파일 끝에 다음과 유사한 행이 표시됩니다. 이 행은 < broker_instance_dir> /log/artemis.log 에서 찾을 수 있습니다.

    INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.5.0.amq-720001-redhat-1 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]
  8. < broker_instance_dir> /etc/artemis.profile 구성 파일을 편집하여 ARTEMIS_HOME 속성을 아카이브가 추출되었을 때 생성된 새 디렉터리로 설정합니다.

    ARTEMIS_HOME='/opt/redhat/amq-7.x.x-redhat-1'
  9. 업그레이드된 브로커를 시작합니다.

    <broker_instance_dir>/bin/artemis run
  10. (선택 사항) 브로커가 실행 중이고 버전이 변경되었는지 확인합니다. 브로커를 시작한 후 로그 파일 < broker_instance_dir> /log/artemis.log 를 열고 아래 행과 유사한 두 행을 찾습니다. 브로커가 활성화된 후 로그에 표시되는 새 버전 번호를 확인합니다.

    INFO  [org.apache.activemq.artemis.core.server] AMQ221007: Server is now live
    ...
    INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.5.0.amq-720001-redhat-1 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]

추가 리소스

  • 브로커 인스턴스 생성에 대한 자세한 내용은 브로커 인스턴스 생성을 참조하십시오.
  • 브로커 인스턴스의 디렉터리 외부의 위치를 포함하여 모든 사용자 지정 디렉터리에 브로커 인스턴스의 구성 파일 및 데이터를 저장할 수 있습니다. < broker_instance_dir> /etc/artemis.profile 파일에서 브로커 인스턴스를 생성한 후 사용자 지정 디렉터리의 위치를 지정하여 ARTEMIS_INSTANCE_ETC_URI 속성을 업데이트합니다. 이전에는 이러한 구성 파일과 데이터는 브로커 인스턴스의 디렉터리 내의 etc/data/ 디렉터리에만 저장할 수 있었습니다.

2.2.3.2. Windows에서 7.1.x에서 7.2.0으로 업그레이드

프로세스

  1. AMQ Broker 아카이브 다운로드에 제공된 지침에 따라 Red Hat 고객 포털에서 원하는 아카이브를 다운로드합니다.
  2. 파일 관리자를 사용하여 AMQ Broker 마지막 설치 중에 생성한 폴더로 아카이브를 이동합니다.
  3. 아카이브 내용을 추출합니다. .zip 파일을 마우스 오른쪽 버튼으로 클릭하고 Extract All 을 선택합니다.
  4. 다음 명령을 입력하여 실행 중인 브로커를 중지합니다.

    <broker_instance_dir>\bin\artemis-service.exe stop
  5. 파일 관리자를 사용하여 브로커를 백업합니다.

    1. < broker_instance_dir> 폴더를 마우스 오른쪽 버튼으로 클릭하고 Copy 를 선택합니다.
    2. 동일한 창에서 마우스 오른쪽 버튼으로 클릭하고 Paste 를 선택합니다.
  6. (선택 사항) 브로커의 현재 버전을 기록해 둡니다. 브로커가 중지되면 로그 파일 끝에 다음과 유사한 행이 표시됩니다. 이 행은 < broker_instance_dir> \log\artemis.log 에서 찾을 수 있습니다.

    INFO  [org.apache.activemq.artemis.core.server] AMQ221002: Apache ActiveMQ Artemis Message Broker version 2.0.0.amq-700005-redhat-1 [4782d50d-47a2-11e7-a160-9801a793ea45] stopped, uptime 28 minutes
  7. < broker_instance_dir> \etc\artemis.profile.cmd 및 < broker_instance_dir> \bin\artemis-service.xml 구성 파일을 편집하여 ARTEMIS_HOME 속성을 아카이브가 추출될 때 생성된 새 디렉터리로 설정합니다.

    ARTEMIS_HOME=<install_dir>
  8. 업그레이드된 브로커를 시작합니다.

    <broker_instance_dir>\bin\artemis-service.exe start
  9. (선택 사항) 브로커가 실행 중이고 버전이 변경되었는지 확인합니다. 브로커를 시작한 후 로그 파일 < broker_instance_dir> \log\artemis.log 를 열고 아래 행과 유사한 두 행을 찾습니다. 브로커가 활성화된 후 로그에 표시되는 새 버전 번호를 확인합니다.

    INFO  [org.apache.activemq.artemis.core.server] AMQ221007: Server is now live
    ...
    INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.5.0.amq-720001-redhat-1 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]

추가 리소스

  • 브로커 인스턴스 생성에 대한 자세한 내용은 브로커 인스턴스 생성을 참조하십시오.
  • 브로커 인스턴스의 디렉터리 외부의 위치를 포함하여 모든 사용자 지정 디렉터리에 브로커 인스턴스의 구성 파일 및 데이터를 저장할 수 있습니다. < broker_instance_dir> \etc\artemis.profile 파일에서 브로커 인스턴스를 생성한 후 사용자 지정 디렉터리의 위치를 지정하여 ARTEMIS_INSTANCE_ETC_URI 속성을 업데이트합니다. 이전에는 이러한 구성 파일과 데이터는 브로커 인스턴스의 디렉터리 내의 \etc\data 디렉터리에만 저장할 수 있었습니다.

2.2.4. 브로커 인스턴스를 7.2.x에서 7.3.0으로 업그레이드

다음 하위 섹션에서는 다른 운영 체제의 7.2.x 브로커 인스턴스를 7.3.0으로 업그레이드하는 방법을 설명합니다.

2.2.4.1. 더 이상 사용되지 않는 디스패치 콘솔로 인한 해결 예외

버전 7.3.0부터 AMQ Broker는 더 이상 Hawtio 디스패치 콘솔 플러그인 dispatch-hawtio-console.war 와 함께 제공되지 않습니다. 이전에는 디스패치 콘솔을 사용하여 AMQ Interconnect를 관리했습니다. 그러나 AMQ Interconnect는 이제 자체 독립 실행형 웹 콘솔을 사용합니다. 이 변경 사항은 다음 섹션의 업그레이드 절차에 영향을 미칩니다.

브로커 인스턴스를 7.3.0으로 업그레이드하기 전에 추가 작업을 수행하지 않으면 업그레이드 프로세스에서 다음과 같은 예외를 생성합니다.

2019-04-11 18:00:41,334 WARN  [org.eclipse.jetty.webapp.WebAppContext] Failed startup of context o.e.j.w.WebAppContext@1ef3efa8{/dispatch-hawtio-console,null,null}{/opt/amqbroker/amq-broker-7.3.0/web/dispatch-hawtio-console.war}: java.io.FileNotFoundException: /opt/amqbroker/amq-broker-7.3.0/web/dispatch-hawtio-console.war.

업그레이드 성공에 영향을 주지 않고 이전 예외를 무시해도 됩니다.

그러나 업그레이드 중에 이 예외를 표시하지 않으려면 먼저 기존 브로커 인스턴스의 bootstrap.xml 파일에서 Hawtio 디스패치 콘솔 플러그인에 대한 참조를 제거해야 합니다. bootstrap.xml 파일은 브로커 인스턴스의 {instance_directory}/etc/ 디렉터리에 있습니다. 다음 예제에서는 AMQ Broker 7.2.4 인스턴스에 대한 bootstrap.xml 파일의 일부 내용을 보여줍니다.

<broker xmlns="http://activemq.org/schema">
....
   <!-- The web server is only bound to localhost by default -->
   <web bind="http://localhost:8161" path="web">
       <app url="redhat-branding" war="redhat-branding.war"/>
       <app url="artemis-plugin" war="artemis-plugin.war"/>
       <app url="dispatch-hawtio-console" war="dispatch-hawtio-console.war"/>
       <app url="console" war="console.war"/>
   </web>
</broker>

AMQ Broker를 버전 7.3.0으로 업그레이드할 때 예외를 방지하려면 이전 예와 같이 < app url="dispatch-hawtio-console" war="dispatch-hawtio-console.war"/ > 행을 삭제합니다. 그런 다음 수정된 부트스트랩 파일을 저장하고 다음 섹션에 설명된 대로 업그레이드 프로세스를 시작합니다.

중요

AMQ Broker 7.1.0부터는 기본적으로 로컬 호스트에서만 AMQ 관리 콘솔에 액세스할 수 있습니다. 콘솔에 대한 원격 액세스 구성에 대한 자세한 내용은 AMQ Management Console에 대한 로컬 및 원격 액세스 구성을 참조하십시오.

2.2.4.2. Linux에서 7.2.x에서 7.3.0으로 업그레이드

참고

다운로드한 아카이브의 이름은 다음 예제에서 사용되는 것과 다를 수 있습니다.

프로세스

  1. AMQ Broker 아카이브 다운로드에 제공된 지침에 따라 Red Hat 고객 포털에서 원하는 아카이브를 다운로드합니다.
  2. 아카이브의 소유자를 AMQ Broker 설치를 소유한 동일한 사용자로 업그레이드하도록 변경합니다.

    sudo chown amq-broker:amq-broker amq-7.x.x.redhat-1.zip
  3. 아카이브를 AMQ Broker의 원래 설치 중에 생성된 디렉터리로 이동합니다. 다음 예에서는 /opt/redhat 디렉터리가 사용됩니다.

    sudo mv amq-7.x.x.redhat-1.zip /opt/redhat
  4. 디렉터리 소유자로 압축된 아카이브의 내용을 추출합니다. 다음 예에서 사용자 amq-broker 는 unzip 명령을 사용하여 아카이브를 추출합니다.

    su - amq-broker
    cd /opt/redhat
    unzip jboss-amq-7.x.x.redhat-1.zip
  5. 실행 중인 경우 브로커를 중지합니다.

    <broker_instance_dir>/bin/artemis stop
  6. 현재 사용자의 홈 디렉터리에 복사하여 브로커의 인스턴스 디렉터리를 백업합니다.

    cp -r <broker_instance_dir> ~/
  7. (선택 사항) 브로커의 현재 버전을 기록해 둡니다. 브로커가 중지되면 로그 파일 끝에 다음과 유사한 행이 표시됩니다. 이 행은 < broker_instance_dir> /log/artemis.log 에서 찾을 수 있습니다.

    INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.6.3.amq-720001-redhat-1 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]
  8. < broker_instance_dir> /etc/artemis.profile 구성 파일을 편집하여 ARTEMIS_HOME 속성을 아카이브가 추출되었을 때 생성된 새 디렉터리로 설정합니다.

    ARTEMIS_HOME='/opt/redhat/amq-7.x.x-redhat-1'
  9. 업그레이드된 브로커를 시작합니다.

    <broker_instance_dir>/bin/artemis run
  10. (선택 사항) 브로커가 실행 중이고 버전이 변경되었는지 확인합니다. 브로커를 시작한 후 로그 파일 < broker_instance_dir> /log/artemis.log 를 열고 아래 행과 유사한 두 행을 찾습니다. 브로커가 활성화된 후 로그에 표시되는 새 버전 번호를 확인합니다.

    INFO  [org.apache.activemq.artemis.core.server] AMQ221007: Server is now live
    ...
    INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.7.0.redhat-00054 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]

추가 리소스

  • 브로커 인스턴스 생성에 대한 자세한 내용은 브로커 인스턴스 생성을 참조하십시오.
  • 브로커 인스턴스의 디렉터리 외부의 위치를 포함하여 모든 사용자 지정 디렉터리에 브로커 인스턴스의 구성 파일 및 데이터를 저장할 수 있습니다. < broker_instance_dir> /etc/artemis.profile 파일에서 브로커 인스턴스를 생성한 후 사용자 지정 디렉터리의 위치를 지정하여 ARTEMIS_INSTANCE_ETC_URI 속성을 업데이트합니다. 이전에는 이러한 구성 파일과 데이터는 브로커 인스턴스의 디렉터리 내의 etc/data/ 디렉터리에만 저장할 수 있었습니다.

2.2.4.3. Windows에서 7.2.x에서 7.3.0으로 업그레이드

프로세스

  1. AMQ Broker 아카이브 다운로드에 제공된 지침에 따라 Red Hat 고객 포털에서 원하는 아카이브를 다운로드합니다.
  2. 파일 관리자를 사용하여 AMQ Broker 마지막 설치 중에 생성한 폴더로 아카이브를 이동합니다.
  3. 아카이브 내용을 추출합니다. .zip 파일을 마우스 오른쪽 버튼으로 클릭하고 Extract All 을 선택합니다.
  4. 다음 명령을 입력하여 실행 중인 브로커를 중지합니다.

    <broker_instance_dir>\bin\artemis-service.exe stop
  5. 파일 관리자를 사용하여 브로커를 백업합니다.

    1. < broker_instance_dir> 폴더를 마우스 오른쪽 버튼으로 클릭하고 Copy 를 선택합니다.
    2. 동일한 창에서 마우스 오른쪽 버튼으로 클릭하고 Paste 를 선택합니다.
  6. (선택 사항) 브로커의 현재 버전을 기록해 둡니다. 브로커가 중지되면 로그 파일 끝에 다음과 유사한 행이 표시됩니다. 이 행은 < broker_instance_dir> \log\artemis.log 에서 찾을 수 있습니다.

    INFO  [org.apache.activemq.artemis.core.server] AMQ221002: Apache ActiveMQ Artemis Message Broker version 2.6.3.amq-720001-redhat-1 [4782d50d-47a2-11e7-a160-9801a793ea45] stopped, uptime 28 minutes
  7. < broker_instance_dir> \etc\artemis.profile.cmd 및 < broker_instance_dir> \bin\artemis-service.xml 구성 파일을 편집하여 ARTEMIS_HOME 속성을 아카이브가 추출될 때 생성된 새 디렉터리로 설정합니다.

    ARTEMIS_HOME=<install_dir>
  8. < broker_instance_dir> \etc\artemis.profile.cmd 구성 파일을 편집하여 JAVA_ARGS 환경 변수를 올바른 로그 관리자 버전을 참조합니다.

    JAVA_ARGS=<install_dir>\lib\jboss-logmanager-2.0.3.Final-redhat-1.jar
  9. < broker_instance_dir> \bin\artemis-service.xml 구성 파일을 편집하여 올바른 로그 관리자 버전을 참조하도록 부트스트랩 클래스 경로 start 인수를 설정합니다.

    <startargument>Xbootclasspath/a:%ARTEMIS_HOME%\lib\jboss-logmanager-2.0.3.Final-redhat-1.jar</startargument>
  10. 업그레이드된 브로커를 시작합니다.

    <broker_instance_dir>\bin\artemis-service.exe start
  11. (선택 사항) 브로커가 실행 중이고 버전이 변경되었는지 확인합니다. 브로커를 시작한 후 로그 파일 < broker_instance_dir> \log\artemis.log 를 열고 아래 행과 유사한 두 행을 찾습니다. 브로커가 활성화된 후 로그에 표시되는 새 버전 번호를 확인합니다.

    INFO  [org.apache.activemq.artemis.core.server] AMQ221007: Server is now live
    ...
    INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.7.0.redhat-00054 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]

추가 리소스

  • 브로커 인스턴스 생성에 대한 자세한 내용은 브로커 인스턴스 생성을 참조하십시오.
  • 브로커 인스턴스의 디렉터리 외부의 위치를 포함하여 모든 사용자 지정 디렉터리에 브로커 인스턴스의 구성 파일 및 데이터를 저장할 수 있습니다. < broker_instance_dir> \etc\artemis.profile 파일에서 브로커 인스턴스를 생성한 후 사용자 지정 디렉터리의 위치를 지정하여 ARTEMIS_INSTANCE_ETC_URI 속성을 업데이트합니다. 이전에는 이러한 구성 파일과 데이터는 브로커 인스턴스의 디렉터리 내의 \etc\data 디렉터리에만 저장할 수 있었습니다.

2.2.5. 브로커 인스턴스를 7.3.0에서 7.4.0으로 업그레이드

다음 하위 섹션에서는 다른 운영 체제의 경우 7.3.0 브로커 인스턴스를 7.4.0으로 업그레이드하는 방법을 설명합니다.

중요

AMQ Broker 7.1.0부터는 기본적으로 로컬 호스트에서만 AMQ 관리 콘솔에 액세스할 수 있습니다. 콘솔에 대한 원격 액세스 구성에 대한 자세한 내용은 AMQ Management Console에 대한 로컬 및 원격 액세스 구성을 참조하십시오.

2.2.5.1. Linux에서 7.3.0에서 7.4.0으로 업그레이드

참고

다운로드한 아카이브의 이름은 다음 예제에서 사용되는 것과 다를 수 있습니다.

프로세스

  1. Red Hat 고객 포털에서 원하는 아카이브를 다운로드합니다. AMQ Broker 아카이브 다운로드에 제공된 지침을 따르십시오.
  2. 아카이브의 소유자를 AMQ Broker 설치를 소유한 동일한 사용자로 업그레이드하도록 변경합니다. 다음 예제에서는 amq-broker 라는 사용자를 보여줍니다.

    sudo chown amq-broker:amq-broker amq-broker-7.x.x.redhat-1.zip
  3. 아카이브를 AMQ Broker의 원래 설치 중에 생성된 디렉터리로 이동합니다. 다음 예제에서는 /opt/redhat 을 사용합니다.

    sudo mv amq-broker-7.x.x.redhat-1.zip /opt/redhat
  4. 디렉터리 소유자로 압축된 아카이브의 내용을 추출합니다. 다음 예에서 사용자 amq-brokerunzip 명령을 사용하여 아카이브를 추출합니다.

    su - amq-broker
    cd /opt/redhat
    unzip amq-broker-7.x.x.redhat-1.zip
  5. 브로커가 실행 중인 경우 중지합니다.

    <broker_instance_dir>/bin/artemis stop
  6. 현재 사용자의 홈 디렉터리에 복사하여 브로커의 인스턴스 디렉터리를 백업합니다.

    cp -r <broker_instance_dir> ~/
  7. (선택 사항) 브로커의 현재 버전을 기록해 둡니다. 브로커가 중지되면 < broker_instance_dir> /log/artemis.log 파일의 끝에 다음과 유사한 행이 표시됩니다.

    INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.7.0.redhat-00054 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]
  8. &lt ;broker_instance_dir> /etc/artemis.profile 구성 파일을 편집합니다.

    1. ARTEMIS_HOME 속성을 아카이브가 추출될 때 생성된 새 디렉터리로 설정합니다.

      ARTEMIS_HOME='/opt/redhat/amq-broker-7.x.x-redhat-1'
    2. JAVA_ARGS 속성을 편집합니다. 로그 관리자의 종속 파일을 참조하는 부트스트랩 클래스 경로 인수를 추가합니다.

      -Xbootclasspath/a:$ARTEMIS_HOME/lib/wildfly-common-1.5.1.Final-redhat-00001.jar
  9. &lt ;broker_instance_dir&gt; /etc/bootstrap.xml 구성 파일을 편집합니다. &lt ;web > 구성 요소에서 AMQ Broker의 메트릭 플러그인 파일에 참조를 추가합니다.

    <app url="metrics" war="metrics.war"/>
  10. 업그레이드된 브로커를 시작합니다.

    <broker_instance_dir>/bin/artemis run
  11. (선택 사항) 브로커가 실행 중이고 버전이 변경되었는지 확인합니다. 브로커를 시작한 후 < broker_instance_dir> /log/artemis.log 파일을 엽니다. 아래 것과 유사한 두 행을 찾습니다. 브로커가 사용 중일 때 로그에 표시되는 새 버전 번호를 확인합니다.

    INFO  [org.apache.activemq.artemis.core.server] AMQ221007: Server is now live
    ...
    INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.9.0.redhat-00001 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]

추가 리소스

  • 브로커 인스턴스 생성에 대한 자세한 내용은 브로커 인스턴스 생성을 참조하십시오.
  • 브로커 인스턴스의 디렉터리 외부의 위치를 포함하여 모든 사용자 지정 디렉터리에 브로커 인스턴스의 구성 파일 및 데이터를 저장할 수 있습니다. < broker_instance_dir> /etc/artemis.profile 파일에서 브로커 인스턴스를 생성한 후 사용자 지정 디렉터리의 위치를 지정하여 ARTEMIS_INSTANCE_ETC_URI 속성을 업데이트합니다. 이전에는 이러한 구성 파일과 데이터는 브로커 인스턴스의 디렉터리 내의 etc/data/ 디렉터리에만 저장할 수 있었습니다.

2.2.5.2. Windows에서 7.3.0에서 7.4.0으로 업그레이드

프로세스

  1. Red Hat 고객 포털에서 원하는 아카이브를 다운로드합니다. AMQ Broker 아카이브 다운로드에 제공된 지침을 따르십시오.
  2. 파일 관리자를 사용하여 AMQ Broker 마지막 설치 중에 생성한 폴더로 아카이브를 이동합니다.
  3. 아카이브 내용을 추출합니다. .zip 파일을 마우스 오른쪽 버튼으로 클릭하고 Extract All 을 선택합니다.
  4. 브로커가 실행 중인 경우 중지합니다.

    <broker_instance_dir>\bin\artemis-service.exe stop
  5. 파일 관리자를 사용하여 브로커를 백업합니다.

    1. < broker_instance_dir> 폴더를 마우스 오른쪽 버튼으로 클릭하고 Copy 를 선택합니다.
    2. 동일한 창에서 마우스 오른쪽 버튼으로 클릭하고 Paste 를 선택합니다.
  6. (선택 사항) 브로커의 현재 버전을 기록해 둡니다. 브로커가 중지되면 < broker_instance_dir> \log\artemis.log 파일의 끝에 다음과 유사한 행이 표시됩니다.

    INFO  [org.apache.activemq.artemis.core.server] AMQ221002: Apache ActiveMQ Artemis Message Broker version 2.7.0.redhat-00054 [4782d50d-47a2-11e7-a160-9801a793ea45] stopped, uptime 28 minutes
  7. < broker_instance_dir> \etc\artemis.profile.cmd 및 < broker_instance_dir> \bin\artemis-service.xml 구성 파일을 편집합니다. ARTEMIS_HOME 속성을 아카이브가 추출될 때 생성된 새 디렉터리로 설정합니다.

    ARTEMIS_HOME=<install_dir>
  8. &lt ;broker_instance_dir> \etc\artemis.profile.cmd 구성 파일을 편집합니다. 올바른 로그 관리자 버전 및 종속 파일을 참조하도록 JAVA_ARGS 환경 변수를 설정합니다.

    JAVA_ARGS=-Xbootclasspath/%ARTEMIS_HOME%\lib\jboss-logmanager-2.1.10.Final-redhat-00001.jar;%ARTEMIS_HOME%\lib\wildfly-common-1.5.1.Final-redhat-00001.jar
  9. &lt ;broker_instance_dir> \bin\artemis-service.xml 구성 파일을 편집합니다. 올바른 로그 관리자 버전과 종속 파일을 참조하도록 부트스트랩 클래스 경로 start 인수를 설정합니다.

    <startargument>-Xbootclasspath/a:%ARTEMIS_HOME%\lib\jboss-logmanager-2.1.10.Final-redhat-00001.jar;%ARTEMIS_HOME%\lib\wildfly-common-1.5.1.Final-redhat-00001.jar</startargument>
  10. &lt ;broker_instance_dir&gt; \etc\bootstrap.xml 구성 파일을 편집합니다. &lt ;web > 구성 요소에서 AMQ Broker의 메트릭 플러그인 파일에 참조를 추가합니다.

    <app url="metrics" war="metrics.war"/>
  11. 업그레이드된 브로커를 시작합니다.

    <broker_instance_dir>\bin\artemis-service.exe start
  12. (선택 사항) 브로커가 실행 중이고 버전이 변경되었는지 확인합니다. 브로커를 시작한 후 < broker_instance_dir> \log\artemis.log 파일을 엽니다. 아래 것과 유사한 두 행을 찾습니다. 브로커가 사용 중일 때 로그에 표시되는 새 버전 번호를 확인합니다.

    INFO  [org.apache.activemq.artemis.core.server] AMQ221007: Server is now live
    ...
    INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.9.0.redhat-00001 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]

추가 리소스

  • 브로커 인스턴스 생성에 대한 자세한 내용은 브로커 인스턴스 생성을 참조하십시오.
  • 브로커 인스턴스의 디렉터리 외부의 위치를 포함하여 모든 사용자 지정 디렉터리에 브로커 인스턴스의 구성 파일 및 데이터를 저장할 수 있습니다. < broker_instance_dir> \etc\artemis.profile 파일에서 브로커 인스턴스를 생성한 후 사용자 지정 디렉터리의 위치를 지정하여 ARTEMIS_INSTANCE_ETC_URI 속성을 업데이트합니다. 이전에는 이러한 구성 파일과 데이터는 브로커 인스턴스의 디렉터리 내의 \etc\data 디렉터리에만 저장할 수 있었습니다.
Red Hat logoGithubRedditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

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

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

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

Red Hat 소개

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

© 2024 Red Hat, Inc.