Chapter 4. Configuration example for load-balancing with mod_proxy_cluster

Procedure

1. Go to the JBCS_HOME/httpd/conf.d/ directory.
2. Create a file named mod_proxy_cluster.conf.

3. Enter the following configuration details:

   LoadModule proxy_cluster_module modules/mod_proxy_cluster.so
   LoadModule cluster_slotmem_module modules/mod_cluster_slotmem.so
   LoadModule manager_module modules/mod_manager.so
   LoadModule advertise_module modules/mod_advertise.so
   
   MemManagerFile cache/mod_proxy_cluster
   
   <IfModule manager_module>
     Listen 6666
     <VirtualHost *:6666>
       <Location />
         Require ip 127.0.0.1
       </Location>
       ServerAdvertise on
       EnableMCMPReceive
       <Location /mod_cluster_manager>
         SetHandler mod_cluster-manager
         Require ip 127.0.0.1
      </Location>
     </VirtualHost>
   </IfModule>

   Important

   As shown in the preceding example, the mod_proxy_cluster package requires that you set the MemManagerFile directive in the conf.d file to cache/mod_proxy_cluster.

   If you specify the EnableMCMPReceive directive in your virtual host, the Apache HTTP Server requires that you always use Location elements rather than Directory elements in the virtual host definition. From JBCS 2.4.62 onward, the Apache HTTP Server does not support the use of Directory elements and the EnableMCMPReceive directive within the same virtual host. If you specify a Directory element and the EnableMCMPReceive directive within the same virtual host, the Apache HTTP Server fails to start and logs an error indicating that you should use a Location element instead. The startup failure was introduced in JBCS 2.4.62 as a breaking change that is not compatible with earlier releases.

   Note

   The preceding example shows how to set up JBCS as a proxy server that is listening on localhost.

Procedure

1. Open the JWS_HOME/tomcat<VERSION>/conf/server.xml file.

2. Add the following Listener element:

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