AMQ ブローカーの管理

手順

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

2. アーカイブの所有者を、AMQ Broker インストールが含まれるのと同じユーザーに変更します。

   sudo chown amq-broker:amq-broker jboss-amq-7.x.x.redhat-1.zip

   Copy to Clipboard Toggle word wrap

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

   sudo mv jboss-amq-7.x.x.redhat-1.zip /opt/redhat

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

   BROKER_INSTANCE_DIR/bin/artemis stop

   Copy to Clipboard Toggle word wrap

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

   cp -r BROKER_INSTANCE_DIR ~/

   Copy to Clipboard Toggle word wrap

7. (オプション) ブローカーの現行バージョンをメモします。ブローカーが停止すると、BROKER_INSTANCE_DIR\log\artemis.log にあるログファイルの最後に、以下のような行が表示されます。

   INFO  [org.apache.activemq.artemis.core.server] AMQ221002: Apache ActiveMQ Artemis Message Broker version 2.0.0.amq-700005-redhat-1 [4782d50d-47a2-11e7-a160-9801a793ea45] stopped, uptime 28 minutes

   Copy to Clipboard Toggle word wrap

8. BROKER_INSTANCE_DIR/etc/artemis.profile 設定ファイルを編集して、アーカイブを抽出した際に作成された新しいディレクトリーに ARTEMIS_HOME プロパティーを設定します。

   ARTEMIS_HOME='/opt/redhat/jboss-amq-7.x.x-redhat-1'

   Copy to Clipboard Toggle word wrap

9. 以下のコマンドを入力してブローカーを再起動します。

   BROKER_INSTANCE_DIR/bin/artemis run

   Copy to Clipboard Toggle word wrap

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]

    Copy to Clipboard Toggle word wrap

手順

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

4. 以下のコマンドを入力してブローカーが実行している場合は停止します。

   BROKER_INSTANCE_DIR\bin\artemis-service.exe stop

   Copy to Clipboard Toggle word wrap

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

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

6. (オプション) ブローカーの現行バージョンをメモします。ブローカーが停止すると、以下のような行がログファイルの末尾に表示されます。これは、BROKER_INSTANCE_DIR \log\artemis.log にあります。

   INFO  [org.apache.activemq.artemis.core.server] AMQ221002: Apache ActiveMQ Artemis Message Broker version 2.0.0.amq-700005-redhat-1 [4782d50d-47a2-11e7-a160-9801a793ea45] stopped, uptime 28 minutes

   Copy to Clipboard Toggle word wrap

7. BROKER_INSTANCE_DIR\etc\artemis.profile 設定ファイルを編集して、ARTEMIS_HOME プロパティーをアーカイブの抽出時に作成された新規ディレクトリーに設定します。

   ARTEMIS_HOME=NEW_INSTALL_DIR

   Copy to Clipboard Toggle word wrap

8. 以下のコマンドを入力してブローカーを再起動します。

   BROKER_INSTANCE_DIR\bin\artemis-service.exe start

   Copy to Clipboard Toggle word wrap

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]

   Copy to Clipboard Toggle word wrap

手順

1. 実行中の場合は、アップグレードする 7.0.x ブローカーを停止します。

   $ BROKER_INSTANCE_DIR/bin/artemis stop

   Copy to Clipboard Toggle word wrap

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

   cp -r BROKER_INSTANCE_DIR ~/

   Copy to Clipboard Toggle word wrap

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"

      Copy to Clipboard Toggle word wrap

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

      ARTEMIS_INSTANCE_URI="file://7.0.x_BROKER_INSTANCE_DIR"

      Copy to Clipboard Toggle word wrap

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

      -Djolokia.policyLocation=${ARTEMIS_INSTANCE_URI}/etc/jolokia-access.xml

      Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

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/

      Copy to Clipboard Toggle word wrap

   2. jolokia-access.xml ファイルをコピーします。

      $ cp TEMPORARY_7.1.0_BROKER_INSTANCE_DIR/etc/jolokia-access.xml 7.0_BROKER_INSTANCE_DIR/etc/

      Copy to Clipboard Toggle word wrap

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

      Copy to Clipboard Toggle word wrap

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

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

      Copy to Clipboard Toggle word wrap

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

   $ BROKER_INSTANCE_DIR/bin/artemis run

   Copy to Clipboard Toggle word wrap

手順

1. 実行中の場合は、アップグレードする 7.0.x ブローカーを停止します。

   > BROKER_INSTANCE_DIR\bin\artemis-service.exe stop

   Copy to Clipboard Toggle word wrap

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"

      Copy to Clipboard Toggle word wrap

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

      ARTEMIS_INSTANCE_URI="file://7.0.x_BROKER_INSTANCE_DIR"

      Copy to Clipboard Toggle word wrap

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

      -Djolokia.policyLocation=${ARTEMIS_INSTANCE_URI}/etc/jolokia-access.xml

      Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

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/

      Copy to Clipboard Toggle word wrap

   2. jolokia-access.xml ファイルをコピーします。

      > cp TEMPORARY_7.1.0_BROKER_INSTANCE_DIR/etc/jolokia-access.xml 7.0_BROKER_INSTANCE_DIR/etc/

      Copy to Clipboard Toggle word wrap

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

      Copy to Clipboard Toggle word wrap

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

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

      Copy to Clipboard Toggle word wrap

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

   > BROKER_INSTANCE_DIR\bin\artemis-service.exe start

   Copy to Clipboard Toggle word wrap

手順

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

2. アーカイブの所有者を、AMQ Broker インストールが含まれるのと同じユーザーに変更します。

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

   Copy to Clipboard Toggle word wrap

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

   sudo mv amq-7.x.x.redhat-1.zip /opt/redhat

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

   BROKER_INSTANCE_DIR/bin/artemis stop

   Copy to Clipboard Toggle word wrap

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

   cp -r BROKER_INSTANCE_DIR ~/

   Copy to Clipboard Toggle word wrap

7. (オプション) ブローカーの現行バージョンをメモします。ブローカーが停止すると、BROKER_INSTANCE_DIR\log\artemis.log にあるログファイルの最後に、以下のような行が表示されます。

   INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.5.0.amq-720001-redhat-1 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]

   Copy to Clipboard Toggle word wrap

8. BROKER_INSTANCE_DIR/etc/artemis.profile 設定ファイルを編集して、アーカイブを抽出した際に作成された新しいディレクトリーに ARTEMIS_HOME プロパティーを設定します。

   ARTEMIS_HOME='/opt/redhat/amq-7.x.x-redhat-1'

   Copy to Clipboard Toggle word wrap

9. 以下のコマンドを入力してブローカーを再起動します。

   BROKER_INSTANCE_DIR/bin/artemis run

   Copy to Clipboard Toggle word wrap

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]

    Copy to Clipboard Toggle word wrap

手順

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

4. 以下のコマンドを入力してブローカーが実行している場合は停止します。

   BROKER_INSTANCE_DIR\bin\artemis-service.exe stop

   Copy to Clipboard Toggle word wrap

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

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

6. (オプション) ブローカーの現行バージョンをメモします。ブローカーが停止すると、以下のような行がログファイルの末尾に表示されます。これは、BROKER_INSTANCE_DIR \log\artemis.log にあります。

   INFO  [org.apache.activemq.artemis.core.server] AMQ221002: Apache ActiveMQ Artemis Message Broker version 2.0.0.amq-700005-redhat-1 [4782d50d-47a2-11e7-a160-9801a793ea45] stopped, uptime 28 minutes

   Copy to Clipboard Toggle word wrap

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

   ARTEMIS_HOME=NEW_INSTALL_DIR

   Copy to Clipboard Toggle word wrap

8. 以下のコマンドを入力してブローカーを再起動します。

   BROKER_INSTANCE_DIR\bin\artemis-service.exe start

   Copy to Clipboard Toggle word wrap

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]

   Copy to Clipboard Toggle word wrap

手順

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

2. アーカイブの所有者を、AMQ Broker インストールが含まれるのと同じユーザーに変更します。

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

   Copy to Clipboard Toggle word wrap

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

   sudo mv amq-7.x.x.redhat-1.zip /opt/redhat

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

   BROKER_INSTANCE_DIR/bin/artemis stop

   Copy to Clipboard Toggle word wrap

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

   cp -r BROKER_INSTANCE_DIR ~/

   Copy to Clipboard Toggle word wrap

7. (オプション) ブローカーの現行バージョンをメモします。ブローカーが停止すると、BROKER_INSTANCE_DIR\log\artemis.log にあるログファイルの最後に、以下のような行が表示されます。

   INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.6.3.amq-720001-redhat-1 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]

   Copy to Clipboard Toggle word wrap

8. BROKER_INSTANCE_DIR/etc/artemis.profile 設定ファイルを編集して、アーカイブを抽出した際に作成された新しいディレクトリーに ARTEMIS_HOME プロパティーを設定します。

   ARTEMIS_HOME='/opt/redhat/amq-7.x.x-redhat-1'

   Copy to Clipboard Toggle word wrap

9. 以下のコマンドを入力してブローカーを再起動します。

   BROKER_INSTANCE_DIR/bin/artemis run

   Copy to Clipboard Toggle word wrap

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]

    Copy to Clipboard Toggle word wrap

手順

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

4. 以下のコマンドを入力してブローカーが実行している場合は停止します。

   BROKER_INSTANCE_DIR\bin\artemis-service.exe stop

   Copy to Clipboard Toggle word wrap

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

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

6. (オプション) ブローカーの現行バージョンをメモします。ブローカーが停止すると、以下のような行がログファイルの末尾に表示されます。これは、BROKER_INSTANCE_DIR \log\artemis.log にあります。

   INFO  [org.apache.activemq.artemis.core.server] AMQ221002: Apache ActiveMQ Artemis Message Broker version 2.6.3.amq-720001-redhat-1 [4782d50d-47a2-11e7-a160-9801a793ea45] stopped, uptime 28 minutes

   Copy to Clipboard Toggle word wrap

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

   ARTEMIS_HOME=NEW_INSTALL_DIR

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

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

   Xbootclasspath/a:%ARTEMIS_HOME%\lib\jboss-logmanager-2.0.3.Final-redhat-1.jar

   Copy to Clipboard Toggle word wrap

10. 以下のコマンドを入力してブローカーを再起動します。

    BROKER_INSTANCE_DIR\bin\artemis-service.exe start

    Copy to Clipboard Toggle word wrap

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]

    Copy to Clipboard Toggle word wrap

手順

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

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

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

   su - amq-broker
   cd /opt/redhat
   unzip amq-broker-7.4.x.redhat-1.zip

   Copy to Clipboard Toggle word wrap

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

   BROKER_INSTANCE_DIR/bin/artemis stop

   Copy to Clipboard Toggle word wrap

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

   cp -r BROKER_INSTANCE_DIR ~/

   Copy to Clipboard Toggle word wrap

7. (オプション) ブローカーの現行バージョンをメモします。ブローカーが停止すると、BROKER_INSTANCE_DIR/log/artemis.logファイルの最後に以下のような行が表示されます。

   INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.7.0.redhat-00054 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]

   Copy to Clipboard Toggle word wrap

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

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

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

      Copy to Clipboard Toggle word wrap

   2. ブートストラップクラスパスの引数 Xbootclasspath を JAVA_ARGS に追加します。この引数は、ログマネージャーに依存するファイルを指定します。

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

      Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

10. ブローカーを再起動します。

    BROKER_INSTANCE_DIR/bin/artemis run

    Copy to Clipboard Toggle word wrap

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]

    Copy to Clipboard Toggle word wrap

手順

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

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

   BROKER_INSTANCE_DIR\bin\artemis-service.exe stop

   Copy to Clipboard Toggle word wrap

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

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

6. (オプション) ブローカーの現行バージョンをメモします。ブローカーが停止したら、BROKER_INSTANCE_DIR\log\artemis.log に以下のような行が表示されます。

   INFO  [org.apache.activemq.artemis.core.server] AMQ221002: Apache ActiveMQ Artemis Message Broker version 2.7.0.redhat-00054 [4782d50d-47a2-11e7-a160-9801a793ea45] stopped, uptime 28 minutes

   Copy to Clipboard Toggle word wrap

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

   ARTEMIS_HOME=NEW_INSTALL_DIR

   Copy to Clipboard Toggle word wrap

8. BROKER_INSTANCE_DIR\etc\artemis.profile.cmd 設定ファイルを編集します。JAVA_ARGS の場合、ブートストラップクラスパスの引数 Xbootclasspath のみ を変更します。正しいログマネージャーのバージョンと依存ファイルを指定します。

   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

   Copy to Clipboard Toggle word wrap

9. BROKER_INSTANCE_DIR\bin\artemis-service.xml 設定ファイルを編集します。ブートストラップクラスパスの引数 Xbootclasspath を変更し、正しいログマネージャーバージョンと依存するファイルを指定します。

   <argument>-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</argument>

   Copy to Clipboard Toggle word wrap

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

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

    Copy to Clipboard Toggle word wrap

11. ブローカーを再起動します。

    BROKER_INSTANCE_DIR\bin\artemis-service.exe start

    Copy to Clipboard Toggle word wrap

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]

    Copy to Clipboard Toggle word wrap

手順

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

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

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

   su - amq-broker
   cd /opt/redhat
   unzip amq-broker-7.4.y.redhat-1.zip

   Copy to Clipboard Toggle word wrap

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

   BROKER_INSTANCE_DIR/bin/artemis stop

   Copy to Clipboard Toggle word wrap

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

   cp -r BROKER_INSTANCE_DIR ~/

   Copy to Clipboard Toggle word wrap

7. (オプション) ブローカーの現行バージョンをメモします。ブローカーが停止すると、BROKER_INSTANCE_DIR/log/artemis.logファイルの最後に以下のような行が表示されます。

   INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.7.0.redhat-00054 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

9. ブローカーを再起動します。

   BROKER_INSTANCE_DIR/bin/artemis run

   Copy to Clipboard Toggle word wrap

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]

    Copy to Clipboard Toggle word wrap

手順

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

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

   BROKER_INSTANCE_DIR\bin\artemis-service.exe stop

   Copy to Clipboard Toggle word wrap

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

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

6. (オプション) ブローカーの現行バージョンをメモします。ブローカーが停止したら、BROKER_INSTANCE_DIR\log\artemis.log に以下のような行が表示されます。

   INFO  [org.apache.activemq.artemis.core.server] AMQ221002: Apache ActiveMQ Artemis Message Broker version 2.7.0.redhat-00054 [4782d50d-47a2-11e7-a160-9801a793ea45] stopped, uptime 28 minutes

   Copy to Clipboard Toggle word wrap

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

   ARTEMIS_HOME=NEW_INSTALL_DIR

   Copy to Clipboard Toggle word wrap

8. ブローカーを再起動します。

   BROKER_INSTANCE_DIR\bin\artemis-service.exe start

   Copy to Clipboard Toggle word wrap

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]

   Copy to Clipboard Toggle word wrap

手順

1. テキストエディターで <broker-instance-dir> /etc/jolokia-access.xml ファイルを開きます。

2. < cors&gt; セクション内で allow-origin 設定を編集し、AMQ コンソールへのアクセスを許可する各 URL を追加します。以下に例を示します。

   <cors>
      <!-- allow access to web console from localhost -->
      <allow-origin>https://localhost:8161/*</allow-origin>
      <!-- Check for the proper origin on the server side, too -->
      <strict-checking/>
   </cors>

   Copy to Clipboard Toggle word wrap
3. ファイルを保存します。

手順

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

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

   <web bind="https://localhost:8161"
       path="web"
       keyStorePath="<path_to_KeyStore>"
       keyStorePassword="<password>"
       clientAuth="<true/false>"
       trustStorePath="<path_to_TrustStore>"
       trustStorePassword="<password>">
       ...
   </web>

   Copy to Clipboard Toggle word wrap
   Expand

   属性	説明
   bind	URI スキームを https に変更します。
   keyStorePath	KeyStore ファイルのパス。以下に例を示します。 keyStorePath="${artemis.instance}/etc/keystore.jks" Copy to Clipboard Toggle word wrap
   keyStorePassword	KeyStore のパスワード。
   clientAuth	クライアント認証が必要であるかどうかを指定します。デフォルトは false ですが、これを true に変更して認証を有効にできます。
   trustStorePath	TrustStore ファイルのパス。この属性は、clientAuth が true の場合にのみ必要です。
   trustStorePassword	TrustStore のパスワード。

   Show more

手順

1. AMQ Console で、Dashboard タブをクリックします。

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

   

   View larger image

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

手順

1. AMQ Console で、Dashboard タブをクリックします。

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

   注記

   Manage ページには、既存のダッシュボードの一覧が表示されます。

   

   View larger image

   

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

   Expand

   以下を行う場合	以下を行います​
   新規空のダッシュボードの作成	Create をクリックします。
   既存のダッシュボードと同様のダッシュボードを作成します。	既存のダッシュボードの横にあるチェックボックスをクリックします。 Duplicate をクリックします。

   Show more

4. ダッシュボードの名前を変更するには、以下を実行します。

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

手順

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

手順

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

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

   Dashboard タブが表示され、利用可能なダッシュボードの一覧が表示されます。

3. チャートを表示するダッシュボード（またはダッシュボード）を選択し、Add View to Dashboard を クリックします。チャートが選択したダッシュボードに追加されます。

手順

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

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

   

   View larger image

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

手順

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

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

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

   

   View larger image

   

手順

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

   $ su - amq-broker

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap
3. Open a terminal.

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

   sudo systemctl enable amq-broker

   Copy to Clipboard Toggle word wrap

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

   sudo systemctl start amq-broker

   Copy to Clipboard Toggle word wrap

手順

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

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

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

手順

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

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

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

   Copy to Clipboard Toggle word wrap

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>

   Copy to Clipboard Toggle word wrap

手順

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;
        }
      }

      Copy to Clipboard Toggle word wrap

   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;
        }
      }

      Copy to Clipboard Toggle word wrap

   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;
        }
      }

      Copy to Clipboard Toggle word wrap

   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;
        }
      }

      Copy to Clipboard Toggle word wrap

手順

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>

      Copy to Clipboard Toggle word wrap

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

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

      Copy to Clipboard Toggle word wrap

手順

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

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

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

   Copy to Clipboard Toggle word wrap

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

   注記

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

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

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

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

   Copy to Clipboard Toggle word wrap
   注記

   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>

   Copy to Clipboard Toggle word wrap

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

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

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

   Copy to Clipboard Toggle word wrap

手順

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>

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

   message-counter-max-day-history

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

   message-counter-sample-period

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