1.9. 長期サポートバージョン間のブローカーインスタンスのアップグレード

手順

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

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

   sudo chown amq-broker:amq-broker amq-broker-7.8.x.redhat-1.zip

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

   sudo mv amq-broker-7.8.x.redhat-1.zip /opt/redhat

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

   su - amq-broker
   cd /opt/redhat
   unzip amq-broker-7.8.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.9.0.redhat-00001 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]

8. BROKER_INSTANCE_DIR/etc/artemis.profile 設定ファイルを編集します。

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

      ARTEMIS_HOME='/opt/redhat/amq-broker-7.8.x-redhat-1'

   2. JAVA_ARGSプロパティを探します。以下に示すように、ブートストラップクラスパスの引数が、ログマネージャーの依存するファイルに必要なバージョンを参照することを確認します。

      -Xbootclasspath/a:$ARTEMIS_HOME/lib/wildfly-common-1.5.2.Final-redhat-00002.jar

9. BROKER_INSTANCE_DIR/etc/logging.properties 設定ファイルを編集します。

   1. 設定する追加のロガーのリストに、AMQ Broker 7.7.0 で追加されたorg.apache.activemq.audit.resourceリソースロガーを含めます。

      loggers=org.eclipse.jetty,org.jboss.logging,org.apache.activemq.artemis.core.server,org.apache.activemq.artemis.utils,org.apache.activemq.artemis.journal,org.apache.activemq.artemis.jms.server,org.apache.activemq.artemis.integration.bootstrap,org.apache.activemq.audit.base,org.apache.activemq.audit.message,org.apache.activemq.audit.resource

   2. Console ハンドラー設定 セクションの前に、リソースロガーのデフォルト設定を追加します。

      ..
      
      logger.org.apache.activemq.audit.resource.level=ERROR
      logger.org.apache.activemq.audit.resource.handlers=AUDIT_FILE
      logger.org.apache.activemq.audit.resource.useParentHandlers=false
      
      # Console handler configuration
      ..

10. BROKER_INSTANCE_DIR/etc/bootstrap.xml 設定ファイルを編集します。web 要素で、7.8 の AMQ 管理コンソールに必要な .war ファイルの名前を更新します。

    <web bind="http://localhost:8161" path="web">
        ...
        <app url="console" war="hawtio.war"/>
        ...
    </web>

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

    BROKER_INSTANCE_DIR/bin/artemis run

12. （オプション）ブローカーが実行され、バージョンが変更されたことを確認します。ブローカーの起動後に、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.16.0.redhat-00012 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]