2.2. mod_jk を使用する場合の 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. works.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