AMQ Broker の管理

手順

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]

手順

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=NEW_INSTALL_DIR

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

   BROKER_INSTANCE_DIR\bin\artemis-service.exe start

9. (オプション) ブローカーが実行され、バージョンが変更されたことを確認します。ブローカーの起動後に、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.1.0.amq-700005-redhat-1 [0.0.0.0, nodeID=4782d50d-47a2-11e7-a160-9801a793ea45]

手順

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. ARTEMIS_HOME プロパティーを更新し、その値が AMQ Broker 7.1.0 のインストールディレクトリーを参照するようにします。

      ARTEMIS_HOME="7.1.0_INSTALL_DIR"

   2. 更新した行の 1 つ下の行で、プロパティー ARTEMIS_INSTANCE_URI を追加して、7.0.x ブローカーインスタンスディレクトリーを参照する値を割り当てます。

      ARTEMIS_INSTANCE_URI="file://7.0.x_BROKER_INSTANCE_DIR"

   3. JAVA_ARGS プロパティーに jolokia.policyLocation パラメーターを追加し、以下の値を割り当てて更新します。

      -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. 以下の 2 つの行をコメントアウトまたは削除します。

      <app url="jolokia" war="jolokia.war"/>
      <app url="hawtio" war="hawtio-no-slf4j.war"/>

   2. 以下の行を追加して、直前の手順で削除された 2 つの行を置き換えます。

      <app url="console" war="console.war"/>

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

   $ BROKER_INSTANCE_DIR/bin/artemis run

手順

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. ARTEMIS_HOME プロパティーを更新し、その値が AMQ Broker 7.1.0 のインストールディレクトリーを参照するようにします。

      ARTEMIS_HOME="7.1.0_INSTALL_DIR"

   2. 更新した行の 1 つ下の行で、プロパティー ARTEMIS_INSTANCE_URI を追加して、7.0.x ブローカーインスタンスディレクトリーを参照する値を割り当てます。

      ARTEMIS_INSTANCE_URI="file://7.0.x_BROKER_INSTANCE_DIR"

   3. JAVA_ARGS プロパティーに jolokia.policyLocation パラメーターを追加し、以下の値を割り当てて更新します。

      -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. 以下の 2 つの行をコメントアウトまたは削除します。

      <app url="jolokia" war="jolokia.war"/>
      <app url="hawtio" war="hawtio-no-slf4j.war"/>

   2. 以下の行を追加して、直前の手順で削除された 2 つの行を置き換えます。

      <app url="console" war="console.war"/>

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

   > BROKER_INSTANCE_DIR\bin\artemis-service.exe start

手順

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]

手順

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=NEW_INSTALL_DIR

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

   BROKER_INSTANCE_DIR\bin\artemis-service.exe start

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

手順

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]

手順

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=NEW_INSTALL_DIR

8. BROKER_INSTANCE_DIR\etc\artemis.profile.cmd 設定ファイルを編集して、JAVA_ARGS 環境変数を設定し、正しいログマネージャーバージョンを参照します。

   JAVA_ARGS=NEW_INSTALL_DIR\lib\jboss-logmanager-2.0.3.Final-redhat-1.jar

9. BROKER_INSTANCE_DIR\bin\artemis-service.xml 設定ファイルを編集して、正しいログマネージャーバージョンを参照するようにブートストラップクラスパスの開始引数を設定します。

   <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 ログファイルを開き、以下のような 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.7.0.redhat-00054 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]

手順

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-broker は unzip コマンドを使用してアーカイブを展開します。

   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. <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. BROKER_INSTANCE_DIR/etc/bootstrap.xml 設定ファイルを編集します。<web> 設定要素で、AMQ Broker の metrics プラグインファイルへの参照を追加します。

   <app url="metrics" war="metrics.war"/>

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

    BROKER_INSTANCE_DIR/bin/artemis run

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

手順

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=NEW_INSTALL_DIR

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.1.Final-redhat-00001.jar

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.1.Final-redhat-00001.jar</startargument>

10. BROKER_INSTANCE_DIR\etc\bootstrap.xml 設定ファイルを編集します。<web> 設定要素で、AMQ Broker の metrics プラグインファイルへの参照を追加します。

    <app url="metrics" war="metrics.war"/>

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

    BROKER_INSTANCE_DIR\bin\artemis-service.exe start

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

手順

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

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

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

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

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

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

   su - amq-broker
   cd /opt/redhat
   unzip amq-broker-7.4.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. <broker_instance_dir>/etc/artemis.profile 設定ファイルを編集してください。アーカイブの抽出時に作成された新しいディレクトリーに ARTEMIS_HOME プロパティーを設定します。

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

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

   BROKER_INSTANCE_DIR/bin/artemis run

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

手順

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=NEW_INSTALL_DIR

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

   BROKER_INSTANCE_DIR\bin\artemis-service.exe start

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

手順

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

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

   sudo chown amq-broker:amq-broker amq-broker-7.5.0.redhat-1.zip

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

   sudo mv amq-broker-7.5.0.redhat-1.zip /opt/redhat

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

   su - amq-broker
   cd /opt/redhat
   unzip amq-broker-7.5.0.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. <broker_instance_dir>/etc/artemis.profile 設定ファイルを編集してください。

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

      ARTEMIS_HOME='/opt/redhat/amq-broker-7.5-redhat-1'

   2. JAVA_ARGS プロパティーを編集します。ログマネージャーに依存するファイルを参照するブートストラップクラスパス引数を追加します。

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

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

   BROKER_INSTANCE_DIR/bin/artemis run

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

手順

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=NEW_INSTALL_DIR

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-00001.jar

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-00001.jar</startargument>

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

    BROKER_INSTANCE_DIR\bin\artemis-service.exe start

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

手順

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

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

   sudo chown amq-broker:amq-broker amq-broker-7.6.0.redhat-1.zip

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

   sudo mv amq-broker-7.6.0.redhat-1.zip /opt/redhat

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

   su - amq-broker
   cd /opt/redhat
   unzip amq-broker-7.6.0.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-00054 [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.6-redhat-1'

   2. JAVA_ARGS プロパティーを編集します。ログマネージャーに依存するファイルを参照するブートストラップクラスパス引数を追加します。

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

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

   BROKER_INSTANCE_DIR/bin/artemis run

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

手順

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.9.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=NEW_INSTALL_DIR

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

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>

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

    BROKER_INSTANCE_DIR\bin\artemis-service.exe start

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

手順

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

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

   sudo chown amq-broker:amq-broker amq-broker-7.7.0.redhat-1.zip

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

   sudo mv amq-broker-7.7.0.redhat-1.zip /opt/redhat

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

   su - amq-broker
   cd /opt/redhat
   unzip amq-broker-7.7.0.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.11.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.7-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/bin/artemis run

11. (オプション) ブローカーが実行され、バージョンが変更されたことを確認します。ブローカーの起動後に、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 Mesq.audit.resource.handlers=AUDIT_FILE
    logger.org.apache.activemq.audit.resource.useParentHandlers=false
    sage Broker version 2.13.0.redhat-00003 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]

手順

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.11.0.redhat-00001 [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=NEW_INSTALL_DIR

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

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>

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

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

    BROKER_INSTANCE_DIR\bin\artemis-service.exe start

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

手順

1. <broker-instance-dir>/etc/bootstrap.xml ファイルを開きます。

2. <web> 要素に以下の属性を追加します。

   <web bind="https://0.0.0.0:8161" path="web">
       ...
       keyStorePath="<path_to_keystore>"
       keyStorePassword="<password>"
       clientAuth="<true/false>"
       trustStorePath="<path_to_truststore>"
       trustStorePassword="<password>">
       ...
   </web>

   bind

   コンソールへのセキュアな接続では、URI スキームを https に変更します。

   keyStorePath

   キーストアファイルのパス。以下に例を示します。

   keyStorePath="<broker-instance-dir>/etc/keystore.jks"

   keyStorePassword

   キーストアのパスワード。このパスワードは暗号化できます。

   clientAuth

   クライアント認証が必要であるかどうかを指定します。デフォルト値は false です。

   trustStorePath

   トラストストアファイルのパス。clientAuth が true に設定されている場合のみ、この属性を定義する必要があります。

   trustStorePassword

   トラストストアのパスワード。このパスワードは暗号化できます。

手順

1. AMQ 管理コンソールで、Dashboard タブをクリックします。

   Monitor ダッシュボードが表示され、hawtio に関するリアルタイムデータが表示されます。

   
2. 別のダッシュボードに切り替えるには、ダッシュボードタブをクリックします。

手順

1. AMQ 管理コンソールで、Dashboard タブをクリックします。

2. ナビゲーションバーで、Manage をクリックします。

   注記

   Manage ページが表示され、既存のダッシュボードのリストが表示されます。

   

3. 次のいずれかを行います。

   次を行う場合:	以下を行います​
   空白のダッシュボードの新規作成	Create をクリックします。
   既存のダッシュボードに似たダッシュボードの作成	既存のダッシュボードの横にあるチェックボックスをクリックします。 複製 をクリックします。

4. ダッシュボードの名前を変更するには:

   1. ダッシュボード名にカーソルを合わせ、鉛筆アイコン ( ) をクリックします。
   2. ダッシュボードの新しい名前を入力し、チェックマークアイコン ( ) をクリックします。

手順

1. 新しいダッシュボードを作成します。
2. AMQ Broker データをダッシュボードに追加します。
3. 必要に応じてダッシュボードのレイアウトを変更します。

手順

1. Artemis タブをクリックします。

2. ナビゲーションバーで、追加 アイコン ( ) をクリックします。

   Dashboard タブが表示され、使用可能なダッシュボードのリストが表示されます。

3. グラフを表示するダッシュボード (複数可) を選択し、Add View To Dashboard をクリックします。選択したダッシュボードにグラフが追加されます。

手順

1. Artemis タブで、Diagram をクリックします。

   この例は、キューが 10 個あるブローカー ３つを示しています。

   
2. ダイアグラムに表示されるオブジェクトを変更するには、View ドロップダウンをクリックして、表示するアイテムを選択します。

手順

1. Artemis タブのフォルダーツリーで、acceptors フォルダーを展開します。

2. アクセプターをクリックして、設定方法の詳細を表示します。

   この例は、AMQP プロトコルに提供されるデフォルトのアクセプターである amqp アクセプターの設定プロパティーを示しています。

   

手順

1. インストール時に作成したユーザーのアカウントに切り替えます。

   $ su - amq-broker

2. artemis run コマンドを使用してブローカーインスタンスを起動します。

   $ /var/opt/amq-broker/mybroker/bin/artemis run
   
             __  __  ____    ____            _
       /\   |  \/  |/ __ \  |  _ \          | |
      /  \  | \  / | |  | | | |_) |_ __ ___ | | _____ _ __
     / /\ \ | |\/| | |  | | |  _ <| '__/ _ \| |/ / _ \ '__|
    / ____ \| |  | | |__| | | |_) | | | (_) |   <  __/ |
   /_/    \_\_|  |_|\___\_\ |____/|_|  \___/|_|\_\___|_|
   
   Red Hat JBoss AMQ 7.2.1.GA
   
   10:53:43,959 INFO  [org.apache.activemq.artemis.integration.bootstrap] AMQ101000: Starting ActiveMQ Artemis Server
   10:53:44,076 INFO  [org.apache.activemq.artemis.core.server] AMQ221000: live Message Broker is starting with configuration Broker Configuration (clustered=false,journalDirectory=./data/journal,bindingsDirectory=./data/bindings,largeMessagesDirectory=./data/large-messages,pagingDirectory=./data/paging)
   10:53:44,099 INFO  [org.apache.activemq.artemis.core.server] AMQ221012: Using AIO Journal
   ...

   ブローカーが起動し、以下の情報が含まれるログ出力が表示されます。

   • トランザクションログとクラスター設定の場所。
   • メッセージの永続性に使用されるジャーナルのタイプ (この場合は AIO)。

   • クライアント接続を許可できる URI。

     デフォルトでは、ポート 61616 はサポートされるプロトコル (CORE、MQTT、AMQP、STOMP、HORNETQ、および OPENWIRE) からの接続を受け入れることができます。各プロトコルには個別のポートもあります。

   • Web コンソールは、http://localhost:8161 から入手できます。
   • Jolokia サービス (JMX over REST) には、http://localhost:8161/jolokia からアクセスできます。

手順

1. /etc/systemd/system/ ディレクトリーに amq-broker.service ファイルを新規に作成します。

2. 以下のテキストをファイルにコピーします。

   ブローカーインスタンスの作成時に提供される情報に応じて、パスおよびユーザーフィールドを変更します。以下の例では、ユーザー amq-broker が、/var/opt/amq-broker/mybroker/ ディレクトリーの下にインストールされたブローカーサービスを起動します。

   [Unit]
   Description=AMQ Broker
   After=syslog.target network.target
   
   [Service]
   ExecStart=/var/opt/amq-broker/mybroker/bin/artemis run
   Restart=on-failure
   User=amq-broker
   Group=amq-broker
   
   # A workaround for Java signal handling
   SuccessExitStatus=143
   
   [Install]
   WantedBy=multi-user.target

3. 端末を開きます。

4. 以下のコマンドを使用してブローカーサービスを有効にします。

   sudo systemctl enable amq-broker

5. 以下のコマンドを使用してブローカーサービスを実行します。

   sudo systemctl start amq-broker

手順

1. コマンドプロンプトを開いてコマンドを入力する

2. 以下のコマンドを使用して、ブローカーをサービスとしてインストールします。

   <broker-instance-dir>\bin\artemis-service.exe install

3. 以下のコマンドを使用してサービスを起動します。

   <broker-instance-dir>\bin\artemis-service.exe start

4. (オプション) サービスをアンインストールします。

   <broker-instance-dir>\bin\artemis-service.exe uninstall

手順

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

2. graceful-shutdown-enabled 設定要素を追加し、値を true に設定します。

   <configuration>
        <core>
             ...
             <graceful-shutdown-enabled>
                 true
             </graceful-shutdown-enabled>
             ...
        </core>
   </configuration>

3. graceful-shutdown-timeout 設定要素を追加し、タイムアウトの値をミリ秒単位で設定します。以下の例では、stop コマンドが実行されてから 30 秒 (30000 ミリ秒) 後に、クライアント接続が強制的に閉じられます。

   <configuration>
        <core>
             ...
             <graceful-shutdown-enabled>
                 true
             </graceful-shutdown-enabled>
             <graceful-shutdown-timeout>
                 30000
             </graceful-shutdown-timeout>
             ...
        </core>
   </configuration>

手順

1. 適切なインターフェイスを実装し、その intercept() メソッドをオーバーライドします。

   1. AMQP プロトコルを使用している場合は、org.apache.activemq.artemis.protocol.amqp.broker.AmqpInterceptor インターフェイスを実装してください。

      package com.example;
      
      import org.apache.activemq.artemis.protocol.amqp.broker.AMQPMessage;
      import org.apache.activemq.artemis.protocol.amqp.broker.AmqpInterceptor;
      import org.apache.activemq.artemis.spi.core.protocol.RemotingConnection;
      
      public class MyInterceptor implements AmqpInterceptor
      {
        private final int ACCEPTABLE_SIZE = 1024;
      
        @Override
        public boolean intercept(final AMQPMessage message, RemotingConnection connection)
        {
          int size = message.getEncodeSize();
          if (size <= ACCEPTABLE_SIZE) {
            System.out.println("This AMQPMessage has an acceptable size.");
            return true;
          }
          return false;
        }
      }

   2. Core プロトコルを使用している場合は、インターセプターは、org.apache.artemis.activemq.api.core.Interceptor インターフェイスを実装する必要があります。

      package com.example;
      
      import org.apache.artemis.activemq.api.core.Interceptor;
      import org.apache.activemq.artemis.core.protocol.core.Packet;
      import org.apache.activemq.artemis.spi.core.protocol.RemotingConnection;
      
      public class MyInterceptor implements Interceptor
      {
        private final int ACCEPTABLE_SIZE = 1024;
      
        @Override
        boolean intercept(Packet packet, RemotingConnection connection)
        throws ActiveMQException
        {
          int size = packet.getPacketSize();
          if (size <= ACCEPTABLE_SIZE) {
            System.out.println("This Packet has an acceptable size.");
            return true;
          }
          return false;
        }
      }

   3. MQTT プロトコルを使用している場合は、org.apache.activemq.artemis.core.protocol.mqtt.MQTTInterceptor インターフェイスを実装してください。

      package com.example;
      
      import org.apache.activemq.artemis.core.protocol.mqtt.MQTTInterceptor;
      import io.netty.handler.codec.mqtt.MqttMessage;
      import org.apache.activemq.artemis.spi.core.protocol.RemotingConnection;
      
      public class MyInterceptor implements Interceptor
      {
        private final int ACCEPTABLE_SIZE = 1024;
      
        @Override
        boolean intercept(MqttMessage mqttMessage, RemotingConnection connection)
        throws ActiveMQException
        {
          byte[] msg = (mqttMessage.toString()).getBytes();
          int size = msg.length;
          if (size <= ACCEPTABLE_SIZE) {
            System.out.println("This MqttMessage has an acceptable size.");
            return true;
          }
          return false;
        }
      }

   4. STOMP プロトコルを使用している場合は、org.apache.activemq.artemis.core.protocol.stomp.StompFrameInterceptor インターフェイスを実装してください。

      package com.example;
      
      import org.apache.activemq.artemis.core.protocol.stomp.StompFrameInterceptor;
      import org.apache.activemq.artemis.core.protocol.stomp.StompFrame;
      import org.apache.activemq.artemis.spi.core.protocol.RemotingConnection;
      
      public class MyInterceptor implements Interceptor
      {
        private final int ACCEPTABLE_SIZE = 1024;
      
        @Override
        boolean intercept(StompFrame stompFrame, RemotingConnection connection)
        throws ActiveMQException
        {
          int size = stompFrame.getEncodedSize();
          if (size <= ACCEPTABLE_SIZE) {
            System.out.println("This StompFrame has an acceptable size.");
            return true;
          }
          return false;
        }
      }

手順

1. <broker-instance-dir>/etc/broker.xml を開きます

2. _<broker-instance-dir>/etc/broker.xml に設定を追加して、インターセプターを使用するようにブローカーを設定します。

   1. インターセプターが着信メッセージを対象としている場合は、その class-name を remoting-incoming-interceptors のリストに追加します。

      <configuration>
        <core>
          ...
          <remoting-incoming-interceptors>
             <class-name>org.example.MyIncomingInterceptor</class-name>
          </remoting-incoming-interceptors>
          ...
        </core>
      </configuration>

   2. インターセプターが発信メッセージを対象としている場合は、その class-name を remoting-outgoing-interceptors のリストに追加します。

      <configuration>
        <core>
          ...
          <remoting-outgoing-interceptors>
             <class-name>org.example.MyOutgoingInterceptor</class-name>
          </remoting-outgoing-interceptors>
        </core>
      </configuration>

手順

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

2. <jmx-management-enabled> を設定します。

   <jmx-management-enabled>true</jmx-management-enabled>

   JMX が有効になっている場合、ブローカーは jconsole を使用してローカルで管理できます。

   注記

   セキュリティー上の理由から、JMX へのリモート接続はデフォルトで有効になっていません。

3. 同じ MBeanServer から複数のブローカーを管理する場合は、各ブローカーに JMX ドメインを設定します。

   デフォルトでは、ブローカーは JMX ドメイン org.apache.activemq.artemis を使用します。

   <jmx-domain>my.org.apache.activemq</jmx-domain>

   注記

   Windows システムで AMQ Broker を使用している場合は、artemis または artemis.cmd でシステムプロパティーを設定する必要があります。シェルスクリプトは <install-dir>/bin にあります。

手順

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

2. <management-address> 要素を追加し、管理アドレスを指定します。

   デフォルトでは、管理アドレスは queue.activemq.management です。デフォルトを使用しない場合は、別のアドレスを指定する必要があります。

   <management-address>my.management.address</management-address>

3. 管理アドレスに manage ユーザーパーミッションタイプを指定します。

   このパーミッションタイプにより、管理アドレスの管理メッセージが受信および処理できるようになります。

   <security-setting-match="queue.activemq.management">
       <permission-type="manage" roles="admin"/>
   </security-setting>

手順

1. QueueRequestor を作成して、管理アドレスにメッセージを送信し、返信を受信します。
2. Message を作成します。
3. ヘルパークラス org.apache.activemq.artemis.api.jms.management.JMSManagementHelper を使用して、メッセージに管理プロパティーを記入します。
4. QueueRequestor を使ってメッセージを送信します。
5. ヘルパークラス org.apache.activemq.artemis.api.jms.management.JMSManagementHelper を使用して、管理応答から操作結果を取得します。

手順

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

2. メッセージカウンターを有効にします。

   <message-counter-enabled>true</message-counter-enabled>

3. メッセージカウンター履歴およびサンプリング期間を設定します。

   <message-counter-max-day-history>7</message-counter-max-day-history>
   <message-counter-sample-period>60000</message-counter-sample-period>

   message-counter-max-day-history

   キューメトリクスを保存する必要のある日数。デフォルトは 10 日です。

   message-counter-sample-period

   メトリクスを収集するためにブローカーがキューをサンプリングする頻度 (ミリ秒単位)。デフォルトは 10000 ミリ秒 (10 秒) です。