2.10. ブローカーインスタンスの 7.10.x から 7.11.x へのアップグレード

手順

1. Red Hat カスタマーポータルから必要なアーカイブをダウンロードします。AMQ Broker アーカイブのダウンロード に記載されている手順に従います。

2. ダウンロードしたアーカイブの所有者を、アップグレードする AMQ Broker インストールを所有するのと同じユーザーに変更します。以下の例では、amq-broker というユーザーを設定しています。

   sudo chown amq-broker:amq-broker amq-broker-7.x.x-bin.zip

3. AMQ Broker の元のインストール時に作成されたディレクトリーにアーカイブを移動します。以下の例では、/opt/redhat を使用しています。

   sudo mv amq-broker-7.x.x-bin.zip /opt/redhat

4. ディレクトリーの所有者は、圧縮アーカイブのコンテンツをデプロイメントします。以下の例では、ユーザー amq-broker は unzip コマンドを使用してアーカイブをデプロイメントします。

   su - amq-broker
   cd /opt/redhat
   unzip amq-broker-7.x.x-bin.zip

   注記

   最新のアーカイブの内容は、現在のディレクトリーの apache-artemis-2.28.0.redhat-00022 というディレクトリーに展開されます。

5. ブローカーが実行されている場合は停止します。

   <broker_instance_dir>/bin/artemis stop

6. (オプション) ブローカーの現行バージョンをメモします。ブローカーが停止すると、<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]

7. 現在のユーザーのホームディレクトリーにコピーして、ブローカーのインスタンスディレクトリーをバックアップします。

   cp -r <broker_instance_dir> ~/

8. 圧縮アーカイブの内容を展開したディレクトリーに移動します。

   cd /opt/redhat/apache-artemis-2.28.0.redhat-00022/bin

9. artemis upgrade コマンドを実行して、既存のブローカーをアップグレードします。次の例では、/var/opt/amq-broker/mybroker ディレクトリー内のブローカーインスタンスをアップグレードします。

   ./artemis upgrade /var/opt/amq-broker/mybroker

   artemis upgrade コマンドは、ブローカーをアップグレードするための次の手順を完了します。

   • アップグレードするブローカーのブローカーインスタンスディレクトリーの 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 ファイルを作成します。

10. AMQ Broker に含まれる Prometheus メトリックプラグインが 7.10.x で有効になっている場合は、プラグインのクラス名を org.apache.activemq.artemis.core.server.metrics.plugins.ArtemisPrometheusMetricsPlugin から com.redhat.amq.broker.core.server.metrics.plugins.ArtemisPrometheusMetricsPlugin に変更します。これは AMQ Broker 7.11.x のプラグインの新しいクラス名です。

    1. <broker_instance_dir>/etc/broker.xml 設定ファイルを開きます。

    2. <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>

    3. broker.xml 設定ファイルを保存します。

11. アップグレードされたブローカーを起動します。

    <broker_instance_dir>/bin/artemis run

12. (オプション) ブローカーが実行され、バージョンが変更されたことを確認します。ブローカーを起動したら、<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]

手順

1. AMQ Broker アーカイブのダウンロード に記載されている手順に従って、AMQ Broker アーカイブをダウンロードします。
2. ファイルマネージャーを使用して、アーカイブを AMQ Broker の最後のインストール時に作成したフォルダーに移動します。

3. アーカイブの内容をデプロイメントします。.zip ファイルを右クリックし、Extract All を選択します。

   注記

   最新のアーカイブの内容は、現在のフォルダー内の apache-artemis-2.28.0.redhat-00022 というフォルダーに展開されます。

4. ブローカーが実行されている場合は停止します。

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

5. (オプション) ブローカーの現行バージョンをメモします。ブローカーが停止すると、<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

6. ファイルマネージャーを使用してブローカーをバックアップします。

   1. <broker_instance_dir> フォルダーを右クリックし、Copy を選択します。
   2. 同じウィンドウを右クリックし、Paste を選択します。

7. 圧縮アーカイブの内容を展開したディレクトリーに移動します。以下に例を示します。

   cd \redhat\amq-broker\apache-artemis-2.28.0.redhat-00022\bin

8. artemis upgrade コマンドを実行して、既存のブローカーをアップグレードします。次の例では、C:\redhat\amq-broker\mybroker ディレクトリー内のブローカーインスタンスをアップグレードします。

   artemis upgrade C:\redhat\amq-broker\mybroker

   artemis upgrade コマンドは、ブローカーをアップグレードするための次の手順を完了します。

   • アップグレードするブローカーのブローカーインスタンスディレクトリーの old-config-bkp.<n> サブディレクトリーに変更する各ファイルのバックアップを作成します。
   • <broker_instance_dir>\etc\artemis.cmd.profile ファイル内の ARTEMIS_HOME プロパティーをアーカイブの展開時に作成された新しいディレクトリーに設定します。
   • <broker_instance_dir>\bin\artemis.cmd スクリプトを更新して、以前のバージョンで使用された JBoss Logging フレームワークの代わりに、AMQ Broker 7.11.x にバンドルされている Apache Log4j 2 ログユーティリティーを使用します。
   • JBoss によって使用される既存の <broker_instance_dir>\etc\logging.properties ファイルを削除し、Apache Log4j 2 ログユーティリティー用の新しい <broker_instance_dir>\etc\log4j2.properties ファイルを作成します。

9. AMQ Broker に含まれる Prometheus メトリックプラグインが 7.10.x で有効になっている場合は、プラグインのクラス名を org.apache.activemq.artemis.core.server.metrics.plugins.ArtemisPrometheusMetricsPlugin から com.redhat.amq.broker.core.server.metrics.plugins.ArtemisPrometheusMetricsPlugin に変更します。これは 7.11.x のプラグインの新しいクラス名です。

   1. <broker_instance_dir>\etc\broker.xml 設定ファイルを開きます。

   2. <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>

   3. broker.xml 設定ファイルを保存します。

10. アップグレードされたブローカーを起動します。

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

11. (オプション) ブローカーが実行され、バージョンが変更されたことを確認します。ブローカーを起動した後、<broker_instance_dir>\log\artemis.log ファイルを開きます。以下のような 2 つの行を見つけます。ブローカーの稼働時にログに表示される新しいバージョン番号に注意してください。

    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]