6.2. デフォルトのアドレス設定
初期状態では、JBoss EAP には messaging-activemq
サブシステムの設定の一部として単一の address-setting
要素が含まれています。
<subsystem xmlns="urn:jboss:domain:messaging-activemq:4.0"> <server name="default"> ... <address-setting name="#" dead-letter-address="jms.queue.DLQ" expiry-address="jms.queue.ExpiryQueue" max-size-bytes="10485760" page-size-bytes="2097152" message-counter-history-day-limit="10" /> ... </server> </subsystem>
name
属性に単一の #
を使用すると、#
はすべてのアドレスに一致するため、このデフォルトの address-setting
がすべての宛先に使用される設定となります。このキャッチオール設定をこのまますべてのアドレスに適用するか、独自の設定セットを必要とする各アドレスまたはアドレスグループに新しい address-setting
を追加することができます。
管理 CLI を使用したアドレス設定の設定
アドレス設定は、管理 CLI または管理コンソールを使用して設定できますが、管理 CLI の方が編集用に多くの設定属性が公開されています。属性の詳細リストは、本ガイドの付録の アドレス設定の属性 を参照してください。
新しい address-setting の追加
必要に応じて add
操作を使用して新規アドレス設定を作成します。管理 CLI セッションのルートからこのコマンドを実行できます。以下の例では、名前を指定した新しいパターンが作成されます。address-setting
の設定属性を含めることができます。以下では、news.europe.#
に一致する新しい address-setting
が作成され、その dead-letter-address
属性が、あらかじめ作成されたキュー DLQ.news
に設定されます。スタンドアロンサーバーと、full
プロファイルを使用した管理対象サーバードメインの両方の例をそれぞれ示します。
/subsystem=messaging-activemq/server=default/address-setting=news.europe.#/:add(dead-letter-address=DLQ.news)
/profile=full/subsystem=messaging-activemq/server=default/address-setting=news.europe.#/:add(dead-letter-address=DLQ.news)
address-setting 属性の編集
write-attribute
操作を使用して新しい値を属性に書き込みます。タブ補完を使用すると、入力時のコマンド文字列の補完に役立つほか、利用可能な属性を明らかにできます。以下の例は、max-bearery-attempts
の値を 10
に更新します。
/subsystem=messaging-activemq/server=default/address-setting=news.europe.#/:write-attribute(name=max-delivery-attempts,value=10)
/profile=full/subsystem=messaging-activemq/server=default/address-setting=news.europe.#/:write-attribute(name=max-delivery-attempts,value=10)
address-setting 属性の読み取り
値が変更されたことを確認するには、include-runtime=true
パラメーターを指定して read-resource
操作を実行し、サーバーモデルでアクティブな現在の値をすべて開示します。
/subsystem=messaging-activemq/server=default/address-setting=news.europe.#/:read-resource(include-runtime=true)
/profile=full/subsystem=messaging-activemq/server=default/address-setting=news.europe.#/:read-resource(include-runtime=true)
管理コンソールを使用したアドレス設定の設定
以下の手順に従うと、管理コンソールを使用してアドレス設定の作成およびレビューを実行できます。
- 管理コンソールにログインします。
- 画面上部の設定タブを選択します。管理対象ドメインを実行している場合は、更新するプロファイルを選択します。
- Messaging (ActiveMQ) → サーバーを選択します。
-
メッセージングサーバーを選択します。デフォルト設定では、
default
という 1 台のサーバーのみが表示されます。 - 宛先を選択 し、表示をクリックします。
- アドレス設定タブを選択して、アドレス設定を設定します。
news.europe.#
などの新しいパターンを追加する場合、Pattern フィールドは address-setting
要素の name
属性を参照します。管理 CLI を使用して属性の読み取り/書き込みを行う際にこの値を入力します。
管理コンソールを使用する場合は、dead-letter-address
、expiry-address
、redelivery-delay
、および max-delivery-attempts
属性のみを編集できます。その他の属性は、管理 CLI を使用して設定する必要があります。
メッセージングサーバーのグローバルリソースの使用設定
address-setting
要素の 3 つの属性により、メッセージングサーバーのグローバルリソースの使用を制御できます。
属性 | 説明 |
---|---|
|
メモリーのアドレスが満杯になり、 |
|
Artemis がファイルシステムにデータを保存するために使用できる最大領域を制御します。制限に達すると、新しいメッセージはブロックされます。この属性は、ディスク上で利用可能な領域をパーセンテージで示します。最小は |
|
Artemis がファイルシステムで利用可能な領域をチェックする頻度を制御します。デフォルトの値は |