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

手順

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

2. アーカイブの所有者を、AMQ Broker インストールが含まれるのと同じユーザーに変更します。以下の例では、amq-broker というユーザーを設定しています。

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

4. ディレクトリー所有者として、圧縮アーカイブの内容を展開します。次の例では、ユーザー amq-broker が unzip コマンドを使用してアーカイブを展開します。

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

   Copy to Clipboard Toggle word wrap

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

   <broker_instance_dir>/bin/artemis stop

   Copy to Clipboard Toggle word wrap

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

   cp -r <broker_instance_dir> ~/

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

8. <broker_instance_dir>/etc/artemis.profile 設定ファイルを編集してください。

   1. アーカイブの抽出時に作成された新しいディレクトリーに ARTEMIS_HOME プロパティーを設定します。以下に例を示します。

      ARTEMIS_HOME='/opt/redhat/amq-broker-7.x.x-bin'

      Copy to Clipboard Toggle word wrap

9. <broker_instance_dir>/etc/bootstrap.xml 設定ファイルを編集します。

   web 要素で、7.10.x の AMQ 管理コンソールに必要な .war ファイルの名前を更新します。

   <web path="web">
       <binding uri="https://localhost:8161"
       ...
       <app url="console" war="hawtio.war"/>
       ...
   </web>

   Copy to Clipboard Toggle word wrap

   broker xmlns 要素で、スキーマ値を "http://activemq.org/schema" から "http://activemq.apache.org/schema" に変更します。

   <broker xmlns="http://activemq.apache.org/schema">

   Copy to Clipboard Toggle word wrap

10. <broker_instance_dir>/etc/management.xml ファイルを編集します。

    management-context xmlns 要素で、スキーマ値を "http://activemq.org/schema" から "http://activemq.apache.org/schema" に変更します。

    <management-context xmlns="http://activemq.apache.org/schema">

    Copy to Clipboard Toggle word wrap

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

    <broker_instance_dir>/bin/artemis run

    Copy to Clipboard Toggle word wrap

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

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

    Copy to Clipboard Toggle word wrap

手順

1. Red Hat カスタマーポータルから必要なアーカイブをダウンロードします。AMQ Broker アーカイブのダウンロード に記載されている手順に従います。
2. ファイルマネージャーを使用して、アーカイブを AMQ Broker の最後のインストール時に作成したフォルダーに移動します。
3. アーカイブの内容を展開します。.zip ファイルを右クリックし、Extract All を選択します。

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

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

   Copy to Clipboard Toggle word wrap

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.18.0.redhat-00010[4782d50d-47a2-11e7-a160-9801a793ea45] stopped, uptime 28 minutes

   Copy to Clipboard Toggle word wrap

7. <broker_instance_dir>\etc\artemis.profile.cmd および <broker_instance_dir>\bin\artemis-service.xml 設定ファイルを編集してください。アーカイブの抽出時に作成された新しいディレクトリーに ARTEMIS_HOME プロパティーを設定します。

   ARTEMIS_HOME=<install_dir>

   Copy to Clipboard Toggle word wrap

8. <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.2.Final-redhat-00002.jar

   Copy to Clipboard Toggle word wrap

9. <broker_instance_dir>\bin\artemis-service.xml 設定ファイルを編集します。以下に示すように、ブートストラップクラスパスの開始引数がログマネージャーおよび依存するファイルの正しいバージョンを参照することを確認します。

   <startargument>-Xbootclasspath/a:%ARTEMIS_HOME%\lib\jboss-logmanager-2.1.10.Final-redhat-00001.jar;%ARTEMIS_HOME%\lib\wildfly-common-1.5.2.Final-redhat-00002.jar</startargument>

   Copy to Clipboard Toggle word wrap

10. <broker_instance_dir>\etc\bootstrap.xml 設定ファイルを編集します。

    web 要素で、7.10.x の AMQ 管理コンソールに必要な .war ファイルの名前を更新します。

    <web path="web">
        <binding uri="https://localhost:8161"
        ...
        <app url="console" war="hawtio.war"/>
        ...
    </web>

    Copy to Clipboard Toggle word wrap

    broker xmlns 要素で、スキーマ値を "http://activemq.org/schema" から "http://activemq.apache.org/schema" に変更します。

    <broker xmlns="http://activemq.apache.org/schema">

    Copy to Clipboard Toggle word wrap

11. <broker_instance_dir>/etc/management.xml ファイルを編集します。

    management-context xmlns 要素で、スキーマ値を "http://activemq.org/schema" から "http://activemq.apache.org/schema" に変更します。

    <management-context xmlns="http://activemq.apache.org/schema">

    Copy to Clipboard Toggle word wrap

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

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

    Copy to Clipboard Toggle word wrap

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

    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.21.0.redhat-00025 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]

    Copy to Clipboard Toggle word wrap