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_jk.conf という名前の新しいファイルを作成し、次の設定の詳細を入力します。

   # Load mod_jk module
   # Specify the filename of the mod_jk lib
   LoadModule jk_module modules/mod_jk.so
   
   # Where to find workers.properties
   JkWorkersFile conf.d/workers.properties
   
   # Where to put jk logs
   JkLogFile logs/mod_jk.log
   
   # Set the jk log level [debug/error/info]
   JkLogLevel info
   
   # Select the log format
   JkLogStampFormat  "[%a %b %d %H:%M:%S %Y]"
   
   # JkOptions indicates to send SSL KEY SIZE
   JkOptions +ForwardKeySize +ForwardURICompat -ForwardDirectories
   
   # JkRequestLogFormat
   JkRequestLogFormat "%w %V %T"
   
   # Mount your applications
   JkMount /application/* loadbalancer
   
   # Add shared memory.
   # This directive is present with 1.2.10 and
   # later versions of mod_jk, and is needed for
   # for load balancing to work properly
   JkShmFile logs/jk.shm
   
   # Add jkstatus for managing runtime data
   <Location /jkstatus/>
       JkMount status
       Require ip 127.0.0.1
   </Location>

   重要

   LoadModule ディレクティブが、インストールした mod_jk ネイティブバイナリーを参照していることを確認します。

   注記

   JkMount ディレクティブは、Apache HTTP Server が mod_jk モジュールに転送できる URL を指定します。JkMount ディレクティブの設定に基づいて、mod_jk は受信した URL を正しいサーブレットコンテナーに転送します。

   Apache HTTP Server が静的コンテンツ (または PHP コンテンツ) を直接提供し、Java アプリケーションにのみロードバランサーを使用できるようにするには、前述の設定例では、Apache HTTP Server が URL /application/* のリクエストのみを mod_jk ロードバランサーに送信するよう指定します。

   または、JkMount ディレクティブで /* を指定して、すべての URL を mod_jk に転送するように Apache HTTP Server を設定することもできます。

3. オプション: JkMountFile ディレクティブを使用してマウントポイントの設定ファイルを指定するには、次の手順を実行します。

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

      • JBCS Apache HTTP Server を使用している場合は、JBCS_HOME/httpd/conf.d ディレクトリーに移動します。
      • RHEL Apache HTTP Server を使用している場合は、/etc/httpd/conf.d ディレクトリーに移動します。
   2. uriworkermap.properties という名前のファイルを作成します。

   3. 転送する URL とワーカー名を指定します。

      以下に例を示します。

      # Simple worker configuration file
      
      # Mount the Servlet context to the ajp13 worker
      /application=loadbalancer
      /application/*=loadbalancer

      注記

      必要な構文は次の形式です: /URL = WORKER_NAME

      上記の例では、/application のリクエストを JBoss Web Server Tomcat バックエンドに転送するように mod_jk を設定しています。

   4. mod_jk.conf ファイルに、次のディレクティブを入力します。

      # Use external file for mount points.
      # It will be checked for updates each 60 seconds.
      # The format of the file is: /url=worker
      # /examples/*=loadbalancer
      JkMountFile conf.d/uriworkermap.properties

4. オプション: Apache HTTP Server のログを有効にするには、次のいずれかの手順を実行します。

   • mod_jk.conf 設定に関する前の手順で示したように、JkRequestLogFormat ディレクティブに %w を含めます。
   • %{JK_WORKER_NAME}n を Apache HTTP Server LogFormat(s) に含めて、使用する mod_jk ワーカーの名前をログに記録します。

手順

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

   • JBCS Apache HTTP Server を使用している場合は、JBCS_HOME/httpd/conf.d ディレクトリーに移動します。
   • RHEL Apache HTTP Server を使用している場合は、/etc/httpd/conf.d ディレクトリーに移動します。
2. workers.properties という名前のファイルを作成します。

3. 次の設定の詳細を入力します。

   # Define list of workers that will be used
   # for mapping requests
   worker.list=loadbalancer,status
   
   # Define Node1
   # modify the host as your host IP or DNS name.
   worker.node1.port=8009
   worker.node1.host=node1.mydomain.com
   worker.node1.type=ajp13
   worker.node1.ping_mode=A
   worker.node1.lbfactor=1
   worker.node1.secret=<YourSecret>
   
   # Define Node2
   # modify the host as your host IP or DNS name.
   worker.node2.port=8009
   worker.node2.host=node2.mydomain.com
   worker.node2.type=ajp13
   worker.node2.ping_mode=A
   worker.node2.lbfactor=1
   worker.node1.secret=<YourSecret>
   
   # Load-balancing behavior
   worker.loadbalancer.type=lb
   worker.loadbalancer.balance_workers=node1,node2
   worker.loadbalancer.sticky_session=1
   
   # Status worker for managing load balancer
   worker.status.type=status

   注記

   前の例で、host、port、および secret の設定を環境に適した値に置き換えてください。

   重要

   secret プロパティーは Tomcat AJP コネクターを使用する場合に必要になります。ワーカーノードまたはロードバランサーの シークレット プロパティーは、workers.properties ファイルで指定できます。以下に例を示します。

   worker.<WORKER_NAME>.secret=<YOUR_AJP_SECRET>

   前の例で、<WORKER_NAME> と <YOUR_AJP_SECRET> を環境に適した値に置き換えます。

手順

1. JBoss Web Server ホスト上で、各ワーカーノードのエンジンの jvmRoute 属性に対して一意の値を設定するには、以下を実行します。

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

   2. 以下の詳細を入力します。

      <Engine name="Catalina" jvmRoute="node1" >

      重要

      jvmRoute 属性値が、Apache HTTP Server ホスト上の workers.properties ファイルで指定したワーカー名と一致していることを確認してください。

2. Apache HTTP Server ホスト上で、ワーカーノードまたはロードバランサーの secret プロパティーを指定するには、以下を実行します。

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

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

   3. secret プロパティーが次の形式で指定されていることを確認してください。

      worker.<WORKER_NAME>.secret=<YOUR_AJP_SECRET>`

      注記

      <WORKER_NAME> と <YOUR_AJP_SECRET> は、使用している環境に適した値に置き換えてください。

      注記

      ProxyPass ディレクティブを使用してロードバランサーに secret を設定すると、ロードバランサーの全メンバーがこの secret を継承します。以下に例を示します。

      <Proxy balancer://mycluster>`
          BalancerMember ajp://node1:8009 route=node1 secret=YOUR_AJP_SECRET
          BalancerMember ajp://node2:8009 route=node2 secret=YOUR_AJP_SECRET
      </Proxy>
      ProxyPass /example/ balancer://mycluster/example/ stickysession=JSESSIONID|jsessionid

手順

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

   注記

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

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

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

   <VirtualHost IP_ADDRESS:PORT_NUMBER>
   
      <Directory />
         Require ip IP_ADDRESS
      </Directory>
   
      KeepAliveTimeout 60
      MaxKeepAliveRequests 0
   
      ManagerBalancerName mycluster
      AdvertiseFrequency 5
      EnableMCPMReceive On
   
   </VirtualHost>

   注記

   前の例で、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" />

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

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

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

   以下に例を示します。

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

   注記

   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

   • 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"'

     注記

     プロキシーサーバーが 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"/>

   注記

   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"/>