2.10. 브로커 인스턴스를 7.10.x에서 7.11.x로 업그레이드
다음 하위 섹션에서는 다른 운영 체제의 7.10.x 브로커 인스턴스를 7.11.x로 업그레이드하는 방법을 설명합니다.
AMQ Broker 7.1.0부터는 기본적으로 로컬 호스트에서만 AMQ 관리 콘솔에 액세스할 수 있습니다. 콘솔에 대한 원격 액세스 구성에 대한 자세한 내용은 AMQ Management Console에 대한 로컬 및 원격 액세스 구성을 참조하십시오.
2.10.1. Linux에서 7.10.x에서 7.11.x로 업그레이드
다운로드한 아카이브의 이름은 다음 예제에서 사용되는 것과 다를 수 있습니다.
사전 요구 사항
- 최소한 AMQ Broker 7.11.x를 실행하려면 Java 버전 11이 필요합니다. 각 AMQ Broker 호스트가 Java 버전 11 이상을 실행하고 있는지 확인합니다. 지원되는 구성에 대한 자세한 내용은 Red Hat AMQ Broker 7 지원 구성을 참조하십시오.
프로세스
- Red Hat 고객 포털에서 원하는 아카이브를 다운로드합니다. AMQ Broker 아카이브 다운로드에 제공된 지침을 따르십시오.
AMQ Broker 설치를 소유한 동일한 사용자로 다운로드한 아카이브의 소유자를 업그레이드하도록 변경합니다. 다음 예제에서는
amq-broker
라는 사용자를 보여줍니다.sudo chown amq-broker:amq-broker amq-broker-7.x.x-bin.zip
아카이브를 AMQ Broker의 원래 설치 중에 생성된 디렉터리로 이동합니다. 다음 예제에서는
/opt/redhat
을 사용합니다.sudo mv amq-broker-7.x.x-bin.zip /opt/redhat
디렉터리 소유자로 압축된 아카이브의 내용을 추출합니다. 다음 예에서 사용자
amq-broker
는unzip
명령을 사용하여 아카이브를 추출합니다.su - amq-broker cd /opt/redhat unzip amq-broker-7.x.x-bin.zip
참고최신 아카이브의 내용은 현재 디렉터리의
apache-artemis-2.28.0.redhat-00022
디렉터리에 추출됩니다.브로커가 실행 중인 경우 중지합니다.
<broker_instance_dir>/bin/artemis stop
(선택 사항) 브로커의 현재 버전을 기록해 둡니다. 브로커가 중지되면 <
broker_instance_dir> /log/artemis.log
파일의 끝에 다음과 유사한 행이 표시됩니다.INFO [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.18.0.redhat-00010 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]
현재 사용자의 홈 디렉터리에 복사하여 브로커의 인스턴스 디렉터리를 백업합니다.
cp -r <broker_instance_dir> ~/
압축된 아카이브의 내용을 추출한 디렉터리로 변경합니다.
cd /opt/redhat/apache-artemis-2.28.0.redhat-00022/bin
기존
브로커를 업그레이드
하려면 Artemis upgrade 명령을 실행하십시오. 다음 예제에서는/var/opt/amq-broker/mybroker
디렉터리에서 브로커 인스턴스를 업그레이드합니다../artemis upgrade /var/opt/amq-broker/mybroker
artemis 업그레이드
명령은 브로커를 업그레이드하기 위한 다음 단계를 완료합니다.-
업그레이드할 브로커에 대한 브로커 인스턴스 디렉터리의
old-config-bkp.<n
> 하위 디렉터리에서 수정하는 각 파일의 백업을 만듭니다. -
<
broker_instance_dir> /etc/artemis.profile
파일에서ARTEMIS_HOME
속성을 아카이브를 추출할 때 생성된 새 디렉터리로 설정합니다. -
이전 버전에서 사용된 JBoss Logging 프레임워크 대신 AMQ Broker 7.11.x와 함께 제공되는 Apache Log4j 2 로깅 유틸리티를 사용하도록 <
broker_instance_dir> bin/artemis
스크립트를 업데이트합니다. -
JBoss에서 사용하는 기존 <
broker_instance_dir> /etc/logging.properties
파일을 삭제하고 Apache Log4j 2 로깅 유틸리티에 대한 새 <broker_instance_dir> /etc/log4j2.properties
파일을 생성합니다.
-
업그레이드할 브로커에 대한 브로커 인스턴스 디렉터리의
AMQ Broker에 포함된 Prometheus 지표 플러그인이 7.10.x에서 활성화된 경우 플러그인의 클래스 이름을
org.apache.activemq.artemis.core.server.metrics.plugins.ArtemisPrometheusMetricsPlugin
에서com.redhat.amq.broker.core.server.metrics.plugins.ArtemisPromeusMetrics.server.plugins.ArtemisPromeusMetricsPlugin
에서 변경합니다. AMQ Broker 7.11.x에서 플러그인의 새로운 클래스 이름은 무엇입니까.-
<
;broker_instance_dir> /etc/broker.xml
구성 파일을 엽니다. <
metrics
> 요소의 <plugin> 하위 요소에서 플러그인 클래스 이름을com.redhat.amq.broker.core.server.metrics.plugins.ArtemisPrometheusMetricsPlugin
으로 업데이트합니다.<metrics> <plugin class-name="com.redhat.amq.broker.core.server.metrics.plugins.ArtemisPrometheusMetricsPlugin"/> </metrics>
-
broker.xml
구성 파일을 저장합니다.
-
<
업그레이드된 브로커를 시작합니다.
<broker_instance_dir>/bin/artemis run
(선택 사항) 브로커가 실행 중이고 버전이 변경되었는지 확인합니다. 브로커를 시작한 후 <
broker_instance_dir> /log/artemis.log
파일을 엽니다. 아래 예제와 유사한 행을 찾습니다. 브로커가 시작된 후 로그에 표시되는 새 버전 번호를 확인합니다.2023-02-08 20:53:50,128 INFO [org.apache.activemq.artemis.integration.bootstrap] AMQ101000: Starting ActiveMQ Artemis Server version 2.28.0.redhat-00022 2023-02-08 20:53:51,077 INFO [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.28.0.redhat-00022 [0.0.0.0, nodeID=be02a2b2-3e42-11ec-9b8a-4c796e887ecb]
추가 리소스
- 브로커 인스턴스 생성에 대한 자세한 내용은 브로커 인스턴스 생성을 참조하십시오.
-
브로커 인스턴스의 디렉터리 외부의 위치를 포함하여 모든 사용자 지정 디렉터리에 브로커 인스턴스의 구성 파일 및 데이터를 저장할 수 있습니다. <
broker_instance_dir> /etc/artemis.profile
파일에서 브로커 인스턴스를 생성한 후 사용자 지정 디렉터리의 위치를 지정하여ARTEMIS_INSTANCE_ETC_URI
속성을 업데이트합니다. 이전에는 이러한 구성 파일과 데이터는 브로커 인스턴스의 디렉터리 내의etc/
및data/
디렉터리에만 저장할 수 있었습니다.
2.10.2. Windows에서 7.10.x에서 7.11.x로 업그레이드
사전 요구 사항
- 최소한 AMQ Broker 7.11.x를 실행하려면 Java 버전 11이 필요합니다. 각 AMQ Broker 호스트가 Java 버전 11 이상을 실행하고 있는지 확인합니다. 지원되는 구성에 대한 자세한 내용은 Red Hat AMQ Broker 7 지원 구성을 참조하십시오.
프로세스
- AMQ Broker 아카이브 다운로드에 제공된 지침에 따라 AMQ Broker 아카이브 를 다운로드합니다.
- 파일 관리자를 사용하여 AMQ Broker 마지막 설치 중에 생성한 폴더로 아카이브를 이동합니다.
아카이브 내용을 추출합니다. .zip 파일을 마우스 오른쪽 버튼으로 클릭하고 Extract All 을 선택합니다.
참고최신 아카이브의 내용은 현재 폴더의
apache-artemis-2.28.0.redhat-00022
라는 폴더에 추출됩니다.브로커가 실행 중인 경우 중지합니다.
<broker_instance_dir>\bin\artemis-service.exe stop
(선택 사항) 브로커의 현재 버전을 기록해 둡니다. 브로커가 중지되면 <
broker_instance_dir> \log\artemis.log
파일의 끝에 다음과 유사한 행이 표시됩니다.INFO [org.apache.activemq.artemis.core.server] AMQ221002: Apache ActiveMQ Artemis Message Broker version 2.18.0.redhat-00010[4782d50d-47a2-11e7-a160-9801a793ea45] stopped, uptime 28 minutes
파일 관리자를 사용하여 브로커를 백업합니다.
-
<
broker_instance_dir> 폴더를 마우스
오른쪽 버튼으로 클릭하고 Copy 를 선택합니다. - 동일한 창에서 마우스 오른쪽 버튼으로 클릭하고 Paste 를 선택합니다.
-
<
압축된 아카이브의 내용을 추출한 디렉터리로 변경합니다. 예를 들면 다음과 같습니다.
cd \redhat\amq-broker\apache-artemis-2.28.0.redhat-00022\bin
기존
브로커를 업그레이드
하려면 Artemis upgrade 명령을 실행하십시오. 다음 예제에서는C:\redhat\amq-broker\mybroker
디렉터리에서 broker 인스턴스를 업그레이드합니다.artemis upgrade C:\redhat\amq-broker\mybroker
artemis 업그레이드
명령은 브로커를 업그레이드하기 위한 다음 단계를 완료합니다.-
업그레이드할 브로커에 대한 브로커 인스턴스 디렉터리의
old-config-bkp.<n
> 하위 디렉터리에서 수정하는 각 파일의 백업을 만듭니다. -
<
broker_instance_dir> \etc\artemis.cmd.profile
파일에서ARTEMIS_HOME
속성을 아카이브를 추출할 때 생성된 새 디렉터리로 설정합니다. -
이전 버전에서 사용된 JBoss Logging 프레임워크 대신 AMQ Broker 7.11
.x와 함께 제공되는 Apache Log4j 2 로깅 유틸리티를 사용하도록 <broker_instance_dir> \bin\artemis.cmd
스크립트를 업데이트합니다. -
기존 <
broker_instance_dir> \etc\logging.properties
파일을 JBoss에서 사용하고 Apache Log4j 2 로깅 유틸리티를 위한 새 <broker_instance_dir> \etc\log4j2.properties
파일을 생성합니다.
-
업그레이드할 브로커에 대한 브로커 인스턴스 디렉터리의
AMQ Broker에 포함된 Prometheus 지표 플러그인이 7.10.x에서 활성화된 경우 플러그인의 클래스 이름을
org.apache.activemq.artemis.core.server.metrics.plugins.ArtemisPrometheusMetricsPlugin
에서com.redhat.amq.broker.core.server.metrics.plugins.
7.11.x의 플러그인의 새로운 클래스 이름입니다.-
<
;broker_instance_dir> \etc\broker.xml
구성 파일을 엽니다. <
metrics
> 요소의 <plugin> 하위 요소에서 플러그인 클래스 이름을com.redhat.amq.broker.core.server.metrics.plugins.ArtemisPrometheusMetricsPlugin
으로 업데이트합니다.<metrics> <plugin class-name="com.redhat.amq.broker.core.server.metrics.plugins.ArtemisPrometheusMetricsPlugin"/> </metrics>
-
broker.xml
구성 파일을 저장합니다.
-
<
업그레이드된 브로커를 시작합니다.
<broker_instance_dir>\bin\artemis-service.exe start
(선택 사항) 브로커가 실행 중이고 버전이 변경되었는지 확인합니다. 브로커를 시작한 후 <
broker_instance_dir> \log\artemis.log
파일을 엽니다. 아래 것과 유사한 두 행을 찾습니다. 브로커가 사용 중일 때 로그에 표시되는 새 버전 번호를 확인합니다.2023-02-08 20:53:50,128 INFO [org.apache.activemq.artemis.integration.bootstrap] AMQ101000: Starting ActiveMQ Artemis Server version 2.28.0.redhat-00022 2023-02-08 20:53:51,077 INFO [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.28.0.redhat-00022 [0.0.0.0, nodeID=be02a2b2-3e42-11ec-9b8a-4c796e887ecb]
추가 리소스
- 브로커 인스턴스 생성에 대한 자세한 내용은 브로커 인스턴스 생성을 참조하십시오.
-
브로커 인스턴스의 디렉터리 외부의 위치를 포함하여 모든 사용자 지정 디렉터리에 브로커 인스턴스의 구성 파일 및 데이터를 저장할 수 있습니다. <
broker_instance_dir> \etc\artemis.profile
파일에서 브로커 인스턴스를 생성한 후 사용자 지정 디렉터리의 위치를 지정하여ARTEMIS_INSTANCE_ETC_URI
속성을 업데이트합니다. 이전에는 이러한 구성 파일과 데이터는 브로커 인스턴스의 디렉터리 내의\etc
및\data
디렉터리에만 저장할 수 있었습니다.