14.2. ブローカークラスターの作成

手順

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

2. <core> 要素内に以下のコネクターを追加します。

   • 他のブローカーがこのブローカーに接続する方法を定義するコネクター。
   • このブローカーがクラスター内の他のブローカーに接続する方法を定義する 1 つ以上のコネクター。

   <configuration>
       <core>
           ...
           <connectors>
               <connector name="netty-connector">tcp://localhost:61617</connector>  1
               <connector name="broker2">tcp://localhost:61618</connector>  2
               <connector name="broker3">tcp://localhost:61619</connector>
           </connectors>
           ...
       </core>
   </configuration>

   1

   このコネクターは、他のブローカーがこの接続に使用できる接続情報を定義します。この情報は、検出中にクラスター内の他のブローカーに送信されます。

   2

   broker2 および broker3 コネクターは、このブローカーがクラスター内の 2 つの他のブローカーに接続する方法を定義します。クラスターに他のブローカーがある場合、それらは最初の接続が確立されたときにこれらのコネクターのいずれかによって検出されます。

   コネクターの詳細は、「コネクター」 を参照してください。

3. クラスター接続を追加し、静的検出を使用するように設定します。

   デフォルトでは、クラスター接続は対称トポロジーのすべてのアドレスに対してメッセージの負荷分散を行います。

   <configuration>
       <core>
           ...
           <cluster-connections>
               <cluster-connection name="my-cluster">
                   <connector-ref>netty-connector</connector-ref>
                   <static-connectors>
                       <connector-ref>broker2-connector</connector-ref>
                       <connector-ref>broker3-connector</connector-ref>
                   </static-connectors>
               </cluster-connection>
           </cluster-connections>
           ...
       </core>
   </configuration>

   cluster-connection

   name 属性を使用してクラスター接続の名前を指定します。

   connector-ref

   他のブローカーがこのブローカーに接続する方法を定義するコネクター。

   static-connectors

   このブローカーがクラスター内の別のブローカーへの最初の接続を確立するために使用できる 1 つ以上のコネクター。この最初の接続を行った後、ブローカーはクラスター内の他のブローカーを検出します。クラスターが静的検出を使用する場合のみ、このプロパティーを設定する必要があります。

4. クラスター接続の追加プロパティーを設定します。

   これらの追加のクラスター接続プロパティーには、最も一般的なユースケースに適したデフォルト値があります。そのため、デフォルト動作が必要ない場合のみこのプロパティーを設定する必要があります。詳細は、付録C クラスター接続設定要素 を参照してください。

5. クラスターユーザーおよびパスワードを作成します。

   AMQ Broker にはデフォルトのクラスター認証情報が同梱されていますが、承認されていないリモートクライアントがこれらのデフォルト認証情報を使用してブローカーに接続するのを防ぐため、これらの変更を行う必要があります。

   重要

   クラスターのパスワードは、クラスター内のすべてのブローカーで同じである必要があります。

   <configuration>
       <core>
           ...
           <cluster-user>cluster_user</cluster-user>
           <cluster-password>cluster_user_password</cluster-password>
           ...
       </core>
   </configuration>

6. 追加のブローカーごとにこの手順を繰り返します。

   クラスター設定を各追加ブローカーにコピーできます。ただし、他の AMQ Broker データファイルはコピーしないでください (バインディング、ジャーナル、大きなメッセージディレクトリーなど)。これらのファイルは、クラスター内のノード間で一意である必要があり、クラスターが適切に形成されません。