AMQ Broker の管理
AMQ Broker 7.7 向け
概要
第1章 ブローカーのアップグレード
1.1. アップグレードについて
Red Hat は、AMQ Broker の新しいバージョンを カスタマーポータル にリリースします。ブローカーを最新バージョンに更新し、最新の機能強化および修正があることを確認します。通常、Red Hat は AMQ Broker の新バージョンを以下の 3 つの方法でリリースします。
- メジャーリリース
- AMQ Broker 6 から AMQ Broker 7 など、アプリケーションがあるメジャーリリースから次のメジャーリリースに移行する場合は、メジャーアップグレードまたは移行が必要です。この種のアップグレードについては、本書では扱いません。これまでの AMQ Broker リリースからアップグレードする方法は、Migrating to Red Hat AMQ 7を参照してください。
- マイナーリリース
- AMQ Broker では、マイナーリリースを定期的に提供します。マイナーリリースは、新機能やバグ修正が含まれる更新です。AMQ Broker マイナーリリースを別のリリースにアップグレードする計画がある場合 (AMQ Broker 7.0 から AMQ Broker 7.1 など)、プライベート、サポートされていない、またはテクノロジープレビューコンポーネントを使用しないアプリケーションには、コードの変更は必要ありません。
- マイクロリリース
- AMQ Broker は、マイナーな機能強化および修正が含まれるマイクロリリースを定期的に提供します。マイクロリリースは、7.0.1 から 7.0.2 など、最後の数字のマイナーリリースバージョンを増分します。マイクロリリースはコードの変更を必要としませんが、一部のリリースには設定の変更が必要になる場合があります。
1.2. ブローカーインスタンスの 7.0.x から 7.0.y へのアップグレード
AMQ Broker を別のバージョン 7.0 にアップグレードする手順は、インストール用の手順と類似しています。カスタマーポータルからアーカイブをダウンロードして展開します。
以下のサブセクションでは、異なるオペレーティングシステムの 7.0.x ブローカーをアップグレードする方法を説明します。
1.2.1. Linux の 7.0.x から 7.0.y へのアップグレード
ダウンロードするアーカイブの名前は、以下の例で使用されているものとは異なる場合があります。
前提条件
AMQ Broker をアップグレードする前に、ターゲットリリースのリリースノートを確認してください。
本リリースノートでは、ターゲットリリースにおける重要な機能拡張、既知の問題、および動作の変更を説明します。
詳細は、AMQ Broker 7.0 リリースノート を参照してください。
手順
- AMQ Broker アーカイブのダウンロード の手順に従って、Red Hat カスタマーポータルから必要なアーカイブを ダウンロードします。
アーカイブの所有者を、AMQ Broker インストールが含まれるのと同じユーザーに変更します。
sudo chown amq-broker:amq-broker jboss-amq-7.x.x.redhat-1.zip
AMQ Broker の元のインストール時に作成されたディレクトリーにアーカイブを移動します。以下の例では、
/opt/redhat
というディレクトリーを使用しています。sudo mv jboss-amq-7.x.x.redhat-1.zip /opt/redhat
ディレクトリーの所有者は、圧縮アーカイブのコンテンツを展開します。アーカイブは圧縮形式で保持されます。以下の例では、ユーザー
amq-broker
は unzip コマンドを使用してアーカイブを展開します。su - amq-broker cd /opt/redhat unzip jboss-amq-7.x.x.redhat-1.zip
ブローカーが実行している場合は停止します。
BROKER_INSTANCE_DIR/bin/artemis stop
現在のユーザーのホームディレクトリーにコピーして、ブローカーのインスタンスディレクトリーをバックアップします。
cp -r BROKER_INSTANCE_DIR ~/
(オプション) ブローカーの現行バージョンをメモします。ブローカーが停止すると、
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
BROKER_INSTANCE_DIR/etc/artemis.profile
設定ファイルを編集して、アーカイブを抽出した際に作成された新しいディレクトリーにARTEMIS_HOME
プロパティーを設定します。ARTEMIS_HOME='/opt/redhat/jboss-amq-7.x.x-redhat-1'
アップグレードされたブローカーを起動します。
BROKER_INSTANCE_DIR/bin/artemis run
(オプション) ブローカーが実行され、バージョンが変更されたことを確認します。ブローカーを起動した後、ログファイル
BROKER_INSTANCE_DIR\log\artemis.log
を開くと、以下のような行があります。ブローカーの稼働後にログに表示される新しいバージョン番号に注意してください。INFO [org.apache.activemq.artemis.core.server] AMQ221007: Server is now live ... INFO [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.1.0.amq-700005-redhat-1 [0.0.0.0, nodeID=4782d50d-47a2-11e7-a160-9801a793ea45]
1.2.2. Windows の 7.0.x から 7.0.y へのアップグレード
前提条件
AMQ Broker をアップグレードする前に、ターゲットリリースのリリースノートを確認してください。
本リリースノートでは、ターゲットリリースにおける重要な機能拡張、既知の問題、および動作の変更を説明します。
詳細は、AMQ Broker 7.0 リリースノート を参照してください。
手順
- AMQ Broker アーカイブのダウンロード の手順に従って、Red Hat カスタマーポータルから必要なアーカイブを ダウンロードします。
- ファイルマネージャーを使用して、アーカイブを AMQ Broker の最後のインストール時に作成したフォルダーに移動します。
- zip ファイルを右クリックし、Extract All を選択して、ファイルの内容をディレクトリーに展開します。
以下のコマンドを入力してブローカーが実行している場合は停止します。
BROKER_INSTANCE_DIR\bin\artemis-service.exe stop
ファイルマネージャーを使用してブローカーをバックアップします。
- BROKER_INSTANCE_DIR フォルダーを右クリックし、Copy を選択します。
- 同じウィンドウを右クリックし、Paste を選択します。
(オプション) ブローカーの現行バージョンをメモします。ブローカーが停止すると、以下のような行がログファイルの末尾に表示されます。これは、
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
BROKER_INSTANCE_DIR\etc\artemis.profile
設定ファイルを編集して、ARTEMIS_HOME
プロパティーをアーカイブの抽出時に作成された新規ディレクトリーに設定します。ARTEMIS_HOME=
NEW_INSTALL_DIR
アップグレードされたブローカーを起動します。
BROKER_INSTANCE_DIR\bin\artemis-service.exe start
(オプション) ブローカーが実行され、バージョンが変更されたことを確認します。ブローカーの起動後に、
BROKER_INSTANCE_DIR\log\artemis.log
ログファイルを開き、以下のような 2 つの行を見つけます。ブローカーの稼働後にログに表示される新しいバージョン番号に注意してください。INFO [org.apache.activemq.artemis.core.server] AMQ221007: Server is now live ... INFO [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.1.0.amq-700005-redhat-1 [0.0.0.0, nodeID=4782d50d-47a2-11e7-a160-9801a793ea45]
1.3. ブローカーインスタンスの 7.0.x から 7.1.0 へのアップグレード
AMQ Broker 7.1.0 には、以前のバージョンに含まれていない設定ファイルおよび設定が含まれています。ブローカーインスタンスを 7.0.x から 7.1.0 にアップグレードするには、これらの新しいファイルおよび設定を既存の 7.0.x ブローカーインスタンスに追加する必要があります。以下のサブセクションでは、異なるオペレーティングシステムの 7.0.x ブローカーインスタンスを 7.1.0 にアップグレードする方法を説明します。
AMQ Broker 7.1.0 以降では、デフォルトでローカルホストからのみ AMQ 管理コンソールにアクセスできます。リモートアクセスを有効にするには、BROKER_INSTANCE_DIR/etc/jolokia-access.xml
の設定を変更する必要があります。詳細は、AMQ 管理コンソールと AMQ ブローカ接続の保護 を参照してください。
1.3.1. Linux での 7.0.x から 7.1.0 へのアップグレード
7.0.x ブローカーをアップグレードする前に、Red Hat AMQ Broker 7.1.0 をインストールし、一時的なブローカーインスタンスを作成する必要があります。これにより、7.0.x ブローカーのアップグレードに必要な 7.1.0 設定ファイルが生成されます。
前提条件
AMQ Broker をアップグレードする前に、ターゲットリリースのリリースノートを確認してください。
本リリースノートでは、ターゲットリリースにおける重要な機能拡張、既知の問題、および動作の変更を説明します。
詳細は、AMQ Broker 7.1 リリースノート を参照してください。
7.0.x ブローカーをアップグレードする前に、最初にバージョン 7.1 をインストールする必要があります。
Linux に 7.1 をインストールする手順は、Installing AMQ Broker を参照してください。
手順
実行中の場合は、アップグレードする 7.0.x ブローカーを停止します。
$ BROKER_INSTANCE_DIR/bin/artemis stop
現在のユーザーのホームディレクトリーにコピーして、ブローカーのインスタンスディレクトリーをバックアップします。
cp -r BROKER_INSTANCE_DIR ~/
7.0.x ブローカーの
BROKER_INSTANCE_DIR/etc/
ディレクトリーにあるartemis.profile
ファイルを開きます。ARTEMIS_HOME
プロパティーを更新し、その値が AMQ Broker 7.1.0 のインストールディレクトリーを参照するようにします。ARTEMIS_HOME="7.1.0_INSTALL_DIR"
更新した行の 1 つ下の行で、プロパティー
ARTEMIS_INSTANCE_URI
を追加して、7.0.x ブローカーインスタンスディレクトリーを参照する値を割り当てます。ARTEMIS_INSTANCE_URI="file://7.0.x_BROKER_INSTANCE_DIR"
JAVA_ARGS
プロパティーにjolokia.policyLocation
パラメーターを追加し、以下の値を割り当てて更新します。-Djolokia.policyLocation=${ARTEMIS_INSTANCE_URI}/etc/jolokia-access.xml
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
一時的な 7.1.0 インスタンスの
etc
ディレクトリーから、7.0.x ブローカーのBROKER_INSTANCE_DIR/etc/
ディレクトリーに設定ファイルをコピーします。management.xml
ファイルをコピーします。$ cp TEMPORARY_7.1.0_BROKER_INSTANCE_DIR/etc/management.xml 7.0_BROKER_INSTANCE_DIR/etc/
jolokia-access.xml
ファイルをコピーします。$ cp TEMPORARY_7.1.0_BROKER_INSTANCE_DIR/etc/jolokia-access.xml 7.0_BROKER_INSTANCE_DIR/etc/
7.0.x ブローカーの
BROKER_INSTANCE_DIR/etc/
ディレクトリーにあるbootstrap.xml
ファイルを開きます。以下の 2 つの行をコメントアウトまたは削除します。
<app url="jolokia" war="jolokia.war"/> <app url="hawtio" war="hawtio-no-slf4j.war"/>
以下の行を追加して、直前の手順で削除された 2 つの行を置き換えます。
<app url="console" war="console.war"/>
アップグレードしたブローカーを起動します。
$ BROKER_INSTANCE_DIR/bin/artemis run
関連情報
ブローカーのインスタンス作成に関する詳細は、ブローカーインスタンスの作成を参照してください。
1.3.2. Windows での 7.0.x から 7.1.0 へのアップグレード
7.0.x ブローカーをアップグレードする前に、Red Hat AMQ Broker 7.1.0 をインストールし、一時的なブローカーインスタンスを作成する必要があります。これにより、7.0.x ブローカーのアップグレードに必要な 7.1.0 設定ファイルが生成されます。
前提条件
AMQ Broker をアップグレードする前に、ターゲットリリースのリリースノートを確認してください。
本リリースノートでは、ターゲットリリースにおける重要な機能拡張、既知の問題、および動作の変更を説明します。
詳細は、AMQ Broker 7.1 リリースノート を参照してください。
7.0.x ブローカーをアップグレードする前に、最初にバージョン 7.1 をインストールする必要があります。
Windows に 7.1 をインストールする手順は、Installing AMQ Broker を参照してください。
手順
実行中の場合は、アップグレードする 7.0.x ブローカーを停止します。
> BROKER_INSTANCE_DIR\bin\artemis-service.exe stop
ファイルマネージャーを使用してブローカーのインスタンスディレクトリーをバックアップします。
- BROKER_INSTANCE_DIR フォルダーを右クリックし、Copy を選択します。
- 同じウィンドウを右クリックし、Paste を選択します。
7.0.x ブローカーの
BROKER_INSTANCE_DIR/etc/
ディレクトリーにあるartemis.profile
ファイルを開きます。ARTEMIS_HOME
プロパティーを更新し、その値が AMQ Broker 7.1.0 のインストールディレクトリーを参照するようにします。ARTEMIS_HOME="7.1.0_INSTALL_DIR"
更新した行の 1 つ下の行で、プロパティー
ARTEMIS_INSTANCE_URI
を追加して、7.0.x ブローカーインスタンスディレクトリーを参照する値を割り当てます。ARTEMIS_INSTANCE_URI="file://7.0.x_BROKER_INSTANCE_DIR"
JAVA_ARGS
プロパティーにjolokia.policyLocation
パラメーターを追加し、以下の値を割り当てて更新します。-Djolokia.policyLocation=${ARTEMIS_INSTANCE_URI}/etc/jolokia-access.xml
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
一時的な 7.1.0 インスタンスの
etc
ディレクトリーから、7.0.x ブローカーのBROKER_INSTANCE_DIR/etc/
ディレクトリーに設定ファイルをコピーします。management.xml
ファイルをコピーします。> cp TEMPORARY_7.1.0_BROKER_INSTANCE_DIR/etc/management.xml 7.0_BROKER_INSTANCE_DIR/etc/
jolokia-access.xml
ファイルをコピーします。> cp TEMPORARY_7.1.0_BROKER_INSTANCE_DIR/etc/jolokia-access.xml 7.0_BROKER_INSTANCE_DIR/etc/
7.0.x ブローカーの
BROKER_INSTANCE_DIR/etc/
ディレクトリーにあるbootstrap.xml
ファイルを開きます。以下の 2 つの行をコメントアウトまたは削除します。
<app url="jolokia" war="jolokia.war"/> <app url="hawtio" war="hawtio-no-slf4j.war"/>
以下の行を追加して、直前の手順で削除された 2 つの行を置き換えます。
<app url="console" war="console.war"/>
アップグレードしたブローカーを起動します。
> BROKER_INSTANCE_DIR\bin\artemis-service.exe start
関連情報
ブローカーのインスタンス作成に関する詳細は、ブローカーインスタンスの作成を参照してください。
1.4. ブローカーインスタンスの 7.1.x から 7.2.0 へのアップグレード
AMQ Broker 7.2.0 には、7.0.x バージョンに含まれていない設定ファイルおよび設定が含まれています。7.0.x インスタンスを実行している場合は、最初にこれらのブローカーインスタンスを 7.0.x から 7.1.0 にアップグレードしてから 7.2.5.0 にアップグレードする必要があります。以下のサブセクションでは、異なるオペレーティングシステムの 7.1.x ブローカーインスタンスを 7.2.0 にアップグレードする方法を説明します。
AMQ Broker 7.1.0 以降では、デフォルトでローカルホストからのみ AMQ 管理コンソールにアクセスできます。リモートアクセスを有効にするには、BROKER_INSTANCE_DIR/etc/jolokia-access.xml
の設定を変更する必要があります。詳細は、AMQ 管理コンソールと AMQ ブローカ接続の保護 を参照してください。
1.4.1. Linux での 7.1.x から 7.2.0 へのアップグレード
ダウンロードするアーカイブの名前は、以下の例で使用されているものとは異なる場合があります。
手順
- AMQ Broker アーカイブのダウンロード の手順に従って、Red Hat カスタマーポータルから必要なアーカイブを ダウンロードします。
アーカイブの所有者を、AMQ Broker インストールが含まれるのと同じユーザーに変更します。
sudo chown amq-broker:amq-broker amq-7.x.x.redhat-1.zip
AMQ Broker の元のインストール時に作成されたディレクトリーにアーカイブを移動します。以下の例では、
/opt/redhat
というディレクトリーを使用しています。sudo mv amq-7.x.x.redhat-1.zip /opt/redhat
ディレクトリーの所有者は、圧縮アーカイブのコンテンツを展開します。以下の例では、ユーザー
amq-broker
は unzip コマンドを使用してアーカイブを展開します。su - amq-broker cd /opt/redhat unzip jboss-amq-7.x.x.redhat-1.zip
ブローカーが実行している場合は停止します。
BROKER_INSTANCE_DIR/bin/artemis stop
現在のユーザーのホームディレクトリーにコピーして、ブローカーのインスタンスディレクトリーをバックアップします。
cp -r BROKER_INSTANCE_DIR ~/
(オプション) ブローカーの現行バージョンをメモします。ブローカーが停止すると、
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]
BROKER_INSTANCE_DIR/etc/artemis.profile
設定ファイルを編集して、アーカイブを抽出した際に作成された新しいディレクトリーにARTEMIS_HOME
プロパティーを設定します。ARTEMIS_HOME='/opt/redhat/amq-7.x.x-redhat-1'
アップグレードされたブローカーを起動します。
BROKER_INSTANCE_DIR/bin/artemis run
(オプション) ブローカーが実行され、バージョンが変更されたことを確認します。ブローカーを起動した後、ログファイル
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]
関連情報
- ブローカーのインスタンス作成に関する詳細は、ブローカーインスタンスの作成を参照してください。
-
ブローカーインスタンスの設定ファイルおよびデータを、ブローカーインスタンスのディレクトリー外の場所を含む、カスタムディレクトリーに格納できるようになりました。
BROKER_INSTANCE_DIR/etc/artemis.profile
ファイルで、ブローカーインスタンスの作成後のカスタムディレクトリーの場所を指定し、ARTEMIS_INSTANCE_ETC_URI
プロパティーを更新します。以前のバージョンでは、これらの設定ファイルとデータは、ブローカーインスタンスのディレクトリー内のetc/
ディレクトリーおよびdata/
ディレクトリーにのみ保存できました。
1.4.2. Windows での 7.1.x から 7.2.0 へのアップグレード
手順
- AMQ Broker アーカイブのダウンロード の手順に従って、Red Hat カスタマーポータルから必要なアーカイブを ダウンロードします。
- ファイルマネージャーを使用して、アーカイブを AMQ Broker の最後のインストール時に作成したフォルダーに移動します。
- zip ファイルを右クリックし、Extract All を選択して、ファイルの内容をディレクトリーに展開します。
以下のコマンドを入力してブローカーが実行している場合は停止します。
BROKER_INSTANCE_DIR\bin\artemis-service.exe stop
ファイルマネージャーを使用してブローカーをバックアップします。
- BROKER_INSTANCE_DIR フォルダーを右クリックし、Copy を選択します。
- 同じウィンドウを右クリックし、Paste を選択します。
(オプション) ブローカーの現行バージョンをメモします。ブローカーが停止すると、以下のような行がログファイルの末尾に表示されます。これは、
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
BROKER_INSTANCE_DIR\etc\artemis.profile.cmd
およびBROKER_INSTANCE_DIR\bin\artemis-service.xml
設定ファイルを編集して、アーカイブを抽出した際に作成された新しいディレクトリーに、ARTEMIS_HOME
プロパティーを設定します。ARTEMIS_HOME=
NEW_INSTALL_DIR
アップグレードされたブローカーを起動します。
BROKER_INSTANCE_DIR\bin\artemis-service.exe start
(オプション) ブローカーが実行され、バージョンが変更されたことを確認します。ブローカーの起動後に、
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]
関連情報
- ブローカーのインスタンス作成に関する詳細は、ブローカーインスタンスの作成を参照してください。
-
ブローカーインスタンスの設定ファイルおよびデータを、ブローカーインスタンスのディレクトリー外の場所を含む、カスタムディレクトリーに格納できるようになりました。
BROKER_INSTANCE_DIR\etc\artemis.profile
ファイルで、ブローカーインスタンスの作成後にカスタムディレクトリーの場所を指定して、ARTEMIS_INSTANCE_ETC_URI
プロパティーを更新します。以前のバージョンでは、これらの設定ファイルとデータは、ブローカーインスタンスのディレクトリー内の\etc
ディレクトリーおよび\data
ディレクトリーにのみ保存できました。
1.5. ブローカーインスタンスの 7.2.x から 7.3.0 へのアップグレード
以下のサブセクションでは、異なるオペレーティングシステムの 7.2.x ブローカーインスタンスを 7.3.0 にアップグレードする方法を説明します。
1.5.1. 非推奨のディスパッチコンソールによる例外の解決
7.3.0 以降、AMQ Broker には Hawtio ディスパッチコンソールプラグインである dispatch-hawtio-console.war
は同梱されなくなりました。以前のバージョンでは、AMQ Interconnect の管理にディスパッチコンソールを使用していました。ただし、AMQ Interconnect は独自のスタンドアロン Web コンソールを使用するようになりました。この変更は、以降のセクションのアップグレード手順に影響します。
ブローカーインスタンスを 7.3.0 にアップグレードする前に追加のアクションを実行すると、アップグレードプロセスにより以下のような例外が生成されます。
2019-04-11 18:00:41,334 WARN [org.eclipse.jetty.webapp.WebAppContext] Failed startup of context o.e.j.w.WebAppContext@1ef3efa8{/dispatch-hawtio-console,null,null}{/opt/amqbroker/amq-broker-7.3.0/web/dispatch-hawtio-console.war}: java.io.FileNotFoundException: /opt/amqbroker/amq-broker-7.3.0/web/dispatch-hawtio-console.war.
アップグレードの成功に影響を及ぼすことなく、前述の例外を無視しても問題ありません。
ただし、アップグレード中にこの例外が表示されないようにする場合は、最初に既存のブローカーインスタンスの bootstrap.xml
ファイルで Hawtio ディスパッチコンソールプラグインへの参照を削除する必要があります。bootstrap.xml
ファイルは、ブローカーインスタンスの {instance_directory}/etc/
ディレクトリーにあります。以下の例は、AMQ Broker 7.2.4 インスタンスの bootstrap.xml
ファイルの内容の一部を示しています。
<broker xmlns="http://activemq.org/schema"> .... <!-- The web server is only bound to localhost by default --> <web bind="http://localhost:8161" path="web"> <app url="redhat-branding" war="redhat-branding.war"/> <app url="artemis-plugin" war="artemis-plugin.war"/> <app url="dispatch-hawtio-console" war="dispatch-hawtio-console.war"/> <app url="console" war="console.war"/> </web> </broker>
AMQ Broker をバージョン 7.3.0 にアップグレードする際に例外を回避するには、前述の例のように <app url="dispatch-hawtio-console" war="dispatch-hawtio-console.war"/>
の行を削除します。次に、後続のセクションで説明されているように、変更したブートストラップファイルを保存し、アップグレードプロセスを開始します。
AMQ Broker 7.1.0 以降では、デフォルトでローカルホストからのみ AMQ 管理コンソールにアクセスできます。リモートアクセスを有効にするには、BROKER_INSTANCE_DIR/etc/jolokia-access.xml
の設定を変更する必要があります。詳細は、AMQ 管理コンソールと AMQ ブローカ接続の保護 を参照してください。
1.5.2. Linux での 7.2.x から 7.3.0 へのアップグレード
ダウンロードするアーカイブの名前は、以下の例で使用されているものとは異なる場合があります。
手順
- AMQ Broker アーカイブのダウンロード の手順に従って、Red Hat カスタマーポータルから必要なアーカイブを ダウンロードします。
アーカイブの所有者を、AMQ Broker インストールが含まれるのと同じユーザーに変更します。
sudo chown amq-broker:amq-broker amq-7.x.x.redhat-1.zip
AMQ Broker の元のインストール時に作成されたディレクトリーにアーカイブを移動します。以下の例では、
/opt/redhat
というディレクトリーを使用しています。sudo mv amq-7.x.x.redhat-1.zip /opt/redhat
ディレクトリーの所有者は、圧縮アーカイブのコンテンツを展開します。以下の例では、ユーザー
amq-broker
は unzip コマンドを使用してアーカイブを展開します。su - amq-broker cd /opt/redhat unzip jboss-amq-7.x.x.redhat-1.zip
ブローカーが実行している場合は停止します。
BROKER_INSTANCE_DIR/bin/artemis stop
現在のユーザーのホームディレクトリーにコピーして、ブローカーのインスタンスディレクトリーをバックアップします。
cp -r BROKER_INSTANCE_DIR ~/
(オプション) ブローカーの現行バージョンをメモします。ブローカーが停止すると、
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]
BROKER_INSTANCE_DIR/etc/artemis.profile
設定ファイルを編集して、アーカイブを抽出した際に作成された新しいディレクトリーにARTEMIS_HOME
プロパティーを設定します。ARTEMIS_HOME='/opt/redhat/amq-7.x.x-redhat-1'
アップグレードされたブローカーを起動します。
BROKER_INSTANCE_DIR/bin/artemis run
(オプション) ブローカーが実行され、バージョンが変更されたことを確認します。ブローカーを起動した後、ログファイル
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]
関連情報
- ブローカーのインスタンス作成に関する詳細は、ブローカーインスタンスの作成を参照してください。
-
ブローカーインスタンスの設定ファイルおよびデータを、ブローカーインスタンスのディレクトリー外の場所を含む、カスタムディレクトリーに格納できるようになりました。
BROKER_INSTANCE_DIR/etc/artemis.profile
ファイルで、ブローカーインスタンスの作成後のカスタムディレクトリーの場所を指定し、ARTEMIS_INSTANCE_ETC_URI
プロパティーを更新します。以前のバージョンでは、これらの設定ファイルとデータは、ブローカーインスタンスのディレクトリー内のetc/
ディレクトリーおよびdata/
ディレクトリーにのみ保存できました。
1.5.3. Windows での 7.2.x から 7.3.0 へのアップグレード
手順
- AMQ Broker アーカイブのダウンロード の手順に従って、Red Hat カスタマーポータルから必要なアーカイブを ダウンロードします。
- ファイルマネージャーを使用して、アーカイブを AMQ Broker の最後のインストール時に作成したフォルダーに移動します。
- zip ファイルを右クリックし、Extract All を選択して、ファイルの内容をディレクトリーに展開します。
以下のコマンドを入力してブローカーが実行している場合は停止します。
BROKER_INSTANCE_DIR\bin\artemis-service.exe stop
ファイルマネージャーを使用してブローカーをバックアップします。
- BROKER_INSTANCE_DIR フォルダーを右クリックし、Copy を選択します。
- 同じウィンドウを右クリックし、Paste を選択します。
(オプション) ブローカーの現行バージョンをメモします。ブローカーが停止すると、以下のような行がログファイルの末尾に表示されます。これは、
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
BROKER_INSTANCE_DIR\etc\artemis.profile.cmd
およびBROKER_INSTANCE_DIR\bin\artemis-service.xml
設定ファイルを編集して、アーカイブを抽出した際に作成された新しいディレクトリーに、ARTEMIS_HOME
プロパティーを設定します。ARTEMIS_HOME=
NEW_INSTALL_DIR
BROKER_INSTANCE_DIR\etc\artemis.profile.cmd
設定ファイルを編集して、JAVA_ARGS 環境変数を設定し、正しいログマネージャーバージョンを参照します。JAVA_ARGS=
NEW_INSTALL_DIR\lib\jboss-logmanager-2.0.3.Final-redhat-1.jar
BROKER_INSTANCE_DIR\bin\artemis-service.xml
設定ファイルを編集して、正しいログマネージャーバージョンを参照するようにブートストラップクラスパスの開始引数を設定します。<startargument>Xbootclasspath/a:%ARTEMIS_HOME%\lib\jboss-logmanager-2.0.3.Final-redhat-1.jar</startargument>
アップグレードされたブローカーを起動します。
BROKER_INSTANCE_DIR\bin\artemis-service.exe start
(オプション) ブローカーが実行され、バージョンが変更されたことを確認します。ブローカーの起動後に、
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]
関連情報
- ブローカーのインスタンス作成に関する詳細は、ブローカーインスタンスの作成を参照してください。
-
ブローカーインスタンスの設定ファイルおよびデータを、ブローカーインスタンスのディレクトリー外の場所を含む、カスタムディレクトリーに格納できるようになりました。
BROKER_INSTANCE_DIR\etc\artemis.profile
ファイルで、ブローカーインスタンスの作成後にカスタムディレクトリーの場所を指定して、ARTEMIS_INSTANCE_ETC_URI
プロパティーを更新します。以前のバージョンでは、これらの設定ファイルとデータは、ブローカーインスタンスのディレクトリー内の\etc
ディレクトリーおよび\data
ディレクトリーにのみ保存できました。
1.6. ブローカーインスタンスの 7.3.0 から 7.4.0 へのアップグレード
以下のサブセクションでは、異なるオペレーティングシステムの 7.3.0 ブローカーインスタンスを 7.4.0 にアップグレードする方法を説明します。
AMQ Broker 7.1.0 以降では、デフォルトでローカルホストからのみ AMQ 管理コンソールにアクセスできます。リモートアクセスを有効にするには、BROKER_INSTANCE_DIR/etc/jolokia-access.xml
の設定を変更する必要があります。詳細は、AMQ 管理コンソールと AMQ ブローカ接続の保護 を参照してください。
1.6.1. Linux での 7.3.0 から 7.4.0 へのアップグレード
ダウンロードするアーカイブの名前は、以下の例で使用されているものとは異なる場合があります。
手順
- Red Hat カスタマーポータルから必要なアーカイブをダウンロードします。AMQ Broker アーカイブのダウンロード に記載されている手順に従います。
アーカイブの所有者を、AMQ Broker インストールが含まれるのと同じユーザーに変更します。以下の例では、
amq-broker
というユーザーを設定しています。sudo chown amq-broker:amq-broker amq-broker-7.x.x.redhat-1.zip
AMQ Broker の元のインストール時に作成されたディレクトリーにアーカイブを移動します。以下の例では、
/opt/redhat
を使用しています。sudo mv amq-broker-7.x.x.redhat-1.zip /opt/redhat
ディレクトリーの所有者は、圧縮アーカイブのコンテンツを展開します。以下の例では、ユーザー
amq-broker
はunzip
コマンドを使用してアーカイブを展開します。su - amq-broker cd /opt/redhat unzip amq-broker-7.x.x.redhat-1.zip
ブローカーが実行されている場合は停止します。
BROKER_INSTANCE_DIR/bin/artemis stop
現在のユーザーのホームディレクトリーにコピーして、ブローカーのインスタンスディレクトリーをバックアップします。
cp -r BROKER_INSTANCE_DIR ~/
(オプション) ブローカーの現行バージョンをメモします。ブローカーが停止すると、
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]
<broker_instance_dir>/etc/artemis.profile
設定ファイルを編集してください。アーカイブの抽出時に作成された新しいディレクトリーに
ARTEMIS_HOME
プロパティーを設定します。ARTEMIS_HOME='/opt/redhat/amq-broker-7.x.x-redhat-1'
JAVA_ARGS
プロパティーを編集します。ログマネージャーに依存するファイルを参照するブートストラップクラスパス引数を追加します。-Xbootclasspath/a:$ARTEMIS_HOME/lib/wildfly-common-1.5.1.Final-redhat-00001.jar
BROKER_INSTANCE_DIR/etc/bootstrap.xml
設定ファイルを編集します。<web>
設定要素で、AMQ Broker の metrics プラグインファイルへの参照を追加します。<app url="metrics" war="metrics.war"/>
アップグレードされたブローカーを起動します。
BROKER_INSTANCE_DIR/bin/artemis run
(オプション) ブローカーが実行され、バージョンが変更されたことを確認します。ブローカーの起動後に、
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]
関連情報
- ブローカーのインスタンス作成に関する詳細は、ブローカーインスタンスの作成を参照してください。
-
ブローカーインスタンスの設定ファイルおよびデータを、ブローカーインスタンスのディレクトリー外の場所を含む、カスタムディレクトリーに格納できるようになりました。
BROKER_INSTANCE_DIR/etc/artemis.profile
ファイルで、ブローカーインスタンスの作成後のカスタムディレクトリーの場所を指定し、ARTEMIS_INSTANCE_ETC_URI
プロパティーを更新します。以前のバージョンでは、これらの設定ファイルとデータは、ブローカーインスタンスのディレクトリー内のetc/
ディレクトリーおよびdata/
ディレクトリーにのみ保存できました。
1.6.2. Windows での 7.3.0 から 7.4.0 へのアップグレード
手順
- Red Hat カスタマーポータルから必要なアーカイブをダウンロードします。AMQ Broker アーカイブのダウンロード に記載されている手順に従います。
- ファイルマネージャーを使用して、アーカイブを AMQ Broker の最後のインストール時に作成したフォルダーに移動します。
- ファイルの内容をインストールディレクトリーに展開します。.zip ファイルを右クリックし、Extract All を選択します。
ブローカーが実行されている場合は停止します。
BROKER_INSTANCE_DIR\bin\artemis-service.exe stop
ファイルマネージャーを使用してブローカーをバックアップします。
- BROKER_INSTANCE_DIR フォルダーをクリックします。Copy を選択します。
- 同じウィンドウを右クリックします。Paste を選択します。
(オプション) ブローカーの現行バージョンをメモします。ブローカーが停止したら、
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
BROKER_INSTANCE_DIR\etc\artemis.profile.cmd
とBROKER_INSTANCE_DIR\bin\artemis-service.xml
設定ファイルを編集します。アーカイブの抽出時に作成された新しいディレクトリーにARTEMIS_HOME
プロパティーを設定します。ARTEMIS_HOME=
NEW_INSTALL_DIR
BROKER_INSTANCE_DIR\etc\artemis.profile.cmd
設定ファイルを編集します。適切なログマネージャーバージョンと依存するファイルを参照するように JAVA_ARGS 環境変数を設定します。JAVA_ARGS=
-Xbootclasspath/%ARTEMIS_HOME%\lib\jboss-logmanager-2.1.10.Final-redhat-00001.jar;%ARTEMIS_HOME%\lib\wildfly-common-1.5.1.Final-redhat-00001.jar
BROKER_INSTANCE_DIR\bin\artemis-service.xml
設定ファイルを編集します。正しいログマネージャーバージョンと依存するファイルを参照するように、ブートストラップクラスパスの開始引数を設定します。<startargument>-Xbootclasspath/a:%ARTEMIS_HOME%\lib\jboss-logmanager-2.1.10.Final-redhat-00001.jar;%ARTEMIS_HOME%\lib\wildfly-common-1.5.1.Final-redhat-00001.jar</startargument>
BROKER_INSTANCE_DIR\etc\bootstrap.xml
設定ファイルを編集します。<web>
設定要素で、AMQ Broker の metrics プラグインファイルへの参照を追加します。<app url="metrics" war="metrics.war"/>
アップグレードされたブローカーを起動します。
BROKER_INSTANCE_DIR\bin\artemis-service.exe start
(オプション) ブローカーが実行され、バージョンが変更されたことを確認します。ブローカーの起動後に、
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]
関連情報
- ブローカーのインスタンス作成に関する詳細は、ブローカーインスタンスの作成を参照してください。
-
ブローカーインスタンスの設定ファイルおよびデータを、ブローカーインスタンスのディレクトリー外の場所を含む、カスタムディレクトリーに格納できるようになりました。
BROKER_INSTANCE_DIR\etc\artemis.profile
ファイルで、ブローカーインスタンスの作成後にカスタムディレクトリーの場所を指定して、ARTEMIS_INSTANCE_ETC_URI
プロパティーを更新します。以前のバージョンでは、これらの設定ファイルとデータは、ブローカーインスタンスのディレクトリー内の\etc
ディレクトリーおよび\data
ディレクトリーにのみ保存できました。
1.7. ブローカーインスタンスの 7.4.0 から 7.4.x へのアップグレード
AMQ Broker 7.4 は、Long Term Support (LTS) リリースバージョンとして指定されています。バグ修正およびセキュリティーアドバイザリーは、少なくとも 12 カ月間、一連のマイクロリリース (7.4.1、7.4.2 など) で AMQ Broker 7.4 で利用可能になります。つまり、新しいマイナーリリースにアップグレードしなくても、AMQ Broker の最新のバグ修正およびセキュリティーアドバイザリーを取得できます。詳細は、Long Term Support for AMQ Brokerを参照してください。
AMQ Broker 7.1.0 以降では、デフォルトでローカルホストからのみ AMQ 管理コンソールにアクセスできます。リモートアクセスを有効にするには、BROKER_INSTANCE_DIR/etc/jolokia-access.xml
の設定を変更する必要があります。詳細は、AMQ 管理コンソールと AMQ ブローカ接続の保護 を参照してください。
以下のサブセクションでは、異なるオペレーティングシステムの 7.4.0 ブローカーインスタンスを 7.4.x にアップグレードする方法を説明します。
1.7.1. Linux 上の 7.4.0 から 7.4.x へのアップグレード
ダウンロードするアーカイブの名前は、以下の例で使用されているものとは異なる場合があります。
手順
- Red Hat カスタマーポータルから必要なアーカイブをダウンロードします。AMQ Broker アーカイブのダウンロード に記載されている手順に従います。
アーカイブの所有者を、AMQ Broker インストールが含まれるのと同じユーザーに変更します。以下の例では、
amq-broker
というユーザーを設定しています。sudo chown amq-broker:amq-broker amq-broker-7.4.x.redhat-1.zip
AMQ Broker の元のインストール時に作成されたディレクトリーにアーカイブを移動します。以下の例では、
/opt/redhat
を使用しています。sudo mv amq-broker-7.4.x.redhat-1.zip /opt/redhat
ディレクトリーの所有者は、圧縮アーカイブのコンテンツを展開します。以下の例では、ユーザー
amq-broker
はunzip
コマンドを使用してアーカイブを展開します。su - amq-broker cd /opt/redhat unzip amq-broker-7.4.x.redhat-1.zip
ブローカーが実行されている場合は停止します。
BROKER_INSTANCE_DIR/bin/artemis stop
現在のユーザーのホームディレクトリーにコピーして、ブローカーのインスタンスディレクトリーをバックアップします。
cp -r BROKER_INSTANCE_DIR ~/
(オプション) ブローカーの現行バージョンをメモします。ブローカーが停止すると、
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]
<broker_instance_dir>/etc/artemis.profile
設定ファイルを編集してください。アーカイブの抽出時に作成された新しいディレクトリーにARTEMIS_HOME
プロパティーを設定します。ARTEMIS_HOME='/opt/redhat/amq-broker-7.4.x-redhat-1'
アップグレードされたブローカーを起動します。
BROKER_INSTANCE_DIR/bin/artemis run
(オプション) ブローカーが実行され、バージョンが変更されたことを確認します。ブローカーの起動後に、
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]
関連情報
- ブローカーのインスタンス作成に関する詳細は、ブローカーインスタンスの作成を参照してください。
-
ブローカーインスタンスの設定ファイルおよびデータを、ブローカーインスタンスのディレクトリー外の場所を含む、カスタムディレクトリーに格納できるようになりました。
BROKER_INSTANCE_DIR/etc/artemis.profile
ファイルで、ブローカーインスタンスの作成後のカスタムディレクトリーの場所を指定し、ARTEMIS_INSTANCE_ETC_URI
プロパティーを更新します。以前のバージョンでは、これらの設定ファイルとデータは、ブローカーインスタンスのディレクトリー内のetc/
ディレクトリーおよびdata/
ディレクトリーにのみ保存できました。
1.7.2. Windows 上の 7.4.0 から 7.4.x へのアップグレード
手順
- Red Hat カスタマーポータルから必要なアーカイブをダウンロードします。AMQ Broker アーカイブのダウンロード に記載されている手順に従います。
- ファイルマネージャーを使用して、アーカイブを AMQ Broker の最後のインストール時に作成したフォルダーに移動します。
- ファイルの内容をインストールディレクトリーに展開します。.zip ファイルを右クリックし、Extract All を選択します。
ブローカーが実行されている場合は停止します。
BROKER_INSTANCE_DIR\bin\artemis-service.exe stop
ファイルマネージャーを使用してブローカーをバックアップします。
- BROKER_INSTANCE_DIR フォルダーをクリックします。Copy を選択します。
- 同じウィンドウを右クリックします。Paste を選択します。
(オプション) ブローカーの現行バージョンをメモします。ブローカーが停止したら、
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
BROKER_INSTANCE_DIR\etc\artemis.profile.cmd
とBROKER_INSTANCE_DIR\bin\artemis-service.xml
設定ファイルを編集します。アーカイブの抽出時に作成された新しいディレクトリーにARTEMIS_HOME
プロパティーを設定します。ARTEMIS_HOME=
NEW_INSTALL_DIR
アップグレードされたブローカーを起動します。
BROKER_INSTANCE_DIR\bin\artemis-service.exe start
(オプション) ブローカーが実行され、バージョンが変更されたことを確認します。ブローカーの起動後に、
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]
関連情報
- ブローカーのインスタンス作成に関する詳細は、ブローカーインスタンスの作成を参照してください。
-
ブローカーインスタンスの設定ファイルおよびデータを、ブローカーインスタンスのディレクトリー外の場所を含む、カスタムディレクトリーに格納できるようになりました。
BROKER_INSTANCE_DIR\etc\artemis.profile
ファイルで、ブローカーインスタンスの作成後にカスタムディレクトリーの場所を指定して、ARTEMIS_INSTANCE_ETC_URI
プロパティーを更新します。以前のバージョンでは、これらの設定ファイルとデータは、ブローカーインスタンスのディレクトリー内の\etc
ディレクトリーおよび\data
ディレクトリーにのみ保存できました。
1.8. ブローカーインスタンスの 7.4.x から 7.5.0 へのアップグレード
以下のサブセクションでは、異なるオペレーティングシステムの 7.4.x ブローカーインスタンスを 7.5.0 にアップグレードする方法を説明します。
AMQ Broker 7.1.0 以降では、デフォルトでローカルホストからのみ AMQ 管理コンソールにアクセスできます。リモートアクセスを有効にするには、BROKER_INSTANCE_DIR/etc/jolokia-access.xml
の設定を変更する必要があります。詳細は、AMQ 管理コンソールと AMQ ブローカ接続の保護 を参照してください。
1.8.1. Linux での 7.4.x から 7.5.0 へのアップグレード
ダウンロードするアーカイブの名前は、以下の例で使用されているものとは異なる場合があります。
手順
- Red Hat カスタマーポータルから必要なアーカイブをダウンロードします。AMQ Broker アーカイブのダウンロード に記載されている手順に従います。
アーカイブの所有者を、AMQ Broker インストールが含まれるのと同じユーザーに変更します。以下の例では、
amq-broker
というユーザーを設定しています。sudo chown amq-broker:amq-broker amq-broker-7.5.0.redhat-1.zip
AMQ Broker の元のインストール時に作成されたディレクトリーにアーカイブを移動します。以下の例では、
/opt/redhat
を使用しています。sudo mv amq-broker-7.5.0.redhat-1.zip /opt/redhat
ディレクトリーの所有者は、圧縮アーカイブのコンテンツを展開します。以下の例では、ユーザー
amq-broker
はunzip
コマンドを使用してアーカイブを展開します。su - amq-broker cd /opt/redhat unzip amq-broker-7.5.0.redhat-1.zip
ブローカーが実行されている場合は停止します。
BROKER_INSTANCE_DIR/bin/artemis stop
現在のユーザーのホームディレクトリーにコピーして、ブローカーのインスタンスディレクトリーをバックアップします。
cp -r BROKER_INSTANCE_DIR ~/
(オプション) ブローカーの現行バージョンをメモします。ブローカーが停止すると、
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]
<broker_instance_dir>/etc/artemis.profile
設定ファイルを編集してください。アーカイブの抽出時に作成された新しいディレクトリーに
ARTEMIS_HOME
プロパティーを設定します。ARTEMIS_HOME='/opt/redhat/amq-broker-7.5-redhat-1'
JAVA_ARGS
プロパティーを編集します。ログマネージャーに依存するファイルを参照するブートストラップクラスパス引数を追加します。-Xbootclasspath/a:$ARTEMIS_HOME/lib/wildfly-common-1.5.2.Final-redhat-00001.jar
アップグレードされたブローカーを起動します。
BROKER_INSTANCE_DIR/bin/artemis run
(オプション) ブローカーが実行され、バージョンが変更されたことを確認します。ブローカーの起動後に、
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]
関連情報
- ブローカーのインスタンス作成に関する詳細は、ブローカーインスタンスの作成を参照してください。
-
ブローカーインスタンスの設定ファイルおよびデータを、ブローカーインスタンスのディレクトリー外の場所を含む、カスタムディレクトリーに格納できるようになりました。
BROKER_INSTANCE_DIR/etc/artemis.profile
ファイルで、ブローカーインスタンスの作成後のカスタムディレクトリーの場所を指定し、ARTEMIS_INSTANCE_ETC_URI
プロパティーを更新します。以前のバージョンでは、これらの設定ファイルとデータは、ブローカーインスタンスのディレクトリー内のetc/
ディレクトリーおよびdata/
ディレクトリーにのみ保存できました。
1.8.2. Windows 上の 7.4.x から 7.5.0 へのアップグレード
手順
- Red Hat カスタマーポータルから必要なアーカイブをダウンロードします。AMQ Broker アーカイブのダウンロード に記載されている手順に従います。
- ファイルマネージャーを使用して、アーカイブを AMQ Broker の最後のインストール時に作成したフォルダーに移動します。
- ファイルの内容をインストールディレクトリーに展開します。.zip ファイルを右クリックし、Extract All を選択します。
ブローカーが実行されている場合は停止します。
BROKER_INSTANCE_DIR\bin\artemis-service.exe stop
ファイルマネージャーを使用してブローカーをバックアップします。
- BROKER_INSTANCE_DIR フォルダーをクリックします。Copy を選択します。
- 同じウィンドウを右クリックします。Paste を選択します。
(オプション) ブローカーの現行バージョンをメモします。ブローカーが停止したら、
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
BROKER_INSTANCE_DIR\etc\artemis.profile.cmd
とBROKER_INSTANCE_DIR\bin\artemis-service.xml
設定ファイルを編集します。アーカイブの抽出時に作成された新しいディレクトリーにARTEMIS_HOME
プロパティーを設定します。ARTEMIS_HOME=
NEW_INSTALL_DIR
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
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>
アップグレードされたブローカーを起動します。
BROKER_INSTANCE_DIR\bin\artemis-service.exe start
(オプション) ブローカーが実行され、バージョンが変更されたことを確認します。ブローカーの起動後に、
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]
関連情報
- ブローカーのインスタンス作成に関する詳細は、ブローカーインスタンスの作成を参照してください。
-
ブローカーインスタンスの設定ファイルおよびデータを、ブローカーインスタンスのディレクトリー外の場所を含む、カスタムディレクトリーに格納できるようになりました。
BROKER_INSTANCE_DIR\etc\artemis.profile
ファイルで、ブローカーインスタンスの作成後にカスタムディレクトリーの場所を指定して、ARTEMIS_INSTANCE_ETC_URI
プロパティーを更新します。以前のバージョンでは、これらの設定ファイルとデータは、ブローカーインスタンスのディレクトリー内の\etc
ディレクトリーおよび\data
ディレクトリーにのみ保存できました。
1.9. ブローカーインスタンスの 7.5.0 から 7.6.0 へのアップグレード
以下のサブセクションでは、異なるオペレーティングシステムの 7.5.0 ブローカーインスタンスを 7.6.0 にアップグレードする方法を説明します。
AMQ Broker 7.1.0 以降では、デフォルトでローカルホストからのみ AMQ 管理コンソールにアクセスできます。リモートアクセスを有効にするには、BROKER_INSTANCE_DIR/etc/jolokia-access.xml
の設定を変更する必要があります。詳細は、AMQ 管理コンソールと AMQ ブローカ接続の保護 を参照してください。
1.9.1. Linux での 7.5.0 から 7.6.0 へのアップグレード
ダウンロードするアーカイブの名前は、以下の例で使用されているものとは異なる場合があります。
手順
- Red Hat カスタマーポータルから必要なアーカイブをダウンロードします。AMQ Broker アーカイブのダウンロード に記載されている手順に従います。
アーカイブの所有者を、AMQ Broker インストールが含まれるのと同じユーザーに変更します。以下の例では、
amq-broker
というユーザーを設定しています。sudo chown amq-broker:amq-broker amq-broker-7.6.0.redhat-1.zip
AMQ Broker の元のインストール時に作成されたディレクトリーにアーカイブを移動します。以下の例では、
/opt/redhat
を使用しています。sudo mv amq-broker-7.6.0.redhat-1.zip /opt/redhat
ディレクトリーの所有者は、圧縮アーカイブのコンテンツを展開します。以下の例では、ユーザー
amq-broker
はunzip
コマンドを使用してアーカイブを展開します。su - amq-broker cd /opt/redhat unzip amq-broker-7.6.0.redhat-1.zip
ブローカーが実行されている場合は停止します。
BROKER_INSTANCE_DIR/bin/artemis stop
現在のユーザーのホームディレクトリーにコピーして、ブローカーのインスタンスディレクトリーをバックアップします。
cp -r BROKER_INSTANCE_DIR ~/
(オプション) ブローカーの現行バージョンをメモします。ブローカーが停止すると、
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]
<broker_instance_dir>/etc/artemis.profile
設定ファイルを編集してください。アーカイブの抽出時に作成された新しいディレクトリーに
ARTEMIS_HOME
プロパティーを設定します。ARTEMIS_HOME='/opt/redhat/amq-broker-7.6-redhat-1'
JAVA_ARGS
プロパティーを編集します。ログマネージャーに依存するファイルを参照するブートストラップクラスパス引数を追加します。-Xbootclasspath/a:$ARTEMIS_HOME/lib/wildfly-common-1.5.2.Final-redhat-00002.jar
アップグレードされたブローカーを起動します。
BROKER_INSTANCE_DIR/bin/artemis run
(オプション) ブローカーが実行され、バージョンが変更されたことを確認します。ブローカーの起動後に、
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]
関連情報
- ブローカーのインスタンス作成に関する詳細は、ブローカーインスタンスの作成を参照してください。
-
ブローカーインスタンスの設定ファイルおよびデータを、ブローカーインスタンスのディレクトリー外の場所を含む、カスタムディレクトリーに格納できるようになりました。
BROKER_INSTANCE_DIR/etc/artemis.profile
ファイルで、ブローカーインスタンスの作成後のカスタムディレクトリーの場所を指定し、ARTEMIS_INSTANCE_ETC_URI
プロパティーを更新します。以前のバージョンでは、これらの設定ファイルとデータは、ブローカーインスタンスのディレクトリー内のetc/
ディレクトリーおよびdata/
ディレクトリーにのみ保存できました。
1.9.2. Windows での 7.5.0 から 7.6.0 へのアップグレード
手順
- Red Hat カスタマーポータルから必要なアーカイブをダウンロードします。AMQ Broker アーカイブのダウンロード に記載されている手順に従います。
- ファイルマネージャーを使用して、アーカイブを AMQ Broker の最後のインストール時に作成したフォルダーに移動します。
- ファイルの内容をインストールディレクトリーに展開します。.zip ファイルを右クリックし、Extract All を選択します。
ブローカーが実行されている場合は停止します。
BROKER_INSTANCE_DIR\bin\artemis-service.exe stop
ファイルマネージャーを使用してブローカーをバックアップします。
- BROKER_INSTANCE_DIR フォルダーをクリックします。Copy を選択します。
- 同じウィンドウを右クリックします。Paste を選択します。
(オプション) ブローカーの現行バージョンをメモします。ブローカーが停止したら、
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
BROKER_INSTANCE_DIR\etc\artemis.profile.cmd
とBROKER_INSTANCE_DIR\bin\artemis-service.xml
設定ファイルを編集します。アーカイブの抽出時に作成された新しいディレクトリーにARTEMIS_HOME
プロパティーを設定します。ARTEMIS_HOME=
NEW_INSTALL_DIR
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
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>
アップグレードされたブローカーを起動します。
BROKER_INSTANCE_DIR\bin\artemis-service.exe start
(オプション) ブローカーが実行され、バージョンが変更されたことを確認します。ブローカーの起動後に、
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]
関連情報
- ブローカーのインスタンス作成に関する詳細は、ブローカーインスタンスの作成を参照してください。
-
ブローカーインスタンスの設定ファイルおよびデータを、ブローカーインスタンスのディレクトリー外の場所を含む、カスタムディレクトリーに格納できるようになりました。
BROKER_INSTANCE_DIR\etc\artemis.profile
ファイルで、ブローカーインスタンスの作成後にカスタムディレクトリーの場所を指定して、ARTEMIS_INSTANCE_ETC_URI
プロパティーを更新します。以前のバージョンでは、これらの設定ファイルとデータは、ブローカーインスタンスのディレクトリー内の\etc
ディレクトリーおよび\data
ディレクトリーにのみ保存できました。
1.10. ブローカーインスタンスの 7.6.0 から 7.7.0 へのアップグレード
以下のサブセクションでは、異なるオペレーティングシステムの 7.6.0 ブローカーインスタンスを 7.7.0 にアップグレードする方法を説明します。
AMQ Broker 7.1.0 以降では、デフォルトでローカルホストからのみ AMQ 管理コンソールにアクセスできます。リモートアクセスを有効にするには、BROKER_INSTANCE_DIR/etc/jolokia-access.xml
の設定を変更する必要があります。詳細は、AMQ 管理コンソールと AMQ ブローカ接続の保護 を参照してください。
1.10.1. Linux で 7.6.0 から 7.7.0 へのアップグレード
ダウンロードするアーカイブの名前は、以下の例で使用されているものとは異なる場合があります。
手順
- Red Hat カスタマーポータルから必要なアーカイブをダウンロードします。AMQ Broker アーカイブのダウンロード に記載されている手順に従います。
アーカイブの所有者を、AMQ Broker インストールが含まれるのと同じユーザーに変更します。以下の例では、
amq-broker
というユーザーを設定しています。sudo chown amq-broker:amq-broker amq-broker-7.7.0.redhat-1.zip
AMQ Broker の元のインストール時に作成されたディレクトリーにアーカイブを移動します。以下の例では、
/opt/redhat
を使用しています。sudo mv amq-broker-7.7.0.redhat-1.zip /opt/redhat
ディレクトリーの所有者は、圧縮アーカイブのコンテンツを展開します。以下の例では、ユーザー
amq-broker
はunzip
コマンドを使用してアーカイブを展開します。su - amq-broker cd /opt/redhat unzip amq-broker-7.7.0.redhat-1.zip
ブローカーが実行されている場合は停止します。
BROKER_INSTANCE_DIR/bin/artemis stop
現在のユーザーのホームディレクトリーにコピーして、ブローカーのインスタンスディレクトリーをバックアップします。
cp -r BROKER_INSTANCE_DIR ~/
(オプション) ブローカーの現行バージョンをメモします。ブローカーが停止すると、
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]
<broker_instance_dir>/etc/artemis.profile
設定ファイルを編集してください。アーカイブの抽出時に作成された新しいディレクトリーに
ARTEMIS_HOME
プロパティーを設定します。以下に例を示します。ARTEMIS_HOME='/opt/redhat/amq-broker-7.7-redhat-1'
JAVA_ARGS
プロパティーを探します。以下に示すように、ブートストラップクラスパスの引数が、ログマネージャーの依存するファイルに必要なバージョンを参照することを確認します。-Xbootclasspath/a:$ARTEMIS_HOME/lib/wildfly-common-1.5.2.Final-redhat-00002.jar
BROKER_INSTANCE_DIR/etc/logging.properties
設定ファイルを編集します。設定する追加のロガーのリストに、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
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 ..
アップグレードされたブローカーを起動します。
BROKER_INSTANCE_DIR/bin/artemis run
(オプション) ブローカーが実行され、バージョンが変更されたことを確認します。ブローカーの起動後に、
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]
関連情報
- ブローカーのインスタンス作成に関する詳細は、ブローカーインスタンスの作成を参照してください。
-
ブローカーインスタンスの設定ファイルおよびデータを、ブローカーインスタンスのディレクトリー外の場所を含む、カスタムディレクトリーに格納できるようになりました。
BROKER_INSTANCE_DIR/etc/artemis.profile
ファイルで、ブローカーインスタンスの作成後のカスタムディレクトリーの場所を指定し、ARTEMIS_INSTANCE_ETC_URI
プロパティーを更新します。以前のバージョンでは、これらの設定ファイルとデータは、ブローカーインスタンスのディレクトリー内のetc/
ディレクトリーおよびdata/
ディレクトリーにのみ保存できました。
1.10.2. Windows で 7.6.0 から 7.7.0 へのアップグレード
手順
- Red Hat カスタマーポータルから必要なアーカイブをダウンロードします。AMQ Broker アーカイブのダウンロード に記載されている手順に従います。
- ファイルマネージャーを使用して、アーカイブを AMQ Broker の最後のインストール時に作成したフォルダーに移動します。
- ファイルの内容をインストールディレクトリーに展開します。.zip ファイルを右クリックし、Extract All を選択します。
ブローカーが実行されている場合は停止します。
BROKER_INSTANCE_DIR\bin\artemis-service.exe stop
ファイルマネージャーを使用してブローカーをバックアップします。
- BROKER_INSTANCE_DIR フォルダーをクリックします。Copy を選択します。
- 同じウィンドウを右クリックします。Paste を選択します。
(オプション) ブローカーの現行バージョンをメモします。ブローカーが停止したら、
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
BROKER_INSTANCE_DIR\etc\artemis.profile.cmd
とBROKER_INSTANCE_DIR\bin\artemis-service.xml
設定ファイルを編集します。アーカイブの抽出時に作成された新しいディレクトリーにARTEMIS_HOME
プロパティーを設定します。ARTEMIS_HOME=
NEW_INSTALL_DIR
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
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>
BROKER_INSTANCE_DIR\etc\logging.properties
設定ファイルを編集します。設定する追加のロガーのリストに、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
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 ..
アップグレードされたブローカーを起動します。
BROKER_INSTANCE_DIR\bin\artemis-service.exe start
(オプション) ブローカーが実行され、バージョンが変更されたことを確認します。ブローカーの起動後に、
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]
関連情報
- ブローカーのインスタンス作成に関する詳細は、ブローカーインスタンスの作成を参照してください。
-
ブローカーインスタンスの設定ファイルおよびデータを、ブローカーインスタンスのディレクトリー外の場所を含む、カスタムディレクトリーに格納できるようになりました。
BROKER_INSTANCE_DIR\etc\artemis.profile
ファイルで、ブローカーインスタンスの作成後にカスタムディレクトリーの場所を指定して、ARTEMIS_INSTANCE_ETC_URI
プロパティーを更新します。以前のバージョンでは、これらの設定ファイルとデータは、ブローカーインスタンスのディレクトリー内の\etc
ディレクトリーおよび\data
ディレクトリーにのみ保存できました。
第2章 AMQ 管理コンソールの使用
AMQ 管理コンソールは、AMQ Broker インストールに含まれる Web コンソールであり、Web ブラウザーを使用して AMQ Broker を管理できます。
AMQ 管理コンソールは hawtio をベースとしています。
2.1. 概要
AMQ Broker はフル機能のメッセージ指向ミドルウェアブローカーです。特殊なキュー処理動作、メッセージの永続性、および管理性を提供します。複数のプロトコルおよびクライアント言語をサポートし、多くのアプリケーションアセットを自由に使用できます。
AMQ Broker の主な機能を使用すると、以下が可能になります。
AMQ Broker およびクライアントの監視
- トポロジーの表示
- glance でのネットワークの正常性の表示
以下を使用して AMQ Broker を管理します。
- AMQ 管理コンソール
- コマンドラインインターフェイス (CLI)
- 管理 API
AMQ 管理コンソールでサポートされる Web ブラウザーは Firefox、Chrome、および Internet Explorer です。サポートされるブラウザーバージョンの詳細は、AMQ 7 でサポートされる設定 を参照してください。
2.2. AMQ 管理コンソールへのローカルおよびリモートアクセスの設定
本セクションの手順では、AMQ 管理コンソールへのローカルおよびリモートアクセスを設定する方法を説明します。
コンソールへのリモートアクセスには、以下の 2 つの形式を使用できます。
- ローカルブローカーのコンソールセッション内では、Connect タブを使用して別のリモートブローカーに接続します。
- リモートホストから、ローカルブローカーの外部からアクセスできる IP アドレスを使用して、ローカルブローカーのコンソールに接続します。
前提条件
-
少なくとも AMQ Broker 7.1.0 にアップグレードする必要があります。このアップグレードの一環として、
jolokia-access.xml
という名前のアクセス管理設定ファイルをブローカーインスタンスに追加します。アップグレードについての詳細は、Upgrading a Broker instance from 7.0.x to 7.1.0 を参照してください。
手順
-
<broker-instance-dir>/etc/bootstrap.xml
ファイルを開きます。 web
要素内で、Web ポートはデフォルトでlocalhost
にのみバインドされていることを確認します。<web bind="http://localhost:8161" path="web"> <app url="redhat-branding" war="redhat-branding.war"/> <app url="artemis-plugin" war="artemis-plugin.war"/> <app url="dispatch-hawtio-console" war="dispatch-hawtio-console.war"/> <app url="console" war="console.war"/> </web>
リモートホストからローカルブローカーのコンソールへの接続を有効にするには、Web ポートバインディングをネットワーク到達可能なインターフェイスに変更します。以下に例を示します。
<web bind="http://0.0.0.0:8161" path="web">
上記の例では、
0.0.0.0
を指定することで、Web ポートをローカルブローカーの すべてのインターフェイスにバインドします。-
bootstrap.xml
ファイルを保存します。 -
<broker-instance-dir>/etc/jolokia-access.xml
ファイルを開きます。 <cors>
(Cross-Origin Resource Sharing) 要素内に、コンソールへのアクセスを許可する各 HTTP origin リクエストヘッダーにallow-origin
エントリーを追加します。以下に例を示します。<cors> <allow-origin>*://localhost*</allow-origin> <allow-origin>*://192.168.0.49*</allow-origin> <allow-origin>*://192.168.0.51*</allow-origin> <!-- Check for the proper origin on the server side, too --> <strict-checking/> </cors>
上記の設定では、以下の接続が許可されるように指定します。
ローカルホストからコンソールへの接続 (つまり、ローカルブローカーインスタンスのホストマシン)。
-
最初のワイルドカード文字 (
*
) では、セキュアな接続にコンソールを設定したかどうかに基づいて、http
またはhttps
スキームのいずれかを接続要求で指定できます。 -
2 つ目のワイルドカード文字 (
*
) を使用すると、ホストマシン上の任意のポートを接続に使用できます。
-
最初のワイルドカード文字 (
-
ローカルブローカーの外部からアクセスできる IP アドレスを使用して、リモートホストからローカルブローカーのコンソールへの接続。この場合、ローカルブローカーの外部からアクセスできる IP アドレスは
192.168.0.49
です。 -
別のリモートブローカーで開いたコンソールセッション内からローカルブローカーへの接続。この場合、リモートブローカーの IP アドレスは
192.168.0.51
です。
-
jolokia-access.xml
ファイルを保存します。 -
<broker-instance-dir>/etc/artemis.profile
ファイルを開きます。 Java システム引数の
JAVA_ARGS
リストに、新しい引数Dhawtio.proxyWhitelist
を追加します。コンマ区切りリストとして、ローカルブローカーから接続するリモートブローカーの IP アドレスを指定します (つまり、ローカルブローカーで実行しているコンソールセッション内の Connect タブを使用)。以下に例を示します。-Dhawtio.proxyWhitelist=192.168.0.51
上記の設定に基づいて、ローカルブローカーのコンソールセッション内の Connect タブを使用して、IP アドレスが
192.168.0.51
の別のリモートブローカーに接続できます。-
aretmis.profile
ファイルを保存します。
関連情報
- コンソールへのアクセス方法は、「AMQ 管理コンソールへのアクセス」 を参照してください。
詳細情報:
- クロスオリジンリソース共有については、W3C Recommendations を参照してください。
- Jolokia のセキュリティーについては、Jolokia Protocols を参照してください。
- コンソールへの接続のセキュリティー保護については、「AMQ 管理コンソールへのネットワークアクセスのセキュリティー保護」 を参照してください。
2.3. AMQ 管理コンソールへのアクセス
本セクションの手順では、以下の方法を説明します。
- ローカルブローカーからコンソールに接続する
- ローカルブローカのコンソールセッション内からリモートホスト (つまり、他のブローカ) に接続する
- リモートホストからローカルブローカーのコンソールに接続する
前提条件
- コンソールへのローカルおよびリモートアクセスがすでに設定されている必要があります。詳細は、「AMQ 管理コンソールへのローカルおよびリモートアクセスの設定」 を参照してください。
手順
Web ブラウザーで、ローカルブローカーのコンソールアドレスに移動します。
コンソールのアドレスは
http://<host:port>/console/login
です。デフォルトのアドレスを使用している場合は、http://localhost:8161/console/login に移動します。- ブローカーの作成時に作成したデフォルトのユーザー名とパスワードを使用して、AMQ 管理コンソールにログインします。
- ローカルブローカーのコンソールセッションから別のリモートブローカーに接続するには、Connect タブをクリックします。
Connection Settings セクションで、次を指定します。
- 名前
-
my_other_broker
のようなリモート接続の名前。 - Scheme
-
リモート接続に使用するプロトコル。非セキュアな接続の場合は
http
を、セキュアな接続の場合はhttps
を選択してください。 - ホスト
- リモートホストの IP アドレス。このリモートホストのコンソールアクセスがすでに設定されている必要があります。
- ポート
-
リモート接続に使用するローカルホストのポート。デフォルト値の
8161
を使用する必要があります。これは、AMQ 7 のデフォルトの HTTP ポートです。 - パス
-
コンソールアクセスに使用するパス。
console/jolokia
を指定します。 - ユーザー名
- リモートホスト上の Jolokia エンドポイントに接続するためのユーザー名。
- パスワード
- リモートホスト上の Jolokia エンドポイントに接続するためのパスワード。
リモートホストからローカルブローカーのコンソールに接続するには、Web ブラウザーでローカルブローカーの Jolokia エンドポイントを指定します。このエンドポイントには、リモートコンソールアクセスの設定時にローカルブローカーに指定した外部からアクセスできる IP アドレスが含まれます。以下に例を示します。
http://192.168.0.49/console/jolokia
関連情報
- ブローカーの使用を開始する方法の詳細は AMQ Broker の使用開始 の ブローカーの使用 を参照してください。
2.4. AMQ 管理コンソールの設定
ユーザーアクセスを設定し、ブローカーのリソースへのアクセスを要求します。
2.4.1. AMQ 管理コンソールへのユーザーアクセスの設定
ブローカーのログインクレデンシャルを使用して、AMQ 管理コンソールにアクセスできます。以下の表は、AMQ 管理コンソールにアクセスするためにブローカーユーザーを追加するさまざまな方法について説明します。
認証方法 | 説明 |
---|---|
ゲスト認証 | 匿名アクセスを有効にします。この設定では、クレデンシャルなしまたは誤ったクレデンシャルで接続するユーザーは自動的に認証され、特定のユーザーとロールが割り当てられます。 詳細は、AMQ Broker の設定 の ゲストアクセスの設定 を参照してください。 |
基本的なユーザーとパスワード認証 | 各ユーザーに、ユーザー名とパスワードを定義してセキュリティーロールを割り当てる必要があります。ユーザーは、これらのクレデンシャルを使用して AMQ 管理コンソールにのみログインできます。 詳細は、AMQ Broker の設定 の パスワード認証の有効化 を参照してください。 |
LDAP 認証 | ユーザーは、中央の X.500 ディレクトリーサーバーに保存されているユーザーデータに対してクレデンシャルをチェックして認証および認可されます。 詳細は、AMQ Broker の設定 の 証明書ベースの認証の追加 を参照してください。 |
2.4.2. AMQ 管理コンソールへのネットワークアクセスのセキュリティー保護
コンソールが WAN またはインターネット経由でアクセスされる際に AMQ 管理コンソールのセキュリティーを保護するには、ネットワークアクセスが http
ではなく https
を使用するように SSL で指定します。
前提条件
以下は、<broker-instance-dir>/etc/
ディレクトリーに配置されている必要があります。
- Java キーストア
- Java トラストストア (クライアント認証が必要な場合のみ必要)
手順
-
<broker-instance-dir>/etc/bootstrap.xml
ファイルを開きます。 <web>
要素に以下の属性を追加します。<web bind="https://0.0.0.0:8161" path="web"> ... keyStorePath="<path_to_keystore>" keyStorePassword="<password>" clientAuth="<true/false>" trustStorePath="<path_to_truststore>" trustStorePassword="<password>"> ... </web>
- bind
-
コンソールへのセキュアな接続では、URI スキームを
https
に変更します。 - keyStorePath
キーストアファイルのパス。以下に例を示します。
keyStorePath="<broker-instance-dir>/etc/keystore.jks"
- keyStorePassword
- キーストアのパスワード。このパスワードは暗号化できます。
- clientAuth
-
クライアント認証が必要であるかどうかを指定します。デフォルト値は
false
です。 - trustStorePath
-
トラストストアファイルのパス。
clientAuth
がtrue
に設定されている場合のみ、この属性を定義する必要があります。 - trustStorePassword
- トラストストアのパスワード。このパスワードは暗号化できます。
関連情報
-
bootstrap.xml
を含むブローカー設定ファイルのパスワードを暗号化する方法の詳細は、設定ファイルのパスワードの暗号化 を参照してください。
2.5. AMQ Broker デプロイメントのモニタリング
AMQ Management Console ダッシュボードページを使用して、AMQ Broker のステータスを監視できます。独自のダッシュボードを作成して、最も重要なリアルタイムのグラフ、図、およびメトリックを表示することもできます。
2.5.1. ダッシュボードの表示
ダッシュボードは、AMQ Broker 環境に関するリアルタイムデータを提供します。
手順
AMQ 管理コンソールで、Dashboard タブをクリックします。
Monitor
ダッシュボードが表示され、hawtio に関するリアルタイムデータが表示されます。- 別のダッシュボードに切り替えるには、ダッシュボードタブをクリックします。
2.5.2. 新しいダッシュボードの作成
ダッシュボードにはウィジェットが含まれており、それぞれにチャート、図、またはメトリックを表示できます。ダッシュボードは必要な数だけ作成できます。
手順
- AMQ 管理コンソールで、Dashboard タブをクリックします。
ナビゲーションバーで、Manage をクリックします。
注記Manage
ページが表示され、既存のダッシュボードのリストが表示されます。次のいずれかを行います。
次を行う場合: 以下を行います 空白のダッシュボードの新規作成
Create をクリックします。
既存のダッシュボードに似たダッシュボードの作成
- 既存のダッシュボードの横にあるチェックボックスをクリックします。
- 複製 をクリックします。
ダッシュボードの名前を変更するには:
- ダッシュボード名にカーソルを合わせ、鉛筆アイコン ( ) をクリックします。
- ダッシュボードの新しい名前を入力し、チェックマークアイコン ( ) をクリックします。
2.5.3. AMQ Broker ダッシュボードの作成
新しいダッシュボードを作成して、AMQ Broker のリアルタイムデータを表示できます。
2.5.4. AMQ Broker データの AMQ 管理コンソールダッシュボードへの追加
使用可能なキューおよびトピックグラフをダッシュボードに追加します。
手順
- Artemis タブをクリックします。
ナビゲーションバーで、追加 アイコン ( ) をクリックします。
Dashboard
タブが表示され、使用可能なダッシュボードのリストが表示されます。- グラフを表示するダッシュボード (複数可) を選択し、Add View To Dashboard をクリックします。選択したダッシュボードにグラフが追加されます。
2.5.5. ダッシュボードのレイアウトの変更
ダッシュボードには、メトリック、図、およびグラフを表示するウィジェットが含まれています。ダッシュボードにおけるこれらのウィジェットの表示方法を変更できます。
手順
ウィジェットを移動または再配置する
ウィジェットをクリックして、ダッシュボードの新しい位置にドラッグします。
ウィジェットのタイトルを変更する
ウィジェットのサイズを変更する
ウィジェットの右下隅にあるサイズ変更アイコン (
) をクリックして、ドラッグします。
ダッシュボードからウィジェットを削除する
ウィジェットのタイトルバーで、閉じるアイコン (
) をクリックします。
次を行う場合: こちらを実行します。
2.6. AMQ Broker の管理
AMQ Management Console を使用して、AMQ Broker ブローカーに関する重要な情報を表示し、次のリソースを管理できます。
- 着信ネットワーク接続 (アクセプター)
- アドレス
- Queues
2.6.1. ブローカーの詳細の表示
設定プロパティーとその値を表示して、ブローカーがどのように設定されているかを確認します。
手順
Artemis タブのフォルダーツリーで、ブローカーを選択します。
ブローカーの設定プロパティーのリストが表示されます。
Connections
- クライアント接続に関する情報を表示します。
Sessions
- クライアントセッションに関する情報を表示します。
Consumers
- クライアントコンシューマーに関する情報を表示します。
Producers
- セッションプロデューサーに関する情報を表示します。
アドレス
- アドレスに関する情報を表示します。
Queues
- キューに関する情報を表示します。
Diagrams
- ブローカー (マスターとスレーブ)、プロデューサーとコンシューマー、アドレス、およびキューを含む、トポロジー内のすべての AMQ Broker リソースの図を表示します。
属性
- 設定された属性に関する情報を表示します。
操作
- サーバーで実行できる操作に関する情報を表示します。
チャート
- 選択した属性のリアルタイムデータを表示します。
2.6.2. ブローカーダイアグラムの表示
ブローカー (マスターとスレーブ)、プロデューサーとコンシューマー、アドレス、およびキューを含む、トポロジー内のすべての AMQ Broker リソースの図を表示できます。
手順
Artemis タブで、Diagram をクリックします。
この例は、キューが 10 個あるブローカー 3つを示しています。
- ダイアグラムに表示されるオブジェクトを変更するには、View ドロップダウンをクリックして、表示するアイテムを選択します。
2.6.3. アクセプターの表示
ブローカーに設定されたアクセプターの詳細を表示できます。
手順
- Artemis タブのフォルダーツリーで、acceptors フォルダーを展開します。
アクセプターをクリックして、設定方法の詳細を表示します。
この例は、AMQP プロトコルに提供されるデフォルトのアクセプターである
amqp
アクセプターの設定プロパティーを示しています。
2.6.4. アドレスおよびキューの管理
アドレスはメッセージングエンドポイントを表します。設定内で、通常のアドレスには一意の名前が指定されます。
キューがアドレスに関連付けられます。アドレスごとに複数のキューが存在する場合があります。受信メッセージがアドレスにマッチすると、設定されたルーティングタイプに応じて、メッセージは 1 つ以上のキューに送信されます。キューは、自動作成および削除ができるように設定できます。
2.6.4.1. アドレスの作成
一般的なアドレスには、一意の名前、ゼロ以上のキュー、およびルーティングタイプが指定されます。
ルーティングタイプは、アドレスに関連付けられたキューへメッセージが送信される方法を決定します。アドレスは、2 つの異なるルーティングタイプで設定できます。
メッセージをルーティング先とルーティングする場合 | このルーティングタイプを使用する... |
ポイントツーポイント方式で、一致するアドレス内の単一キュー。 | anycast |
パブリッシュ/サブスクライブ方式で、一致するアドレス内のすべてのキュー。 | Multicast |
アドレスおよびキューを作成および設定し、使用されていない場合はそれらを削除できます。
手順
- フォルダーツリーで、ブローカーを選択します。
ナビゲーションバーで、 ドロップダウンアイコンをクリックし、Create をクリックします。
アドレスを作成するページが表示されます。
以下のフィールドに入力します。
Address name
- アドレスのルーティング名。
Routing type
- 以下のオプションのいずれかを選択します。
Multicast
- アドレスに送信されたメッセージは、パブリッシュサブスクライブ方式ですべてのサブスクライバーに配信されます。
anycast
- このアドレスに送信されたメッセージは、ポイントツーポイントでサブスクライバー 1 つのみに配信されます。
両方
- アドレスごとに複数のルーティングタイプを定義できます。通常、これによりアンチパターンが発生するため、推奨されません。
注記ただし、アドレスが両方のルーティングタイプを使用し、クライアントがどちらにも優先していない場合、ブローカーは通常、デフォルトで
anycast
ルーティングタイプに設定されます。1 つの例外は、クライアントが MQTT プロトコルを使用する場合です。この場合、デフォルトのルーティングタイプはmulticast
です。- Create Address をクリックします。
2.6.4.2. アドレスへのメッセージの送信
以下の手順は、メッセージをアドレスに送信するのに必要な手順の概要を説明します。
手順
- フォルダーツリーで、アドレスを選択します。
ナビゲーションバーで、 ドロップダウンアイコンをクリックし、Send をクリックします。
メッセージを作成するページが表示されます。
- 必要な場合は、Header ボタンをクリックしてメッセージヘッダー情報を追加します。
- メッセージのボディーを入力します。
- Payload format ドロップダウンで、メッセージ本文の形式のオプションを選択し、Auto format をクリックします。メッセージ本文は、選択した形式向けに人間が判読できるスタイルでフォーマットされます。
- Send message をクリックします。メッセージは送信されます。
- 追加のメッセージを送信するには、入力した情報のいずれかを変更し、Send message をクリックします。
2.6.4.3. キューの作成
キューは、プロデューサーとコンシューマー間のチャネルを提供します。
前提条件
- キューをバインドするアドレスが存在する必要があります。
手順
- フォルダーツリーで、キューをバインドするアドレスを選択します。
ナビゲーションバーで、 ドロップダウンアイコンをクリックし、Create をクリックします。
キューを作成するためのページが表示されます。
以下のフィールドに入力します。
Queue name
- キューの一意の名前。
Routing type
- 以下のオプションのいずれかを選択します。
Multicast
- このアドレスに送信されたメッセージは、アドレスにバインドされるすべてのキューに分散されます。
anycast
- 親アドレスにバインドされた 1 つのキューのみがメッセージのコピーを受信します。メッセージはアドレスにバインドされたすべてのキューに均等に分散されます。
永続性
- このオプションを選択すると、キューとそのメッセージは永続化されます。
フィルター
- ブローカーへの接続時に使用されるユーザー名。
Max Consumers
- 一度にキューにアクセスできるコンシューマーの最大数。
Purge when no consumers
- 選択した場合、コンシューマーが接続されていない場合にキューがパージされます。
Create Queue をクリックします。
キューが作成されます。バインドされているアドレスにあるフォルダーツリーでアクセスできます。アドレスのキューは、
Queues
フォルダーに編成されます。Queues
フォルダー内では、キューはルーティングタイプ (MULTICAST
およびANYCAST
) ごとにさらに整理されています。この例では、
clusterQueue
キューはclusterQueue
アドレス内にあります。
2.6.4.4. キューのステータスの確認
チャートは、ブローカーのキューのステータスのリアルタイムビューを提供します。
手順
フォルダーツリーで、キューに移動します。
あるアドレスの複数のキューのチャートを表示するには、キューを含む
ANYCAST
またはMULTICAST
のフォルダーを選択します。ナビゲーションバーで、 ドロップダウンアイコンをクリックし、Chart をクリックします。
キューの全属性のリアルタイムデータを示すグラフが表示されます。
必要に応じて、チャートに異なる基準を選択します。
- ナビゲーションバーで、 ドロップダウンアイコンをクリックし、Edit Chart をクリックします。
-
Attributes
一覧で、チャートに追加する属性を 1 つ以上選択します。複数の属性を選択するには、Ctrl キーを押して保持し、各属性を選択します。 - View Chart ボタンをクリックします。グラフは、選択した基準に基づいて表示されます。
2.6.4.5. キューの参照
キューを参照すると、キュー内のすべてのメッセージが表示されます。また、リストをフィルターリングしてソートして、特定のメッセージを見つけることもできます。
手順
フォルダーツリーで、キューに移動します。
キューはバインド先のアドレス内にあります。
ナビゲーションバーで、 ドロップダウンアイコンをクリックし、Browse をクリックします。
キューのメッセージが表示されます。デフォルトでは、最初の 200 メッセージが表示されます。
特定のメッセージまたはメッセージのグループを参照するには、以下のいずれかを行います。
次を行う場合: こちらを実行します。 メッセージ一覧をフィルターします。
Filter messages
テキストフィールドにフィルター条件を入力し、Enter を押します。メッセージ一覧を並べ替えます。
メッセージの一覧で、列ヘッダーをクリックします。メッセージを降順に並び替えるには、ヘッダーを 2 回クリックします。
メッセージの内容を表示するには、メッセージ ID をクリックします。
メッセージヘッダー、プロパティー、およびボディーを表示できます。
2.6.4.6. キューへのメッセージの送信
キューの作成後、メッセージを送信できます。以下の手順は、メッセージを既存のキューに送信するのに必要な手順の概要を説明します。
手順
- フォルダーツリーで、メッセージの送信先のキューを選択します。
ナビゲーションバーで、 ドロップダウンアイコンをクリックし、Send をクリックします。
メッセージを作成するページが表示されます。
- 必要な場合は、Header ボタンをクリックしてメッセージヘッダー情報を追加します。
- メッセージのボディーを入力します。
- Payload format ドロップダウンで、メッセージ本文の形式のオプションを選択し、Auto format をクリックします。メッセージ本文は、選択した形式向けに人間が判読できるスタイルでフォーマットされます。
- Send message をクリックします。メッセージは送信されます。
- 追加のメッセージを送信するには、入力した情報のいずれかを変更し、Send message をクリックします。
2.6.4.7. キューへのメッセージの再送信
以前送信されたメッセージを再送信できます。
手順
- 再送信するメッセージを参照します。
- 再送信するメッセージの横にあるチェックボックスをクリックします。
- Resend ボタンをクリックします。メッセージが表示されます。
- 必要に応じて メッセージヘッダーとボディー を更新し、Send message をクリックします。
2.6.4.8. 別のキューへのメッセージの移動
キュー内の 1 つ以上のメッセージを別のキューに移動できます。
手順
- 移動するメッセージを参照します。
- 移動する各メッセージの横にあるチェックボックスをクリックします。
Move ボタンをクリックします。
確認ダイアログボックスが表示されます。
- メッセージの移動先のキューの名前を入力し、Move をクリックします。
2.6.4.9. キューの削除
キューからキューを削除したり、すべてのメッセージをパージしたりすることができます。
手順
- 削除またはパージするキューを参照します。
次のいずれかを行います。
次を行う場合: こちらを実行します。 キューからメッセージを削除します。
- 削除する各メッセージの横にあるチェックボックスをクリックします。
- Delete ボタンをクリックします。
キューからすべてのメッセージをパージします。
- ナビゲーションバーで、Delete をクリックします。
- Purge Queue ボタンをクリックします。
キューの削除
- ナビゲーションバーで、Delete をクリックします。
- Delete Queue ボタンをクリックします。
第3章 コマンドラインインターフェイスの使用
コマンドラインインターフェイス (CLI) は、対話式ターミナルを使用してメッセージブローカーとの対話を可能にします。ブローカーアクションの管理、メッセージの設定、および CLI を使用して便利なコマンドを入力します。
コマンドラインインターフェイス (CLI) により、対話プロセスを使用してユーザーおよびロールをファイルに追加できます。
3.1. ブローカーインスタンスの起動
ブローカーインスタンスは、ログやデータファイルなどのすべての設定およびランタイムデータが含まれるディレクトリーです。ランタイムデータは一意のブローカープロセスに関連付けられます。
artemis
スクリプトを Linux サービスまたは Windows サービスとして使用することで、フォアグラウンドでブローカーを起動することができます。
3.1.1. ブローカーインスタンスの起動
ブローカーインスタンスの作成後に、artemis run
コマンドを使用して起動します。
手順
インストール時に作成したユーザーのアカウントに切り替えます。
$ su - amq-broker
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 からアクセスできます。
3.1.2. Linux サービスとしてブローカーの起動
ブローカーが Linux にインストールされている場合は、サービスとして実行できます。
手順
-
/etc/systemd/system/
ディレクトリーにamq-broker.service
ファイルを新規に作成します。 以下のテキストをファイルにコピーします。
ブローカーインスタンスの作成時に提供される情報に応じて、パスおよびユーザーフィールドを変更します。以下の例では、ユーザー
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
- 端末を開きます。
以下のコマンドを使用してブローカーサービスを有効にします。
sudo systemctl enable amq-broker
以下のコマンドを使用してブローカーサービスを実行します。
sudo systemctl start amq-broker
3.1.3. Windows サービスとしてブローカーの起動
ブローカーが Windows にインストールされている場合は、サービスとして実行できます。
手順
- コマンドプロンプトを開いてコマンドを入力する
以下のコマンドを使用して、ブローカーをサービスとしてインストールします。
<broker-instance-dir>\bin\artemis-service.exe install
以下のコマンドを使用してサービスを起動します。
<broker-instance-dir>\bin\artemis-service.exe start
(オプション) サービスをアンインストールします。
<broker-instance-dir>\bin\artemis-service.exe uninstall
3.2. ブローカーインスタンスの停止
ブローカーインスタンスを手動で停止するか、ブローカーを正常にシャットダウンするように設定します。
3.2.1. ブローカーインスタンスの停止
スタンドアロンブローカーを作成し、テストメッセージを生成および消費した後、ブローカーインスタンスを停止できます。
この手順では、ブローカーを手動で停止し、クライアント接続をすべて強制的に閉じます。実稼働環境では、クライアント接続を適切に閉じるようにブローカーを正常に停止するようにブローカーを設定する必要があります。
手順
artemis stop
コマンドを使用してブローカーインスタンスを停止します。$ /var/opt/amq-broker/mybroker/bin/artemis stop 2018-12-03 14:37:30,630 INFO [org.apache.activemq.artemis.core.server] AMQ221002: Apache ActiveMQ Artemis Message Broker version 2.6.1.amq-720004-redhat-1 [b6c244ef-f1cb-11e8-a2d7-0800271b03bd] stopped, uptime 35 minutes Server stopped!
3.2.2. ブローカーインスタンスの正常な停止
手動シャットダウンは、stop
コマンドを入力すると、すべてのクライアントを強制的に切断します。別の方法として、graceful-shutdown-enabled
設定要素を使用して、ブローカーが正常にシャットダウンするように設定します。
graceful-shutdown-enabled
が true
に設定されている場合、stop
コマンドが入力された後、新しいクライアントの接続は許可されません。ただし、シャットダウンプロセスを開始する前に、既存の接続はクライアント側で閉じることができます。graceful-shutdown-enabled
のデフォルト値は false
です。
graceful-shutdown-timeout
設定要素を使用して、接続がブローカー側から強制的に閉じられる前にクライアントが切断する時間の長さをミリ秒単位で設定します。すべての接続が閉じられると、シャットダウンプロセスが開始します。graceful-shutdown-timeout
を使用する利点の 1 つは、クライアントの接続によるシャットダウンの遅延を防ぐことができることです。graceful-shutdown-timeout
のデフォルト値は -1
で、これは、クライアントが切断するまでブローカーが無期限に待機することを意味します。
以下の手順は、タイムアウトを使用する正常なシャットダウンを設定する方法を示しています。
手順
-
設定ファイル
<broker-instance-dir>\etc\broker.xml
を開きます。 graceful-shutdown-enabled
設定要素を追加し、値をtrue
に設定します。<configuration> <core> ... <graceful-shutdown-enabled> true </graceful-shutdown-enabled> ... </core> </configuration>
graceful-shutdown-timeout
設定要素を追加し、タイムアウトの値をミリ秒単位で設定します。以下の例では、stop
コマンドが実行されてから 30 秒 (30000
ミリ秒) 後に、クライアント接続が強制的に閉じられます。<configuration> <core> ... <graceful-shutdown-enabled> true </graceful-shutdown-enabled> <graceful-shutdown-timeout> 30000 </graceful-shutdown-timeout> ... </core> </configuration>
3.3. パケットをインターセプトしてメッセージの監査
ブローカーの出入力または終了パケットをインターセプトして、パケットの監査またはメッセージのフィルターを行います。インターセプターは、インターセプトするパケットを変更します。これによりインターセプターは強力になりますが、危険にさらされる可能性もあります。
ビジネス要件を満たすためのインターセプターを開発します。インターセプターはプロトコル固有であるため、適切なインターフェイスを実装する必要があります。
インターセプターは、ブール値を返す intercept()
メソッドを実装する必要があります。値が true
の場合、メッセージパケットは続行されます。false
の場合、プロセスは中止され、他のインターセプターは呼び出されず、メッセージパケットはこれ以上処理されません。
3.3.1. インターセプターの作成
インターセプターは、傍受するパケットを変更できます。独自の受信インターセプターおよび発信インターセプターを作成できます。すべてのインターセプターはプロトコル固有で、サーバーに出入りするパケットに対して呼び出されます。これにより、監査パケットなどのビジネス要件を満たすインターセプターを作成できます。
インターセプターとその依存関係は、ブローカーの Java クラスに配置する必要があります。デフォルトではクラスパスの一部であるため、<broker-instance-dir>/lib
ディレクトリーを使用できます。
以下の例は、渡された各パケットのサイズをチェックするインターセプターを作成する方法を示しています。
この例では、プロトコルごとに特定のインターフェイスを実装します。
手順
適切なインターフェイスを実装し、その
intercept()
メソッドをオーバーライドします。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; } }
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; } }
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; } }
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; } }
3.3.2. インターセプターを使用するためのブローカーの設定
前提条件
-
インターセプタークラスを作成し、そのクラス (およびその依存関係) をブローカーの Java クラスパスに追加します。デフォルトではクラスパスの一部であるため、
<broker-instance-dir>/lib
ディレクトリーを使用できます。
手順
-
<broker-instance-dir>/etc/broker.xml
を開きます _<broker-instance-dir>/etc/broker.xml
に設定を追加して、インターセプターを使用するようにブローカーを設定します。インターセプターが着信メッセージを対象としている場合は、その
class-name
をremoting-incoming-interceptors
のリストに追加します。<configuration> <core> ... <remoting-incoming-interceptors> <class-name>org.example.MyIncomingInterceptor</class-name> </remoting-incoming-interceptors> ... </core> </configuration>
インターセプターが発信メッセージを対象としている場合は、その
class-name
をremoting-outgoing-interceptors
のリストに追加します。<configuration> <core> ... <remoting-outgoing-interceptors> <class-name>org.example.MyOutgoingInterceptor</class-name> </remoting-outgoing-interceptors> </core> </configuration>
3.3.3. クライアントサイドのインターセプター
クライアントはインターセプターを使用して、クライアントからサーバーに送信したパケットを、またはサーバーがクライアントへインターセプトできます。ブローカー側のインターセプターが false
の値を返す場合、他のインターセプターは呼び出されず、クライアントは追加のパケットを処理しません。このプロセスは、発信パケットが blocking
方式で送信されない限り、透過的に行われます。この場合、呼び出し元に ActiveMQException
が出力されます。出力された ActiveMQException
には、false
値を返したインターセプターの名前が含まれています。
サーバーでは、クライアントインターセプタークラスとその依存関係を適切にインスタンス化および呼び出すには、クライアントの Java クラスに追加する必要があります。
3.4. コマンドラインツール
AMQ Broker にはコマンドラインインターフェイス (CLI) ツールのセットが含まれるため、メッセージングジャーナルを管理できます。以下の表は、各ツールの名前と対応する説明を一覧表示しています。
ツール | 説明 |
---|---|
address |
ツールグループのアドレス指定 (create/delete/update/show) (例: |
ブラウザー | インスタンスのメッセージを参照します。 |
consumer | インスタンスでメッセージを消費します。 |
data | ジャーナルレコードとデータの圧縮に関するレポートを出力します。 |
decode | エンコードから内部ジャーナル形式をインポートします。 |
encode | String にエンコードされるジャーナルの内部形式を示しています。 |
exp | 特別な XML 形式および独立した XML 形式を使用して、メッセージデータをエクスポートします。 |
help | ヘルプ情報を表示します。 |
imp |
|
kill | --allow-kill で開始するブローカーインスタンスを強制終了します。 |
mask | パスワードをマスクし、これを出力します。 |
perf-journal | 現在のデータフォルダーで使用する journal-buffer タイムアウトを計算します。 |
queue |
キューのツールグループ (create/delete/update/stat) (例: |
run | ブローカーインスタンスを実行します。 |
stop | ブローカーインスタンスを停止します。 |
user |
デフォルトのファイルベースのユーザー管 (add/rm/list/reset) (例: |
各ツールで利用可能なコマンドの全一覧については、help
パラメーターの後にツール名を使用してください。たとえば、以下の例で CLI 出力には、ユーザーが ./artemis help data
コマンドを入力すると、data
ツールで利用可能なコマンドがすべて表示されます。
$ ./artemis help data NAME artemis data - data tools group (print|imp|exp|encode|decode|compact) (example ./artemis data print) SYNOPSIS artemis data artemis data compact [--broker <brokerConfig>] [--verbose] [--paging <paging>] [--journal <journal>] [--large-messages <largeMessges>] [--bindings <binding>] artemis data decode [--broker <brokerConfig>] [--suffix <suffix>] [--verbose] [--paging <paging>] [--prefix <prefix>] [--file-size <size>] [--directory <directory>] --input <input> [--journal <journal>] [--large-messages <largeMessges>] [--bindings <binding>] artemis data encode [--directory <directory>] [--broker <brokerConfig>] [--suffix <suffix>] [--verbose] [--paging <paging>] [--prefix <prefix>] [--file-size <size>] [--journal <journal>] [--large-messages <largeMessges>] [--bindings <binding>] artemis data exp [--broker <brokerConfig>] [--verbose] [--paging <paging>] [--journal <journal>] [--large-messages <largeMessges>] [--bindings <binding>] artemis data imp [--host <host>] [--verbose] [--port <port>] [--password <password>] [--transaction] --input <input> [--user <user>] artemis data print [--broker <brokerConfig>] [--verbose] [--paging <paging>] [--journal <journal>] [--large-messages <largeMessges>] [--bindings <binding>] COMMANDS With no arguments, Display help information print Print data records information (WARNING: don't use while a production server is running) ...
各コマンドを実行する方法の詳細については、help
パラメーターを使用します。たとえば、CLI は、ユーザーが ./artemis help data print
の入力後に data print
コマンドに関する詳細情報を一覧表示します。
$ ./artemis help data print NAME artemis data print - Print data records information (WARNING: don't use while a production server is running) SYNOPSIS artemis data print [--bindings <binding>] [--journal <journal>] [--paging <paging>] OPTIONS --bindings <binding> The folder used for bindings (default ../data/bindings) --journal <journal> The folder used for messages journal (default ../data/journal) --paging <paging> The folder used for paging (default ../data/paging)
第4章 管理 API の使用
AMQ Broker には、ブローカーの設定変更、新規リソースの作成 (アドレスやキューなど) の作成、これらのリソース (現在のキューに現在保持されるメッセージ数など) を検査し、それらと対話する (たとえば、キューからメッセージを削除するために使用できる) 豊富な管理 API があります。
さらに、クライアントは管理 API を使用してブローカーを管理し、管理通知にサブスクライブできます。
4.1. 管理 API を使用した AMQ Broker の管理方法
管理 API を使用してブローカーを管理する方法は 2 つあります。
- JMX (JMX) の使用は、Java アプリケーションを管理する標準的な方法です。
- JMS メッセージと AMQ JMS クライアントを使用して JMS APIListenerExternalmanagement 操作を使用するとブローカーに送信されます。
ブローカーを管理する方法は 2 つありますが、各 API は同じ機能をサポートします。JMX を使用してリソースを管理する可能性がある場合は、JMS メッセージおよび AMQ JMS クライアントを使用して同じ結果を実現することもできます。
この選択は、特定の要件、アプリケーション設定、および環境によって異なります。管理操作の呼び出し方法に関係なく、管理 API は同じになります。
管理対象リソースごとに、このタイプのリソースに対して呼び出すことができる Java インターフェイスが存在します。ブローカーは、org.apache.activemq.artemis.api.core.management
パッケージで管理されたリソースを公開します。管理操作を呼び出す方法は、JMX メッセージまたは JMS メッセージと AMQ JMS クライアントが使用されるかどうかによって異なります。
管理操作によっては、操作の影響を受けるメッセージを選択するために filter
パラメーターが必要なものもあります。null
または空の文字列を渡すと、すべてのメッセージ で管理操作が実行されることを意味します。
4.2. JMX を使用した AMQ Broker の管理
JMX (Java Management Extensions) を使用してブローカーを管理できます。管理 API は、MBean インターフェイスを使用してブローカーによって公開されます。ブローカーは、リソースをドメイン org.apache.activemq
に登録します。
たとえば、exampleQueue
という名前のキューを管理するための ObjectName
は次のとおりです。
org.apache.activemq.artemis:broker="__BROKER_NAME__",component=addresses,address="exampleQueue",subcomponent=queues,routingtype="anycast",queue="exampleQueue"
MBean は以下のようになります。
org.apache.activemq.artemis.api.management.QueueControl
MBean の ObjectName
は、ヘルパークラス org.apache.activemq.artemis.api.core.management.ObjectNameBuilder
.を使って構築されます。jconsole を使用して、管理する MBean の ObjectName
を見つけることもできます。
JMX を使用したブローカーの管理は、JMX を使用した Java アプリケーションの管理と同じです。これは、リフレクションまたは MBean のプロキシーを作成して実行できます。
4.2.1. JMX 管理の設定
デフォルトでは、JMX はブローカーの管理に有効になっています。JMX 管理を有効または無効にするには、broker.xml
設定ファイルで jmx-management-enabled
プロパティーを設定します。
手順
-
<broker_instance_dir>/etc/broker.xml
設定ファイルを開きます。 <jmx-management-enabled>
を設定します。<jmx-management-enabled>true</jmx-management-enabled>
JMX が有効になっている場合、ブローカーは
jconsole
を使用してローカルで管理できます。注記セキュリティー上の理由から、JMX へのリモート接続はデフォルトで有効になっていません。
同じ
MBeanServer
から複数のブローカーを管理する場合は、各ブローカーに JMX ドメインを設定します。デフォルトでは、ブローカーは JMX ドメイン
org.apache.activemq.artemis
を使用します。<jmx-domain>my.org.apache.activemq</jmx-domain>
注記Windows システムで AMQ Broker を使用している場合は、
artemis
またはartemis.cmd
でシステムプロパティーを設定する必要があります。シェルスクリプトは<install-dir>/bin
にあります。
関連情報
- リモート管理用のブローカーの設定に関する詳細は、Oracle の Java Management Guide を参照してください。
4.2.2. MBeanServer の設定
ブローカーがスタンドアロンモードで動作しているときは、Java 仮想マシンの Platform MBeanServer
を使用して MBeans を登録します。デフォルトでは、Jolokia もデプロイされ、REST を使用した MBean サーバーへのアクセスを許可します。
4.2.3. Jolokia で JMX を公開する方法
デフォルトでは、AMQ Broker には Web アプリケーションとしてデプロイされた Jolokia HTTP エージェントが同梱されます。Jolokia は、MBean を公開する HTTP ブリッジ上のリモート JMX です。
Jolokia を使用するには、ユーザーは <broker-instance-dir>/etc/artemis.profile
設定ファイルの hawtio.role
システムプロパティーによって定義されたロールに属している必要があります。デフォルトでは、このロールは amq
です。
例4.1 Jolokia を使用したブローカーのバージョンのクエリー
この例では、Jolokia REST URL を使用してブローカーのバージョンを検索します。Origin
フラグは、ブローカーサーバーのドメイン名または DNS ホスト名を指定する必要があります。さらに、Origin
に指定する値は、Jolokia Cross-Origin Resource Sharing (CORS) 仕様の <allow-origin>
のエントリーに対応している必要があります。
$ curl http://admin:admin@localhost:8161/console/jolokia/read/org.apache.activemq.artemis:broker=\"0.0.0.0\"/Version -H "Origin: mydomain.com" {"request":{"mbean":"org.apache.activemq.artemis:broker=\"0.0.0.0\"","attribute":"Version","type":"read"},"value":"2.4.0.amq-710002-redhat-1","timestamp":1527105236,"status":200}
関連情報
- JMX-HTTP ブリッジの使用に関する詳細は、Jolokia のドキュメント を参照してください。
- ユーザーをロールに割り当てる方法は、ユーザーの追加 を参照してください。
- CORS(Jolokia Cross-Origin Resource Sharing) の指定に関する詳細は、セキュリティー のセクション 4.1.5 を参照してください。
4.2.4. JMX 管理通知のサブスクライブ
お使いの環境で JMX が有効になっている場合は、管理通知にサブスクライブできます。
手順
-
ObjectName org.apache.activemq.artemis:broker="<broker-name>"
にサブスクライブします。
関連情報
- 管理通知の詳細は、「管理通知」 を参照してください。
4.3. JMS API を使用した AMQ Broker の管理
Java Message Service (JMS) API を使用すると、メッセージの作成、送信、受信、読み取りが可能です。JMS および AMQ JMS クライアントを使用してブローカーを管理できます。
4.3.1. JMS メッセージおよび AMQ JMS クライアントを使用したブローカー管理の設定
JMS を使用してブローカーを管理するには、まず manage
パーミッションでブローカーの管理アドレスを設定する必要があります。
手順
-
<broker_instance_dir>/etc/broker.xml
設定ファイルを開きます。 <management-address>
要素を追加し、管理アドレスを指定します。デフォルトでは、管理アドレスは
queue.activemq.management
です。デフォルトを使用しない場合は、別のアドレスを指定する必要があります。<management-address>my.management.address</management-address>
管理アドレスに
manage
ユーザーパーミッションタイプを指定します。このパーミッションタイプにより、管理アドレスの管理メッセージが受信および処理できるようになります。
<security-setting-match="queue.activemq.management"> <permission-type="manage" roles="admin"/> </security-setting>
4.3.2. JMS API および AMQ JMS クライアントを使用したブローカーの管理
JMS メッセージを使用して管理操作を呼び出すには、AMQ JMS クライアントは特別な管理キューをインスタンス化する必要があります。
手順
-
QueueRequestor
を作成して、管理アドレスにメッセージを送信し、返信を受信します。 -
Message
を作成します。 -
ヘルパークラス
org.apache.activemq.artemis.api.jms.management.JMSManagementHelper
を使用して、メッセージに管理プロパティーを記入します。 -
QueueRequestor
を使ってメッセージを送信します。 -
ヘルパークラス
org.apache.activemq.artemis.api.jms.management.JMSManagementHelper
を使用して、管理応答から操作結果を取得します。
例4.2 キュー内のメッセージ数の表示
以下の例は、JMS API を使用して JMS キュー exampleQueue
でメッセージの数を表示する方法を示しています。
Queue managementQueue = ActiveMQJMSClient.createQueue("activemq.management"); QueueSession session = ... QueueRequestor requestor = new QueueRequestor(session, managementQueue); connection.start(); Message message = session.createMessage(); JMSManagementHelper.putAttribute(message, "queue.exampleQueue", "messageCount"); Message reply = requestor.request(message); int count = (Integer)JMSManagementHelper.getResult(reply); System.out.println("There are " + count + " messages in exampleQueue");
4.4. 管理操作
JMX または JMS メッセージを使用して AMQ Broker を管理する場合でも、同じ API 管理操作を使用できます。管理 API を使用すると、ブローカー、アドレス、およびキューを管理できます。
4.4.1. ブローカー管理操作
管理 API を使用してブローカーを管理できます。
- キューの一覧表示、作成、デプロイ、破棄
デプロイされたキューのリストは、
getQueueNames()
メソッドで取得できます。キューは、
ActiveMQServerControl
の管理操作createQueue()
、deployQueue()
、またはdestroyQueue()
を使用して作成または破棄できます (ObjectName
org.apache.activemq.artemis:broker="BROKER_NAME"
またはリソース名server
を使用)。deployQueue
が何もしない間、キューがすでに存在する場合、createQueue
は失敗します。- キューの一時停止および再開
-
QueueControl
は、基礎となるキューを一時停止したり、再開したりすることができます。キューが一時停止すると、メッセージは受信されますが、配信されません。再開すると、キューに格納されたメッセージの配信を開始します (存在する場合)。 - リモート接続の一覧表示および閉じる
listRemoteAddresses()
を使って、クライアントのリモートアドレスを取得します。また、closeConnectionsForAddress()
メソッドを使って、リモートアドレスに関連する接続を閉じることも可能です。または、
listConnectionIDs()
を使用して接続 ID を一覧表示し、listSessions()
を使用して指定の接続 ID の全セッションを一覧表示します。- トランザクションの管理
ブローカーがクラッシュした場合、ブローカーの再起動時に一部のトランザクションを手動で介入する必要がある場合があります。以下の方法を使用して、発生した問題を解決します。
listPreparedTransactions()
メソッドリストを使用して、準備済み状態のトランザクションを一覧表示します (トランザクションは不透明な Base64 文字列として表されます)。commitPreparedTransaction()
またはrollbackPreparedTransaction()
を使用して、指定された準備済みトランザクションをコミットまたはロールバックし、ヒューリスティックトランザクションを解決します。listHeuristicCommittedTransactions()
メソッドおよびlistHeuristicRolledBackTransactions
メソッドを使用して、ヒューリスティックに完了したトランザクションを一覧表示します。- メッセージカウンターの有効化およびリセット
enableMessageCounters()
またはdisableMessageCounters()
メソッドを使用して、メッセージカウンターを有効または無効にします。resetAllMessageCounters()
メソッドとresetAllMessageCounterHistories()
メソッドを使用して、メッセージカウンターをリセットします。- ブローカー設定および属性の取得
-
ActiveMQServerControl
は、そのすべての属性 (たとえば、ブローカーのバージョンを取得するためのgetVersion()
メソッドなど) を通じて、ブローカーの設定を公開します。 - コアブリッジおよび迂回の一覧表示、作成、破棄
デプロイされた Core Bridge を一覧表示し、
getBridgeNames()
とgetDivertNames()
メソッドをそれぞれ使用して迂回します。ActiveMQServerControl
で、createBridge()
とdestroyBridge()
またはcreateDivert()
とdestroyDivert()
を使用するブリッジと迂回を使用して、作成または破棄します (ObjectName
org.apache.activemq.artemis:broker="BROKER_NAME"
またはリソース名server
を使用)。- ブローカーを停止し、現在割り当てられているクライアントでフェイルオーバーを強制する
ActiveMQServerControl
のforceFailover()
を使用します (ObjectName
org.apache.activemq.artemis:broker="BROKER_NAME"
またはリソース名server
を使用)。注記このメソッドは実際にブローカーを停止するため、エラーが発生する可能性が高くなります。正確なエラーは、メソッドの呼び出しに使用した管理サービスによって異なります。
4.4.2. アドレス管理操作
管理 API を使用してアドレスを管理できます。
アドレスの管理には、ObjectName
org.apache.activemq.artemis:broker="<broker-name>", component=addresses,address="<address-name>"
またはリソース名 address.<address-name>
の AddressControl
クラスを使用します。
addRole()
メソッドや removeRole()
メソッドを使って、アドレスのロールやパーミッションを変更します。getRoles()
メソッドで、キューに関連付けられたすべてのロールを一覧表示できます。
4.4.3. キュー管理操作
管理 API を使用してキューを管理できます。
コア管理 API はキューを処理します。QueueControl
クラスは、キューの管理操作を定義します (ObjectName
,org.apache.activemq.artemis:broker="<broker-name>",component=addresses,address="<bound-address>",subcomponent=queues,routing-type="<routing-type>",queue="<queue-name>"
またはリソース名 queue.<queue-name>
を使用)。
キューの管理操作のほとんどは、単一のメッセージ ID (単一のメッセージを削除するなど) またはフィルター (指定のプロパティーですべてのメッセージを期限切れにするなど) を取ります。
- 期限切れで、デッドレターアドレスに送信し、メッセージの移動
expireMessages()
メソッドを使用して、キューのメッセージを失効させます。期限切れアドレスが定義されている場合、メッセージはこのアドレスに送信されます。それ以外の場合、メッセージは破棄されます。broker.xml
設定ファイルのaddress-settings
要素で、アドレスまたはアドレスセット (つまり、これらのアドレスにバインドされるキュー) の期限切れアドレスを定義できます。たとえば、デフォルトのブローカー設定について のデフォルトのメッセージアドレス設定セクションを参照してください。sendMessagesToDeadLetterAddress()
メソッドを使って、デッドレターアドレスにメッセージを送信します。このメソッドは、デッドレターアドレスに送信されたメッセージの数を返します。デッドレターアドレスが定義されている場合、メッセージはこのアドレスに送信されます。一致しない場合、メッセージはキューから削除され、破棄されます。broker.xml
設定ファイルのaddress-settings
要素で、アドレスまたはアドレス のセット (つまり、これらのアドレスにバインドされるキュー) のデッドレターアドレスを定義できます。たとえば、デフォルトのブローカー設定について のデフォルトのメッセージアドレス設定セクションを参照してください。moveMessages()
メソッドを使用して、あるキューから別のキューにメッセージを移動します。- メッセージの一覧表示と削除
listMessages()
メソッドを使用して、あるキューからメッセージを一覧表示します。Map
の配列 (各メッセージに対して 1 つのMap
) を返します。removeMessages()
メソッドを使用してキューからメッセージを削除します。これは、単一のメッセージ ID バリアントのboolean
、またはフィルターバリアントの削除されたメッセージの数を返します。このメソッドは、filter
引数を取り、フィルターされたメッセージのみを削除します。フィルターを空の文字列に設定すると、すべてのメッセージが削除されます。- メッセージのカウント
-
キューに入っているメッセージの数は、
getMessageCount()
メソッドで返されます。または、countMessages()
は指定のフィルターに一致するキュー内のメッセージの数を返します。 - メッセージの優先度の変更
-
メッセージの優先度は、単一のメッセージ ID バリアントの
boolean
またはフィルターバリアントの更新されたメッセージの数を返すchangeMessagesPriority()
メソッドを使用して変更できます。 - メッセージカウンター
-
メッセージカウンターは、
listMessageCounter()
およびlistMessageCounterHistory()
メソッドを使用して、キューに対して一覧表示することができます (「メッセージカウンターの使用」を参照)。メッセージカウンターは、resetMessageCounter()
メソッドを使って、1 つのキューに対してリセットすることもできます。 - キュー属性の取得
-
QueueControl
は、属性を使用してキュー設定を公開します (たとえば、キューのフィルターが作成されている場合はこれを取得するためにgetFilter()
を使用、キューが永続的かどうかを知るためにはisDurable()
を使用など)。 - キューの一時停止および再開
-
QueueControl
は、基礎となるキューを一時停止したり、再開したりすることができます。キューが一時停止すると、メッセージは受信されますが、配信されません。再開すると、キューに格納されたメッセージの配信を開始します (存在する場合)。
4.4.4. リモートリソース管理操作
管理 API を使用してブローカーのリモートリソース (アクセプター、迂回、ブリッジなど) を起動および停止し、ブローカーを完全に停止せずに特定の期間にオフラインにすることができます。
- アクセプター
-
start()
またはを使用してアクセプターを開始または停止します。AcceptorControl
クラスのstop()
メソッド (ObjectName
org.apache.activemq.artemis:broker="<broker-name>",component=acceptors,name="<acceptor-name>"
またはリソース名acceptor.<address-name>
を使用)。アクセプターパラメーターは、AcceptorControl
属性を使用して取得できます。アクセプターの詳細は、ネットワーク接続: アクセプターおよびコネクター を参照してください。 - Diverts
-
DivertControl
クラスのstart()
またはstop()
メソッドを使用して、ダイバートを開始または停止します (ObjectName
org.apache.activemq.artemis:broker="<broker-name>",component=diverts,name="<divert-name>"
またはリソース名divert.<divert-name>
を使用)。迂回パラメーターは、DivertControl
属性を使用して取得できます。 - ブリッジ
-
start()
(リスピン) を使って、ブリッジを開始または停止します。BridgeControl
クラスのstop()
メソッド (ObjectName
org.apache.activemq.artemis:broker="<broker-name>",component=bridge,name="<bridge-name>"
or the resource namebridge.<bridge-name>
を伴う)。ブリッジのパラメーターは、BridgeControl
属性を使って取得することができます。 - ブロードキャストグループ
-
BroadcastGroupControl
クラスのstart()
またはstop()
メソッドを使用して、ブロードキャストグループを開始または停止します (ObjectName
org.apache.activemq.artemis:broker="<broker-name>",component=broadcast-group,name="<broadcast-group-name>"
またはリソース名broadcastgroup.<broadcast-group-name>
を使用)。ブロードキャストグループのパラメーターは、BroadcastGroupControl
属性を使って取得することができます。詳細は 、ブローカー検出メソッド を参照してください。 - 検出グループ
-
DiscoveryGroupControl
クラスのstart()
またはstop()
メソッドを使用して、ディスカバリーグループを開始または停止します (ObjectName
org.apache.activemq.artemis:broker="<broker-name>",component=discovery-group,name="<discovery-group-name>"
またはリソース名discovery.<discovery-group-name>
を使用)。ディスカバリーグループのパラメーターは、DiscoveryGroupControl
属性を使って取得することができます。詳細は 、ブローカー検出メソッド を参照してください。 - クラスター接続
-
ClusterConnectionControl
クラスのstart()
またはstop()
メソッドを使用して、クラスター接続を開始または停止します (h theObjectName
org.apache.activemq.artemis:broker="<broker-name>",component=cluster-connection,name="<cluster-connection-name>"
またはリソース名clusterconnection.<cluster-connection-name>
を使用)。クラスター接続パラメーターは、ClusterConnectionControl
属性を使用して取得できます。詳細は、ブローカークラスターの作成を参照してください。
4.5. 管理通知
以下は、あらゆる種類の通知とメッセージにあるヘッダーの一覧です。すべての通知には、_AMQ_NotifType
(カッコ内に示されている値) と _AMQ_NotifTimestamp
ヘッダがあります。タイムスタンプは、java.lang.System.currentTimeMillis()
への呼び出しの結果で、フォーマットされていません。
通知タイプ | ヘッダー |
---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
4.6. メッセージカウンターの使用
メッセージカウンターを使用して、キューについての情報を経時的に取得します。これは、特に確認が困難な傾向を特定するのに役立ちます。
たとえば、メッセージカウンターを使用して、特定のキューが時間とともにどのように使用されるかを決定できます。また、管理 API を使用してキュー内のメッセージ数に対して一定間隔でクエリーを試行することもできますが、キューがどのように使用されているかを示すことはできません。キュー内のメッセージ数は、クライアントが送信または受信されないか、キューに送信されたメッセージの数が消費されるメッセージの数と等しくないため、定数を維持できます。どちらの場合も、キュー内のメッセージ数は、非常に異なる方法で使用される場合でも同じになります。
4.6.1. メッセージカウンターのタイプ
メッセージカウンターは、ブローカーのキューに関する追加情報を提供します。
count
- ブローカーが起動してからキューに追加されたメッセージの合計数。
countDelta
- 最後のメッセージカウンターの更新以降にキューに追加されたメッセージの数。
messageCount
- キューの現在のメッセージ数。
messageCountDelta
-
最後のメッセージカウンターの更新以降にキューから追加/削除されたメッセージの合計数。たとえば、
messageCountDelta
が-10
の場合、全部で 10 個のメッセージがキューから削除されました。 lastAddTimestamp
- メッセージが最後にキューに追加されたタイムスタンプ。
udpateTimestamp
- 最後のメッセージカウンター更新のタイムスタンプ。
メッセージカウンターを組み合わせて、他の意味のあるデータも判断できます。たとえば、最後の更新以降にキューから消費されたメッセージの数を正確に知るには、countDelta
から messageCountDelta
を減算します。
4.6.2. メッセージカウンターの有効化
メッセージカウンターはブローカーのメモリーに若干影響を与える可能性があるため、デフォルトでは無効になっています。メッセージカウンターを使用するには、まずメッセージカウンターを有効にする必要があります。
手順
-
<broker_instance_dir>/etc/broker.xml
設定ファイルを開きます。 メッセージカウンターを有効にします。
<message-counter-enabled>true</message-counter-enabled>
メッセージカウンター履歴およびサンプリング期間を設定します。
<message-counter-max-day-history>7</message-counter-max-day-history> <message-counter-sample-period>60000</message-counter-sample-period>
message-counter-max-day-history
-
キューメトリクスを保存する必要のある日数。デフォルトは
10
日です。 message-counter-sample-period
-
メトリクスを収集するためにブローカーがキューをサンプリングする頻度 (ミリ秒単位)。デフォルトは
10000
ミリ秒 (10 秒) です。
4.6.3. メッセージカウンターの取得
管理 API を使用してメッセージカウンターを取得できます。
前提条件
ブローカーでメッセージカウンターを有効にする必要があります。
詳細は、「メッセージカウンターの有効化」 を参照してください。
手順
管理 API を使用してメッセージカウンターを取得します。
// Retrieve a connection to the broker's MBeanServer. MBeanServerConnection mbsc = ... JMSQueueControlMBean queueControl = (JMSQueueControl)MBeanServerInvocationHandler.newProxyInstance(mbsc, on, JMSQueueControl.class, false); // Message counters are retrieved as a JSON string. String counters = queueControl.listMessageCounter(); // Use the MessageCounterInfo helper class to manipulate message counters more easily. MessageCounterInfo messageCounter = MessageCounterInfo.fromJSON(counters); System.out.format("%s message(s) in the queue (since last sample: %s)\n", messageCounter.getMessageCount(), messageCounter.getMessageCountDelta());
関連情報
- メッセージカウンターの詳細は、「キュー管理操作」 を参照してください。
第5章 ブローカーランタイムメトリクスのモニターリング
AMQ Broker のインストール時に、Prometheus メトリクスプラグインはインストールに含まれます。Prometheus は、大規模でスケーラブルなシステムを監視し、長期間に履歴ランタイムデータを保存するために構築されたソフトウェアです。プラグインを有効にするには、ブローカー設定を変更する必要があります。有効にすると、プラグインはブローカーのランタイムメトリクスを収集して Prometheus 形式でエクスポートします。その後、Prometheus を使用してメトリクスを確認できます。Grafana などのグラフィカルツールを使用して、データのより高度な可視化を設定することもできます。
Prometheus メトリクスプラグインを使用すると、ブローカーメトリクスを Prometheus形式で収集およびエクスポートできます。ただし、Red Hat では、Prometheus 自体のインストールや設定、または Grafana などの視覚化ツールは、サポートしていません。Prometheus または Grafana のインストール、設定、または実行に関するサポートが必要な場合は、製品の Web サイトにアクセスして、コミュニティーのサポートやドキュメントなどのリソースを入手してください。
Prometheus プラグインによって収集されるブローカーメトリクスのほかに、ブローカー設定を変更して、ブローカーの Java 仮想マシン (JVM) ホストに関連するメトリクスの標準セットをキャプチャーできます。具体的には、ガベージコレクション (GC)、メモリー、スレッドの JVM メトリクスをキャプチャーできます。
これ以降のセクションで以下の方法を説明します。
5.1. ブローカーメトリックの概要
AMQ Broker の Prometheus プラグインを使用し、ブローカーのランタイムメトリックを監視および保存して、ブローカーインスタンスの正常性とパフォーマンスを監視できます。AMQ Broker Prometheus プラグインは、ブローカーのランタイムメトリックを Prometheus 形式にエクスポートし、Prometheus 自体を使用してデータのクエリーを視覚化および実行できるようにします。
Grafana などのグラフィカルツールを使用して、Prometheus プラグインが収集するメトリクスをさらに詳細にわたり視覚化する設定や、ダッシュボードの設定も行うことができます。
プラグインが Prometheus 形式にエクスポートするメトリクスを以下に説明します。各メトリックの説明は、メトリック自体と合わせてエクスポートされます。
ブローカーメトリクス
-
address.memory.usage
-
connection.count
-
total.connection.count
アドレスメトリクス
-
routed.message.count
-
unrouted.message.count
キューメトリクス
-
consumer.count
-
delivering.durable.message.count
-
delivering.durable.persistent.size
-
delivering.message.count
-
delivering.persistent.size
-
durable.message.count
-
durable.persistent.size
-
messages.acknowledged
-
messages.added
-
message.count
-
messages.killed
-
messages.expired
-
persistent.size
-
scheduled.durable.message.count
-
scheduled.durable.persistent.size
-
scheduled.message.count
-
scheduled.persistent.size
上記にリストされていない上位レベルのブローカーメトリクスについては、下位レベルのメトリクスを集計することで算出できます。たとえば、メッセージの合計数を算出するには、ブローカーデプロイメントのすべてのキューから message.count
メトリクスを集約できます。
Java 仮想マシン (JVM) メトリックも Prometheus 形式にエクスポートされます。
5.2. AMQ Broker の Prometheus メトリクスプラグインの有効化
AMQ Broker のインストール時に、Prometheus メトリクスプラグインはインストールに含まれます。プラグインはすでに使用用に設定されていますが、ブローカー設定でプラグインを有効にする必要があります。有効にすると、プラグインはブローカーのランタイムメトリクスを収集して Prometheus 形式でエクスポートします。
次の手順は、AMQ Broker の Prometheus プラグインを有効にする方法を示しています。
手順
AMQ Broker 7.7 の抽出したアーカイブから、ブローカーインスタンスの
lib
ディレクトリーに、Prometheus メトリクスプラグイン.jar
ファイルをコピーします。$ cp amq-broker-7.7.0/lib/artemis-prometheus-metrics-plugin-1.0.0.CR1-redhat-00010.jar <broker-instance-dir>/lib
-
<broker_instance_dir>/etc/broker.xml
設定ファイルを開きます。 ブローカー設定で Prometheus プラグインを有効にします。以下のように設定された
<plugin>
サブ要素を持つ<metrics>
要素を追加します。<metrics> <plugin class-name="org.apache.activemq.artemis.core.server.metrics.plugins.ArtemisPrometheusMetricsPlugin"/> </metrics>
-
broker.xml
設定ファイルを保存します。メトリックプラグインは、Prometheus 形式でブローカーランタイムメトリックの収集を開始します。
5.3. JVM メトリクスを収集するためのブローカーの設定
以下の手順では、ガベージコレクション (GC)、メモリー、およびスレッドの Java 仮想マシン (JVM) メトリクスを収集するようにブローカーを設定する方法を説明します。
前提条件
- ブローカー設定で Prometheus メトリクスプラグインを有効にしている。詳細は、「AMQ Broker の Prometheus メトリクスプラグインの有効化」 を参照してください。
手順
-
<broker_instance_dir>/etc/broker.xml
設定ファイルを開きます。 Prometheus メトリクスプラグインを有効にする際に設定に追加した
<metrics>
要素で、ブローカーがガベージコレクション (GC)、メモリー、およびスレッドに対して JVM メトリクスを収集するかどうかを指定します。以下に例を示します。<metrics> <jvm-gc>true</jvm-gc> <jvm-memory>true</jvm-memory <jvm-threads>true</jvm-threads> <plugin class-name="org.apache.activemq.artemis.core.server.metrics.plugins.ArtemisPrometheusMetricsPlugin"/> </metrics>
注記設定に
jvm-memory
パラメーターを明示的に追加したり、値を指定したりしない場合、ブローカーはデフォルト値のtrue
を使用します。これは、ブローカーはデフォルトで JVM メモリーメトリクスをエクスポートすることを意味します。jvm-gc
およびjvm-threads
パラメーターのデフォルト値はfalse
です。-
broker.xml
設定ファイルを保存します。ブローカーは、有効にした JVM メトリクスの収集を開始します。これらのメトリクスは Prometheus 形式にもエクスポートされます。
5.4. 特定のアドレスのメトリクスコレクションの無効化
AMQ Broker のメトリクスプラグインを設定する場合 (Prometheus メトリクスプラグインなど)、メトリクスコレクションはデフォルトで有効にされます。ただし、特定のアドレスまたはアドレスセットの address-setting
設定要素内で、メトリクスコレクションを明示的に無効にできます。
以下の手順では、特定のアドレスまたはアドレスセットのメトリクスコレクションを無効にする方法を説明します。
手順
-
<broker_instance_dir>/etc/broker.xml
設定ファイルを開きます。 一致するアドレスまたはアドレスセットの
address-setting
要素で、enable-metrics
パラメーターを追加し、パラメーターの値をfalse
に設定します。たとえば、以下の設定では、orders
というアドレスのメトリクスコレクションを無効にします。<configuration> <core> ... <address-settings> <address-setting match="orders"> ... <enable-metrics>false</enable-metrics> ... </address-setting> </address-settings> ... </core> </configuration>
5.5. Prometheus を使用したブローカーランタイムデータへのアクセス
前提条件
- Prometheus プラグインによって収集されるブローカーランタイムデータをクエリーおよび可視化するには、Prometheus をインストールする必要があります。詳細は、Prometheus ドキュメントの Installing Prometheus を参照してください。
手順
-
Prometheus をインストールしたディレクトリーで、
prometheus.yml
設定ファイルを開きます。 -
設定ファイルの
static_configs
セクションで、targets
要素をlocalhost:8161
に変更します。この場所は、ブローカーが Web サーバーを実行する場所です。デフォルトでは、/metrics
はこのホスト名に追加され、ブローカー Web サーバーに保存されているメトリクスへの完全パスを形成します。 Prometheus プラグインによって収集されるブローカーランタイムメトリクスを表示するには、Web ブラウザーで
localhost:8161/metrics
を開きます。生成される Web ページで、ブローカーに設定したキューおよびアドレスに基づいて、プラグインによって収集されるメトリクスの現在の値が表示されます。JVM に複数の実行中のブローカーインスタンスがある場合、各ブローカーのメトリクスが表示されます。
Prometheus インストールディレクトリーから、Prometheus を実行します。
$ ./prometheus
Prometheus が起動すると、シェル出力に以下の行が含まれます。
component=web, msg=”Start listening for connections” address=0.0.0.0:9090
上記の行は、Prometheus がポート 9090 で HTTP トラフィックをリッスンしていることを示しています。
-
Prometheus Web コンソールにアクセスするには、Web ブラウザーで
127.0.0.1:9090
を開きます。 Prometheus Web コンソールで、
Expression
フィールドを使用して、ブローカーデータにクエリーを作成できます。作成するクエリーは、Prometheus クエリー言語 PromQL に基づいています。クエリーの挿入に使用できるブローカーメトリクスはInsert metric
ドロップダウンリストにあります。簡単な例として、DLQ キューのメッセージ数を経時的にクエリーするとします。この場合、メトリクスのドロップダウンリストから
artemis_message_count
を選択します。DLQ キュー名とアドレスを指定してクエリーを完了します。このクエリーの例を以下に示します。artemis_message_count{address=“DLQ”, queue=“DLQ”}
さらに高度な視覚化を行うには、正規表現を使用して、複数のメトリクスをオーバーレイする複雑なクエリーを作成できます。または、多数のメトリクスで数学的な操作 (集計など) を実行することもできます。Prometheus クエリーの作成に関する詳細は、Prometheus ドキュメントの Prometheus のクエリー を参照してください。
改訂日時:2023-01-28 12:18:33 +1000