付録C クラスター接続設定要素

以下の表は、cluster-connection のすべての設定要素の一覧です。

表C.1 クラスター接続設定要素

名前説明

address

各クラスター接続は、address フィールドで指定された値と一致するアドレスにのみ適用されます。アドレスが指定されていない場合、すべてのアドレスは負荷分散されます。

address フィールドは、アドレスのコンマ区切りリストもサポートします。アドレスが一致しないようにするには、除外構文 ( ! ) を使用します。以下は、アドレスの例です。

jms.eu
jms.eu で始まるすべてのアドレスと一致させます。
!jms.eu
jms.eu で始まるアドレス以外のすべてのアドレスに一致させます。
jms.eu.uk,jms.eu.de
jms.eu.uk または jms.eu.de で始まるすべてのアドレスと一致させます。
jms.eu,!jms.eu.uk
jms.eu で始まるすべてのアドレスと一致させ、jms.eu.uk で始まるアドレスには一致させません。
注記

重複アドレス ( 例 : "europe" および "europe.news") を持つ複数のクラスター接続を持つべきではありません。複数のクラスター接続間で同じメッセージが分散され、配信が重複してしまう可能性があるためです。

call-failover-timeout

フェイルオーバーの試行中に呼び出しが行われる場合に使用します。デフォルトは -1 で、タイムアウトなしです。

call-timeout

パケットがクラスター接続上で送信され、ブロッキング呼び出しである場合、call-timeout は例外を出力する前にブローカーが応答を待つ時間 ( ミリ秒単位 ) を決定します。デフォルトは 30000 です。

check-period

クラスター接続が別のブローカーから ping を受信しなかったかどうかを確認する間隔 ( ミリ秒単位 )。デフォルトは 30000 です。

confirmation-window-size

接続先のブローカーから確認の送信に使用されるウインドウのサイズ (バイト単位)。ブローカーが confirmation-window-size バイトを受信すると、クライアントに通知します。デフォルトは 1048576 です。-1 の値は、ウィンドウがないことを意味します。

connector-ref

適切なクラスタートポロジーを持つようにクラスター内の他のブローカーに送信される コネクター を特定します。このパラメーターは必須です。

connection-ttl

クラスター内の特定のブローカーからメッセージを受信しなくなった場合に、クラスター接続が有効である期間を決定します。既定値は 60000 です。

discovery-group-ref

クラスター内の他のブローカーとの通信に使用される discovery-group を参照します。この要素には discovery-group-name 属性を含める必要があります。これは、以前に設定した discovery-groupname 属性と一致する必要があります。

initial-connect-attempts

クラスターでシステムがブローカーへの接続を試行する回数を設定します。max-retry が達成されると、このブローカーは永続的にダウンしているとみなされ、システムはメッセージをこのブローカーにルーティングしません。デフォルトは -1 で、再試行が無限を意味します。

max-hops

チェーンの中間として他のブローカーにのみ接続される可能性のあるブローカーへのメッセージの負荷分散を行うようにブローカーを設定します。これにより、メッセージ負荷分散を提供しながらより複雑なトポロジーが可能になります。デフォルト値は 1 です。つまり、メッセージはこのブローカーに直接接続された他のブローカーにのみ分散されます。このパラメーターは任意です。

max-retry-interval

再試行の最大遅延 ( ミリ秒単位 )。既定値は 2000 です。

message-load-balancing

クラスターの他のブローカー間でメッセージを分散するかどうか、およびその方法を決定します。負荷分散を有効にするために message-load-balancing 要素を含めます。デフォルト値は ON_DEMAND です。値を指定することもできます。有効な値は以下のとおりです。

OFF
負荷分散を無効にします。
STRICT
キューにアクティブなコンシューマーまたは一致するセレクターがあるかどうかに関係なく、一致するキューを持つすべてのブローカーにメッセージを転送します。
ON_DEMAND
メッセージがアクティブなコンシューマーまたは一致するセレクターを持つブローカーにのみ転送されるようにします。

min-large-message-size

メッセージのサイズ (バイト単位) が min-large-message-size を超える場合には、ネットワーク上で他のクラスターメンバーへの送信時に複数のセグメントに分割されます。デフォルトは 102400 です。

notification-attempts

クラスターへの接続時にクラスター接続がそれ自体をブロードキャストする回数を設定します。デフォルトは 2 です。

notification-interval

クラスターへの接続時にクラスター接続がそれ自体をブロードキャストする頻度 ( ミリ秒単位 ) を設定します。既定値は 1000 です。

producer-window-size

クラスター接続に対するプロデューサーフロー制御のサイズ ( バイト単位 )。デフォルトでは無効になっていますが、クラスターで実際に大きなメッセージを使用している場合は、値を設定します。-1 の値は、ウィンドウがないことを意味します。

reconnect-attempts

システムがクラスターのブローカーへの再接続を試行する回数を設定します。max-retry が達成されると、このブローカーは永続的にダウンしていると見なされ、システムはこのブローカーへのメッセージのルーティングを停止します。デフォルトは -1 で、再試行が無限を意味します。

retry-interval

再試行の間隔 ( ミリ秒単位 ) を指定します。クラスター接続が作成され、ターゲットブローカーが起動または起動されていない場合、他のブローカーからのクラスター接続は、バックアップされるまでターゲットへの接続を再試行します。このパラメーターは任意です。デフォルト値は 500 ミリ秒です。

retry-interval-multiplier

それぞれの再接続試行後に retry-interval を増やすために使用される乗数。デフォルトでは 1 回です。

use-duplicate-detection

クラスター接続はブリッジを使用してブローカーをリンクし、ブリッジを設定して転送される各メッセージに複製 ID プロパティーを追加できます。ブリッジのターゲットブローカーがクラッシュし、復旧すると、メッセージがソースブローカーから再送信される可能性があります。use-duplicate-detectiontrue に設定すると、重複メッセージがフィルターされ、ターゲットブローカーで受信時に無視されます。デフォルトは true です。