2.2. 使用 mod_jk 时 Apache HTTP 服务器负载均衡配置

流程

1. 进入 Apache HTTP 服务器配置目录：

   • 如果您使用 JBCS Apache HTTP 服务器，请转到 JBCS_HOME/httpd/conf.d 目录。
   • 如果您使用 RHEL Apache HTTP 服务器，请转到 /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 服务器可以转发到 mod_jk 模块的 URL。根据 JkMount 指令的配置，mod_jk 将收到的 URL 转发到正确的 servlet 容器。

   要启用 Apache HTTP 服务器直接提供静态内容（或 PHP 内容），且只对 Java 应用程序使用负载均衡器，前面的配置示例指定，Apache HTTP 服务器仅向 mod_jk 负载均衡器使用 URL /application/* 发送请求。

   另外，您还可以将 Apache HTTP 服务器配置为将所有 URL 转发到 mod_jk，方法是在 JkMount 指令中指定 /*。

3. 可选： 要使用 JkMountFile 指令为挂载点指定配置文件，请执行以下步骤：

   1. 进入 Apache HTTP 服务器配置目录：

      • 如果您使用 JBCS Apache HTTP 服务器，请转到 JBCS_HOME/httpd/conf.d 目录。
      • 如果您使用 RHEL Apache HTTP 服务器，请转到 /etc/httpd/conf.d 目录。
   2. 创建名为 uriworkermap.properties 的文件。

   3. 指定您要转发的 URL 和 worker 名称。

      例如：

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

      注意

      所需的语法格式为：/URL=WORKER_NAME

      前面的示例将 mod_jk 配置为将 /application 的请求转发到 JBoss Web Server Tomcat 后端。

   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 服务器日志记录，请执行以下步骤之一：

   • 在 JkRequestLogFormat 指令中包含 %w，如上一步中有关 mod_jk.conf 设置所示。
   • 通过在 Apache HTTP Server LogFormat(s)中包含 %{JK_WORKER_NAME}n，记录您要使用的 mod_jk worker 的名称。

流程

1. 进入 Apache HTTP 服务器配置目录：

   • 如果您使用 JBCS Apache HTTP 服务器，请转到 JBCS_HOME/httpd/conf.d 目录。
   • 如果您使用 RHEL Apache HTTP 服务器，请转到 /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 设置替换为与您的环境相关的值。

   重要

   使用 Tomcat AJP Connector 时，需要 secret 属性。您可以在 workers.properties 文件中指定 worker 节点或负载均衡器的 secret 属性。例如：

   worker.<WORKER_NAME>.secret=<YOUR_AJP_SECRET>

   在上例中，将 <WORKER_NAME> 和 <YOUR_AJP_SECRET> 替换为与您环境相关的值。

流程

1. 在 JBoss Web Server 主机上，为每个 worker 节点的 Engine 中为 jvmRoute 属性配置唯一值：

   1. 打开 JWS_HOME/tomcat_<VERSION>_/conf/server.xml 文件。

   2. 输入以下详情：

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

      重要

      确保 jvmRoute 属性值与您在 Apache HTTP 服务器主机上 worker.properties 文件中指定的 worker 名称匹配。

2. 在 Apache HTTP Server 主机上，为 worker 节点或负载均衡器指定 secret 属性：

   1. 进入 Apache HTTP 服务器配置目录：

      • 如果您使用 JBCS Apache HTTP 服务器，请转到 JBCS_HOME/httpd/conf.d 目录。
      • 如果您使用 RHEL Apache HTTP 服务器，请转到 /etc/httpd/conf.d 目录。
   2. 打开 workers.properties 文件。

   3. 确保 secret 属性以以下格式指定：

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

      注意

      确保将 < WORKER_NAME&gt; 和 < 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