3.3. mod_proxy_cluster を使用する場合の Apache HTTP Server 負荷分散設定

手順

1. Apache HTTP Server 設定ディレクトリーに移動します。

   • JBCS Apache HTTP Server を使用している場合は、JBCS_HOME/httpd/conf.d ディレクトリーに移動します。
   • RHEL Apache HTTP Server を使用している場合は、/etc/httpd/conf.d ディレクトリーに移動します。
2. mod_proxy_cluster.conf ファイルを開きます。

3. プロキシーサーバーの Listen ディレクティブを作成するには、mod_proxy_cluster.conf ファイルに次の行を入力します。

   Listen IP_ADDRESS:PORT_NUMBER

   Copy to Clipboard Toggle word wrap
   注記

   上記の例では、プロキシーサーバーがワーカーノードと通信するために使うサーバーネットワークインターフェイスのアドレスに IP_ADDRESS をプロキシーサーバーがワーカーノードと通信するのに使うサーバーネットワークインターフェイスのアドレスに、をプロキシーサーバーがリッスンするポートに置き換えてください。PORT_NUMBER をプロキシーサーバーがリッスンするポートに置き換えます。

   着信 TCP 接続用にポートが開いていることを確認します。

4. 仮想ホストを作成するには、mod_proxy_cluster.conf ファイルに次の詳細を入力します。

   <VirtualHost IP_ADDRESS:PORT_NUMBER>
      DirectoryIndex disabled
      <Location />
         Require ip IP_ADDRESS
      </Location>
   
      KeepAliveTimeout 60
      MaxKeepAliveRequests 0
   
      ManagerBalancerName mycluster
      AdvertiseFrequency 5
      EnableMCMPReceive On
   
      <Location /mod_cluster_manager>
         SetHandler mod_cluster-manager
         Require ip IP_ADDRESS
      </Location>
   
   </VirtualHost>

   Copy to Clipboard Toggle word wrap
   重要

   仮想ホストで EnableMCMPReceive ディレクティブを指定する場合、Apache HTTP Server では、仮想ホスト定義で Directory 要素ではなく、常に Location 要素を使用する必要があります。JBCS 2.4.62 以降、Apache HTTP Server は、同じ仮想ホスト内での Directory 要素と EnableMCMPReceive ディレクティブの使用をサポートしていません。同じ仮想ホスト内で Directory 要素と EnableMCMPReceive ディレクティブを指定すると、Apache HTTP Server は起動に失敗し、代わりに Location 要素を使用する必要があることを示すエラーがログに記録されます。起動エラーは、以前のリリースと互換性のない重大な変更として、JBCS 2.4.62 で導入されました。

   注記

   前の例で、IP_ADDRESS と PORT_NUMBER を、Listen ディレクティブに指定したサーバーネットワークインターフェイスのアドレスとポート番号に置き換えます。

   このアドレスとポートの組み合わせは、mod_proxy_cluster 管理メッセージにのみ使用されます。このアドレスとポートの組み合わせは、一般的なトラフィックには使用されません。

手順

1. JBoss Web Server にリスナーを追加するには、JWS_HOME/tomcat <VERSION>/conf/server.xml ファイルで、他の Listener 要素の下に次の Listener 要素を追加します。

   <Listener className="org.jboss.modcluster.container.catalina.standalone.ModClusterListener" advertise="true" stickySession="true" stickySessionForce="false" stickySessionRemove="true" />

   Copy to Clipboard Toggle word wrap

2. ワーカーノードに一意のアイデンティティーを与えるには、JWS_HOME/tomcat <VERSION>/conf/server.xml ファイルで、jvmRoute 属性と値を Engine 要素に追加します。

   <Engine name="Catalina" defaultHost="localhost" jvmRoute="worker01">

   Copy to Clipboard Toggle word wrap

3. STATUS MCMP メッセージの頻度を設定するには、org.jboss.modcluster.container.catalina.status-frequency Java システムプロパティーを変更します。

   以下に例を示します。

   -Dorg.jboss.modcluster.container.catalina.status-frequency=6

   Copy to Clipboard Toggle word wrap
   注記

   JBoss Web Server は、現在の負荷ステータスを含むステータスメッセージを Apache HTTP Server バランサーに定期的に送信します。これらのメッセージのデフォルトの頻度は 10 秒です。数百のワーカーノードがある場合、STATUS MCMP メッセージによって Apache HTTP Server ネットワークのトラフィック輻輳が増える可能性があります。

   MCMP メッセージ頻度を設定するには、org.jboss.modcluster.container.catalina.status-frequency Java システムプロパティーを変更します。デフォルトでは、プロパティーは秒単位で指定された値を 10 倍して受け入れます。たとえば、プロパティーを 1 に設定すると 10 秒になります。前の例では、プロパティーは 6 に設定されており、これは 60 秒を意味します。

4. オプション: プロキシーサーバーのアドバタイズ用にファイアウォールを設定するには、次のいずれかの手順を実行して、ワーカーノードのファイアウォールで UDP 接続用のポート 23364 を開きます。

   • RHEL の場合:

     firewall-cmd --permanent --zone=public --add-port=23364/udp

     Copy to Clipboard Toggle word wrap

   • PowerShell を使用する Windows Server の場合:

     Start-Process "$psHome\powershell.exe" -Verb Runas -ArgumentList '-command "NetSh Advfirewall firewall add rule name="UDP Port 23364" dir=in  action=allow protocol=UDP localport=23364"'
     Start-Process "$psHome\powershell.exe" -Verb Runas -ArgumentList '-command "NetSh Advfirewall firewall add rule name="UDP Port 23364" dir=out action=allow protocol=UDP localport=23364"'

     Copy to Clipboard Toggle word wrap
     注記

     プロキシーサーバーが mod_proxy_cluster を使用する場合、プロキシーサーバーは UDP マルチキャストを使用して自身をアドバタイズできます。ほとんどのオペレーティングシステムのファイアウォールは、デフォルトでサーバーアドバタイズメント機能をブロックします。サーバーアドバタイズメントを有効にしてこれらのマルチキャストメッセージを受信するには、前述の例に示すように、ワーカーノードのファイアウォールで UDP 接続用にポート 23364 を開くことができます。

手順

1. JWS_HOME/tomcat<VERSION>/conf/server.xml ファイルを開きます。

2. mod_proxy_cluster リスナーを定義して動的プロキシー検出を無効にするには、ModClusterListener の Listener 要素を追加または変更します。

   以下に例を示します。

   <Listener className="org.jboss.modcluster.container.catalina.standalone.ModClusterListener" advertise="false" stickySession="true" stickySessionForce="false" stickySessionRemove="true"/>

   Copy to Clipboard Toggle word wrap
   注記

   advertise プロパティーを false に設定していることを確認してください。

3. 静的プロキシーサーバーリストを作成するには、プロキシーのコンマ区切りリストを、IP_ADDRESS:PORT,IP_ADDRESS:PORT の形式で追加して、proxyList プロパティーを更新します。

   以下に例を示します。

   <Listener className="org.jboss.modcluster.container.catalina.standalone.ModClusterListener" advertise="false" stickySession="true" stickySessionForce="false" stickySessionRemove="true" proxyList="10.33.144.3:6666,10.33.144.1:6666"/>

   Copy to Clipboard Toggle word wrap