3.2.8. クラスタリングの変更

手順3.23

1. クラスタリグが有効な状態で JBoss EAP 6 を起動する

   JBoss EAP 5.x でクラスタリングを有効にするには、次のように all プロファイル (またはその派生プロファイル) を使用してサーバーインスタンスを起動する必要がありました。
   $ EAP5_HOME/bin/run.sh -c all
   JBoss EAP 6 でクラスタリングを有効にする方法は、サーバーがスタンドアロンであるかまたは管理ドメインで実行されているかによって異なります。

   1. 管理対象ドメインで実行されているサーバーに対してクラスタリングを有効にする

      ドメインコントローラーを使用して起動したサーバーに対してクラスタリングを有効にするには、domain.xml を更新し、ha プロファイルと ha-sockets ソケットバインディンググループを使用するサーバーグループを指定します。例は次のとおりです。

      <server-groups>
        <server-group name="main-server-group" profile="ha">
          <jvm name="default">
            <heap size="64m" max-size="512m"/>
          </jvm>
          <socket-binding-group ref="ha-sockets"/>
        </server-group>
      </server-group>
      

   2. スタンドアローンサーバーに対してクラスタリングを有効にする

      スタンドアロンサーバーに対してクラスタリングを有効にするには、$ EAP_HOME/bin/standalone.sh --server-config=standalone-ha.xml -Djboss.node.name=UNIQUE_NODE_NAME のように、適切な設定ファイルを使用してサーバーを起動します。

2. バインドアドレスを指定する

   JBoss EAP 5.x では、通常 $ EAP_HOME/bin/run.sh -c all -b 192.168.0.2 のように -b コマンドライン引数を用いて、クラスタリングに使用するバインドアドレスを指定しました。
   JBoss EAP 6 では、JBoss EAP 6 の設定ファイル内の関連するソケットバインディングによってバインドアドレスが明示的に定義されます。ドメインコントローラーを用いて起動したサーバーの場合、バインドアドレスは domain/configuration/host.xml ファイル内で指定されます。スタンドアロンサーバーの場合、バインドアドレスは standalone-ha.xml ファイル内で指定されます。

   <interfaces>
     <interface name="management">
       <inet-address value="192.168.0.2"/>
         </interface>
         <interface name="public">
       <inet-address value="192.168.0.2"/>
     </interface>
   </interfaces>
   

   <socket-binding-groups>
     <socket-binding-group name="ha-sockets" default-interface="public">
       <!-- ... -->
     </socket-binding-group>
   </socket-binding-groups>
   

   上記の例では、public インターフェースは、ha-sockets ソケットバインディンググループ内のすべてのソケットに対するデフォルトのインターフェースとして指定されます。

3. jvmRoute が mod_jk と mod_proxy をサポートするよう設定する

   JBoss EAP 5 では、Web サーバー jvmRoute は server.xml ファイルのプロパティーを使用して設定されていました。JBoss EAP 6 では、jvmRoute 属性は、以下のように instance-id 属性を使用してサーバー設定ファイルの Web サブシステムで設定されます。

   <subsystem xmlns="urn:jboss:domain:web:1.1" default-virtual-server="default-host" native="false" instance-id="{JVM_ROUTE_SERVER}">
   
   

   上記の {JVM_ROUTE_SERVER} は、jvmRoute サーバー ID で置き換える必要があります。
   instance-id は、管理コンソールを使用して設定することもできます。

4. マルチキャストアドレスおよびポートを指定する

   JBoss EAP 5.x では、 $ EAP_HOME/bin/run.sh -c all -u 228.11.11.11 -m 45688 のように、コマンドライン引数 -u を使用してクラスター内の通信に使用されるマルチキャストアドレスを指定できました。 同様に、引数 -m を使用してクラスター内の通信に使用されるポートを指定できました。
   JBoss EAP 6 では、クラスター内の通信に使用されるマルチキャストアドレスとポートは、以下のように該当する JGroups プロトコルにより参照されたソケットバインディングにより定義されます。

   <subsystem xmlns="urn:jboss:domain:jgroups:1.0" default-stack="udp">
       <stack name="udp">
           <transport type="UDP" socket-binding="jgroups-udp"/>
           <!-- ... -->
       </stack>
   </subsystem>
   

   <socket-binding-groups>
       <socket-binding-group name="ha-sockets" default-interface="public">
           <!-- ... -->
           <socket-binding name="jgroups-udp" port="55200" multicast-address="228.11.11.11" multicast-port="45688"/>
           <!-- ... -->
       </socket-binding-group>
   </socket-binding-groups>
   
   

   コマンドラインでマルチキャストアドレスおよびポートを指定する場合は、マルチキャストアドレスとポートをシステムプロパティーとして定義し、サーバーを起動するときにこれらのプロパティーをコマンドラインで使用できます。以下の例では、 jboss.mcast.addr は、マルチキャストアドレスの変数名であり、 jboss.mcast.port はポートの変数名です。

   <socket-binding name="jgroups-udp" port="55200"
    multicast-address="${jboss.mcast.addr:230.0.0.4}" multicast-port="${jboss.mcast.port:45688}"/>
   
   

   次に、コマンドライン引数 $ EAP_HOME/bin/domain.sh -Djboss.mcast.addr=228.11.11.11 -Djboss.mcast.port=45688 を使用してサーバーを起動できます。

5. 代替のプロトコルスタックを使用する

   JBoss EAP 5.x では、jboss.default.jgroups.stack システムプロパティーを使用してすべてのクラスタリングサービスに使用されるデフォルトのプロトコルスタックを操作することができました。$ EAP_HOME/bin/run.sh -c all -Djboss.default.jgroups.stack=tcp
   JBoss EAP 6 では、domain.xml または standalone-ha.xml 内の JGroups サブシステムによってデフォルトのプロトコルスタックが定義されます。

   <subsystem xmlns="urn:jboss:domain:jgroups:1.0" default-stack="udp">
       <stack name="udp">
           <!-- ... -->
       </stack>
   </subsystem>
   

6. バディーレプリケーション

   JBoss EAP 5.x は JBoss Cache のバディーレプリケーションを使用して、クラスターのすべてのインスタンスへのデータレプリケーションを抑制しました。JBoss サーバーの起動時に、コマンドラインで引数 -Djboss.cluster.buddyRepl を渡す必要がありました。
   JBoss EAP 6 ではバディーレプリケーションは、Infinispan のはるかに優れた分散キャッシュまたは DIST モードに置き換えられました。DIST (分散) は強力なクラスタリングモードで、サーバーがクラスターに追加されると Infinispan によって直線的なスケーラビリティを実現できます。サーバーが DIST キャッシングモードを使用するよう設定する方法の例は次のとおりです。
   1. コマンドラインを開き、次のように HA または Full プロファイルのいずれかでサーバーを起動します。

      EAP_HOME/bin/standalone.sh -c standalone-ha.xml

   2. 別のコマンドラインを開き、管理 CLI へ接続します。
      • Linux の場合は、コマンドラインで以下を入力します。

        $ EAP_HOME/bin/jboss-cli.sh --connect
        

      • Windows の場合は、コマンドラインで以下を入力します。

        C:\>EAP_HOME\bin\jboss-cli.bat --connect
        

      次の応答が表示されるはずです。

      Connected to standalone controller at localhost:9999

   3. 以下のコマンドを実行します。

      /subsystem=infinispan/cache-container=web/:write-attribute(name=default-cache,value=dist)
      /subsystem=infinispan/cache-container=web/distributed-cache=dist/:write-attribute(name=owners,value=3)
      :reload
      

      各コマンドの後に、以下の応答が表示されるはずです。

      "outcome" => "success"
      

      これらのコマンドは、standalone-ha.xml ファイルの infinispan サブシステムに以下の設定を作成します。

      <cache-container name="web" aliases="standard-session-cache" default-cache="dist" module="org.jboss.as.clustering.web.infinispan">
          <transport lock-timeout="60000"/>
          <replicated-cache name="repl" mode="ASYNC" batching="true">
              <file-store/>
          </replicated-cache>
          <replicated-cache name="sso" mode="SYNC" batching="true"/>
          <distributed-cache name="dist" owners="3" l1-lifespan="0" mode="ASYNC" batching="true">
              <file-store/>
          </distributed-cache>
      </cache-container>
      
      

      詳細は、https://access.redhat.com/site/documentation/JBoss_Enterprise_Application_Platform/ にある JBoss EAP 6 向け『開発ガイド『』』の章「Web アプリケーションのクラスター化『』」を参照してください。