6.2. JMX を使用した AMQ Broker の管理

手順

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

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

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

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

   注記

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

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

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

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

   注記

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

手順

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

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

   <connector connector-port="1099"/>

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

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

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

   connector-host

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

   rmi-registry-port

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

   jmx-realm

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

   object-name

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

   安全な

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

   key-store-path

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

   key-store-password

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

   key-store-provider

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

   trust-store-path

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

   trust-store-password

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

   trust-store-provider

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

   password-codec

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

   注記

   RMI レジストリーは、バインドする IP アドレスを選択します。システムに複数の IP アドレス/NIC が存在する場合は、artemis.profile ファイルに -Djava.rmi.server.hostname=localhost を追加して、使用する IP アドレスを選択できます。

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