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>

   Copy to Clipboard Toggle word wrap
   重要

   确保 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

      Copy to Clipboard Toggle word wrap
      注意

      所需的语法格式为：/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

      Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap
   注意

   在前面的示例中，确保将 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" >

      Copy to Clipboard Toggle word wrap
      重要

      确保 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>`

      Copy to Clipboard Toggle word wrap
      注意

      确保将 < 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

      Copy to Clipboard Toggle word wrap

流程

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

   • 如果您使用 JBCS Apache HTTP 服务器，请转到 JBCS_HOME/httpd/conf.d 目录。
   • 如果您使用 RHEL Apache HTTP 服务器，请转到 /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 替换为代理服务器用来与 worker 节点通信的服务器网络接口的地址，并将 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>

   Copy to Clipboard Toggle word wrap
   注意

   在前面的示例中，将 IP_ADDRESS 和 PORT_NUMBER 替换为您为 Listen 指令指定的服务器网络接口地址和端口号。

   此地址和端口组合仅用于 mod_proxy_cluster 管理消息。这个地址和端口组合不用于常规流量。

流程

1. 要为 JBoss Web 服务器添加监听程序，在 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. 要为 worker 节点赋予一个唯一的身份，在 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 worker 节点定期向 Apache HTTP 服务器平衡发送包含其当前负载状态的状态消息。这些消息的默认频率为 10 秒。如果您拥有数百个 worker 节点，则 STATUS MCMP 消息可以提高 Apache HTTP 服务器网络上的流量拥塞。

   您可以通过修改 org.jboss.modcluster.container.catalina.status-frequency Java 系统属性来配置 MCMP 消息频率。默认情况下，属性接受以秒为单位指定的值，乘以 10。例如，将 属性设置为 1 表示 10 秒。在前面的示例中，属性设为 6，即 60 秒。

4. 可选： 要为代理服务器公告配置防火墙，请完成以下步骤之一在 worker 节点的防火墙上打开端口 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 多播来广告其自身。大多数操作系统防火墙默认阻止服务器广告功能。要启用服务器公告并接收这些多播信息，您可以为 worker 节点的防火墙上的 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. 要创建静态代理服务器列表，请使用以下格式添加以逗号分隔的代理列表来更新 proxyList 属性： IP_ADDRESS:PORT:IP_ADDRESS:PORT

   例如：

   <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