AMQ Broker の管理

手順

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=<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.0-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=<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.0-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=<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.0-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=<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. Red Hat カスタマーポータルから必要なアーカイブをダウンロードします。AMQ Broker アーカイブのダウンロード に記載されている手順に従います。

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

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

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

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

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

   su - amq-broker
   cd /opt/redhat
   unzip amq-broker-7.8.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.13.0.redhat-00003 [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.0-redhat-1'

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

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

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

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.16.0.redhat-00007 [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.13.0.redhat-00003 [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=<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\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-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.16.0.redhat-00007 [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-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

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.13.0.redhat-00003 [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-bin'

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

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

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

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

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

    <broker_instance_dir>/bin/artemis run

11. (オプション) ブローカーが実行され、バージョンが変更されたことを確認します。ブローカーを起動したら、<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.18.0.redhat-00010 [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.13.0.redhat-00003 [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=<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\bootstrap.xml 設定ファイルを編集します。web 要素で、7.9 の AMQ 管理コンソールに必要な .war ファイルの名前を更新します。

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

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.18.0.redhat-00010 [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-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

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.18.0.redhat-00010 [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-bin'

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

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

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

1. <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">

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

   <broker_instance_dir>/bin/artemis run

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

手順

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.18.0.redhat-00010[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=<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\bootstrap.xml 設定ファイルを編集します。

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

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

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

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

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">

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

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

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]

手順

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-00019 というディレクトリーに展開されます。

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-00019/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 にバンドルされている 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 のプラグインの新しいクラス名です。

    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 {upstreamversion}.redhat-{build}
    2023-02-08 20:53:51,077 INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version {upstreamversion}.redhat-{build} [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-00019 というフォルダーに展開されます。

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-00019\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 にバンドルされている 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 のプラグインの新しいクラス名です。

   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 {upstreamversion}.redhat-{build}
    2023-02-08 20:53:51,077 INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version {upstreamversion}.redhat-{build} [0.0.0.0, nodeID=be02a2b2-3e42-11ec-9b8a-4c796e887ecb]

手順

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 Protocol を使用している場合、インターセプターは、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. Red Hat Single Sign-On の設定

   1. AMQ 管理コンソールを保護するために使用する Red Hat Single Sign-On のレルムに移動します。Red Hat Single Sign-On の各レルムには、Broker という名前のクライアントが含まれます。このクライアントは AMQ とは関係ありません。
   2. Red Hat Single Sign-On で、artemis-console のような新しいクライアントを作成します。

   3. クライアント設定ページに移動し、次を設定します。

      • AMQ 管理コンソール URL への 有効なリダイレクト URI の後に * が続きます。例を以下に示します。

        https://broker.example.com:8161/console/*

      • Web Origins を Valid Redirect URIs と同じ値にします。Red Hat Single Sign-On では、+ を入力できます。これは、許可される CORS オリジンに Valid Redirect URIs の値が含まれていることを示します。
   4. クライアントのロールを作成します (例:guest)。
   5. AMQ Management Console へのアクセスが必要なすべてのユーザーに上記のロールが割り当てられていることを確認します (たとえば、Red Hat Single Sign-On グループを使用)。

2. AMQ Broker インスタンスを設定します。

   1. <broker-instance-dir>/instances/broker0/etc/login.config ファイルに以下を追加して、AMQ Management Console が Red Hat Single Sign-On を使用するように設定します。

      console {
          org.keycloak.adapters.jaas.BearerTokenLoginModule required
              keycloak-config-file="${artemis.instance}/etc/keycloak-bearer-token.json"
              role-principal-class=org.apache.activemq.artemis.spi.core.security.jaas.RolePrincipal
          ;
      };

      この設定を追加すると、JAAS プリンシパルと、Red Hat Single Sign-On からのベアラートークンの要件が設定されます。次のステップで説明するように、Red Hat Single Sign-On への接続は keycloak-bearer-token.json ファイルで定義されます。

   2. 以下の内容で <broker-instance-dir>/etc/keycloak-bearer-token.json ファイルを作成し、ベアラートークンの交換に使用する Red Hat Single Sign-On への接続を指定します。

      {
        "realm": "<realm-name>",
        "resource": "<client-name>",
        "auth-server-url": "<RHSSO-URL>/auth",
        "principal-attribute": "preferred_username",
        "use-resource-role-mappings": true,
        "ssl-required": "external",
        "confidential-port": 0
      }

      <realm-name>

      Red Hat Single Sign-On のレルムの名前

      <client-name>

      Red Hat Single Sign-On でのクライアントの名前

      <RHSSO-URL>

      Red Hat Single Sign-On の URL

   3. 以下の内容で <broker-instance-dir>/etc/keycloak-js-token.json ファイルを作成し、Red Hat Single Sign-On 認証エンドポイントを指定します。

      {
        "realm": "<realm-name>",
        "clientId": "<client-name>",
        "url": "<RHSSO-URL>/auth"
      }

   4. <broker-instance-dir>/etc/broker.xml ファイルを編集して、セキュリティー設定を行います。

      たとえば、amq ロールを持つユーザーがメッセージを消費できるようにし、guest ロールを持つユーザーがメッセージを送信できるようにするには、以下を追加します。

               <security-setting match="Info">
                  <permission roles="amq" type="createDurableQueue"/>
                  <permission roles="amq" type="deleteDurableQueue"/>
                  <permission roles="amq" type="createNonDurableQueue"/>
                  <permission roles="amq" type="deleteNonDurableQueue"/>
                  <permission roles="guest" type="send"/>
                  <permission roles="amq" type="consume"/>
               </security-setting>

3. AMQ Broker インスタンスを実行し、AMQ 管理コンソールの設定を検証します。

手順

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

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

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

   bind

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

   keyStorePath

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

   keyStorePath="<broker_instance_dir>/etc/keystore.jks"

   keyStorePassword

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

   clientAuth

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

   trustStorePath

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

   trustStorePassword

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

手順

1. 信頼できる認証局からブローカーとクライアントの証明書を取得するか、自己署名証明書を生成します。自己署名証明書を生成する場合は、次の手順を実行します。

   1. ブローカーの自己署名証明書の生成

      $ keytool -storetype pkcs12 -keystore broker-keystore.p12 -storepass securepass -keypass securepass -alias client -genkey -keyalg "RSA" -keysize 2048 -dname "CN=ActiveMQ Broker, OU=Artemis, O=ActiveMQ, L=AMQ, S=AMQ, C=AMQ" -ext bc=ca:false -ext eku=cA

   2. ブローカーキーストアから証明書をエクスポートし、クライアントと共有できるようにします。

      $ keytool -storetype pkcs12 -keystore broker-keystore.p12 -storepass securepass -alias client -exportcert -rfc > broker.crt

   3. クライアントで、ブローカー証明書をクライアントのトラストストアにインポートします。

      $ keytool -storetype pkcs12 -keystore client-truststore.p12 -storepass securepass -keypass securepass -importcert -alias client-ca -file broker.crt -noprompt

   4. クライアントで、クライアントの自己署名証明書を生成します。

      $ keytool -storetype pkcs12 -keystore client-keystore.p12 -storepass securepass -keypass securepass -alias client -genkey -keyalg "RSA" -keysize 2048 -dname "CN=ActiveMQ Client, OU=Artemis, O=ActiveMQ, L=AMQ, S=AMQ, C=AMQ" -ext bc=ca:false -ext eku=cA

   5. クライアント証明書をクライアント鍵ストアからファイルにエクスポートして、ブローカーのトラストストアに追加できるようにします。

      $ keytool -storetype pkcs12 -keystore client-keystore.p12 -storepass securepass -alias client -exportcert -rfc > client.crt

   6. クライアント証明書をブローカーのトラストストアにインポートします。

      $ keytool -storetype pkcs12 -keystore client-truststore.p12 -storepass securepass -keypass securepass -importcert -alias client-ca -file client.crt -noprompt

      注記

      ブローカマシンで、キーストアファイルとトラストストアファイルがブローカからアクセスできる場所にあることを確認します。

2. <broker_instance_dir>/etc/bootstrap.xml ファイルで、Web 設定を更新して、ブローカーコンソールの HTTPS プロトコルとクライアント認証を有効にします。以下に例を示します。

   ...
   <web path="web">
       <binding uri="https://localhost:8161" keyStorePath="${artemis.instance}/etc/server-keystore.p12" keyStorePassword="password"
       clientAuth="true" trustStorePath="${artemis.instance}/etc/client-truststore.p12" trustStorePassword="password">
       ...
       </binding>
   </web>
   ...

   binding uri

   https プロトコルを指定して SSL を有効にし、ホスト名とポートを追加します。

   keystorePath

   ブローカー証明書がインストールされているキーストアへのパス。

   keystorePassword

   ブローカー証明書がインストールされているキーストアのパスワード。

   ClientAuth

   クライアントがブローカーコンソールに接続しようとしたときに各クライアントが証明書を提示することを要求するようにブローカーを設定するには、true に設定します。

   trustStorePath

   クライアントが自己署名証明書を使用している場合は、クライアント証明書がインストールされているトラストストアへのパスを指定します。

   trustStorePassword

   クライアントが自己署名証明書を使用している場合は、クライアント証明書がインストールされているトラストストアのパスワードを指定します。

   注記:クライアントが自己署名証明書を使用している場合にのみ、trustStorePath および trustStorePassword プロパティーを設定する必要があります。

3. 各クライアント証明書からサブジェクト 識別名 (DN) を取得して、各クライアント証明書とブローカーユーザー間のマッピングを作成できるようにします。

   1. 各クライアント証明書をクライアントのキーストアファイルから一時ファイルにエクスポートします。以下に例を示します。

      keytool -export -file <file_name> -alias broker-localhost -keystore broker.ks -storepass <password>

   2. エクスポートされた証明書の内容を出力します。

      keytool -printcert -file <file_name>

      出力は以下のようになります。

      Owner: CN=AMQ Client, OU=Artemis, O=AMQ, L=AMQ, ST=AMQ, C=AMQ
      Issuer: CN=AMQ Client, OU=Artemis, O=AMQ, L=AMQ, ST=AMQ, C=AMQ
      Serial number: 51461f5d
      Valid from: Sun Apr 17 12:20:14 IST 2022 until: Sat Jul 16 12:20:14 IST 2022
      Certificate fingerprints:
      	 SHA1: EC:94:13:16:04:93:57:4F:FD:CA:AD:D8:32:68:A4:13:CC:EA:7A:67
      	 SHA256: 85:7F:D5:4A:69:80:3B:5B:86:27:99:A7:97:B8:E4:E8:7D:6F:D1:53:08:D8:7A:BA:A7:0A:7A:96:F3:6B:98:81

      Owner エントリーは Subject DN です。Subject DN の入力の使用形式はプラットフォームによって異なります。上記の文字列は、以下のように表現することもできます。

      Owner: `CN=localhost,\ OU=broker,\ O=Unknown,\ L=Unknown,\ ST=Unknown,\ C=Unknown`

4. ブローカーのコンソールに対して証明書ベースの認証を有効にします。

   1. <broker_instance_dir>/etc/login.config 設定ファイルを開きます。証明書ログインモジュールを追加し、ユーザーとロールのプロパティーファイルを参照します。以下に例を示します。

      activemq {
          org.apache.activemq.artemis.spi.core.security.jaas.TextFileCertificateLoginModule
              debug=true
              org.apache.activemq.jaas.textfiledn.user="artemis-users.properties"
              org.apache.activemq.jaas.textfiledn.role="artemis-roles.properties";
      };

      org.apache.activemq.artemis.spi.core.security.jaas.TextFileCertificateLoginModule

      実装クラス。

      org.apache.activemq.jaas.textfiledn.user

      ログイン設定ファイルが含まれるディレクトリーを基準としたユーザープロパティーファイルの場所を指定します。

      org.apache.activemq.jaas.textfiledn.role

      ユーザーをログインモジュール実装に定義されたロールにマップするプロパティーファイルを指定します。

      注記

      <broker_instance_dir>/etc/login.config ファイルの証明書ログインモジュール設定のデフォルト名を変更する場合は、<broker_instance_dir>/etc/artemis.profile ファイルの -dhawtio.realm 引数の値を次のように更新する必要があります。新しい名前に合わせます。デフォルト名は activemq です。

   2. <broker_instance_dir>/etc/artemis-users.properties ファイルを開きます。各クライアント証明書から取得したサブジェクト DNS をブローカーユーザーに追加して、クライアント証明書とブローカーユーザー間のマッピングを作成します。以下に例を示します。

      user1=CN=user1,O=Progress,C=US
      user2=CN=user2,O=Progress,C=US

      この例では、user1 ブローカーユーザーは、サブジェクト識別名 CN=user1,O=Progress,C=US サブジェクト DN を持つクライアント証明書にマップされます。クライアント証明書とブローカーユーザー間のマッピングを作成すると、ブローカーは証明書を使用してユーザーを認証できます。

   3. <broker_instance_dir>/etc/artemis-roles.properties ファイルを開きます。<broker_instance_dir>/etc/artemis.profile ファイルの HAWTIO_ROLE 変数に指定されているロールにユーザーを追加して、コンソールにログインする権限をユーザーに付与します。HAWTIO_ROLE 変数のデフォルト値は amq です。以下に例を示します。

      amq=user1, user2

5. HTTPS プロトコルの次の推奨セキュリティープロパティーを設定します。

   1. <broker_instance_dir>/etc/artemis.profile ファイルを開きます。

   2. hawtio.http.strictTransportSecurity プロパティーを設定して、AMQ 管理コンソールへの HTTPS リクエストのみを許可し、すべての HTTP リクエストを HTTPS に変換します。以下に例を示します。

      hawtio.http.strictTransportSecurity = max-age=31536000; includeSubDomains; preload

   3. hawtio.http.publicKeyPins プロパティーを設定して、特定の暗号化公開鍵を AMQ 管理コンソールに関連付けるよう Web ブラウザーに指示し、偽造された証明書を使用した中間者攻撃のリスクを減らします。以下に例を示します。

      hawtio.http.publicKeyPins = pin-sha256="..."; max-age=5184000; includeSubDomains

手順

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

2. <web> 要素に、org.eclipse.jetty.server.ForwardedRequestCustomizer の値を持つ customizer 属性を追加します。以下に例を示します。

   <web path="web" customizer="org.eclipse.jetty.server.ForwardedRequestCustomizer">
   ..
   </web>

3. bootstrap.xml ファイルを保存します。

4. 次のコマンドを入力して、ブローカーを起動または再起動します。

   • Linux の場合: <broker_instance_dir>/bin/artemis run
   • Windows の場合: <broker_instance_dir>\bin\artemis-service.exe start

手順

1. 左側のメニューで Artemis をクリックします。

2. メインペインで、Broker diagram タブをクリックします。

   コンソールは、クラスタートポロジーの図を表示します。これには、図に示すように、クラスター内のすべてのブローカーとローカルブローカーのアドレスおよびキューが含まれます。

   図4.3 ブローカーのダイアグラム タブ

   
3. ダイアグラムに表示される項目を変更するには、ダイアグラムの上部にあるチェックボックスを使用します。Refresh をクリックします。

4. ローカルブローカーの属性、または接続先のアドレスまたはキューの属性を表示するには、ダイアグラムのそのノードをクリックします。たとえば、以下の図は、ローカルブローカーの属性も含まれる図を示しています。

   図4.4 属性を含むブローカーダイアグラム タブ

   

手順

1. 左側のメニューで Artemis をクリックします。
2. フォルダーツリーで、acceptors をクリックします。

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

   コンソールには、図に示すように Attributes タブの対応する属性が表示されます。

   図4.5 AMQP アクセプター属性

   
4. 属性の詳細を表示するには、属性をクリックします。詳細を表示する追加のウィンドウが開きます。

手順

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/management.xml 設定ファイルを開きます。

2. JMX エージェントのコネクターを定義します。connector-port 設定は、jconsole などのクライアントが JMX コネクターサーバーに対してクエリーを実行する RMI レジストリーを確立します。たとえば、ポート 1099 でのリモートアクセスを許可するには、次のようにします。

   <connector connector-port="1099"/>

3. jconsole を使用して、JMX エージェントへの接続を確認します。

   service:jmx:rmi:///jndi/rmi://localhost:1099/jmxrmi

4. 以下で説明するように、コネクターに追加のプロパティーを定義します。

   connector-host

   エージェントを公開するブローカーサーバーホスト。リモートアクセスを防ぐには、connector-host を 127.0.0.1 (localhost) に設定します。

   rmi-registry-port

   JMX RMI コネクターサーバーがバインドするポート。設定されていない場合、ポートは常にランダムです。このプロパティーを設定して、ファイアウォールを通過するリモート JMX 接続の問題を回避します。

   jmx-realm

   認証に使用する JMX レルム。デフォルト値は、JAAS 設定に一致する activemq です。

   object-name

   リモートコネクターを公開するオブジェクト名。デフォルト値は connector:name=rmi です。

   安全な

   コネクターが SSL を使用して保護されているかどうかを指定します。デフォルト値は false です。通信をセキュアにするには、値を true に設定します。

   key-store-path

   キーストアの場所。secured="true" を設定している場合は必須です。

   key-store-password

   キーストアパスワードsecured="true" を設定している場合は必須です。このパスワードは暗号化できます。

   key-store-provider

   キーストアプロバイダー。secured="true" を設定している場合は必須です。デフォルト値は JKS です。

   trust-store-path

   トラストストアの場所。secured="true" を設定している場合は必須です。

   trust-store-password

   トラストストアのパスワードsecured="true" を設定している場合は必須です。このパスワードは暗号化できます。

   trust-store-provider

   トラストストアプロバイダー。secured="true" を設定している場合は必須です。デフォルト値は JKS です。

   password-codec

   使用するパスワードコーデックの完全修飾クラス名。この仕組みの詳細については、以下にリンクされているパスワードマスキングのドキュメントを参照してください。

5. Java Platform ドキュメント に記載されているように、jdk.serialFilter を使用してエンドポイントシリアライゼーションに適切な値を設定します。

手順

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

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

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

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

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

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

   <security-setting-match="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 ミリ秒です。