6.2. Configure a Load-balancing Proxy Using the HTTP Connector

Procedure 6.1. Configure a Load-balancing Proxy Using the HTTP Connector

1. Create a Listen Directive for the Proxy Server

   Edit the configuration file JBOSS_EWS_DIST/httpd/conf.d/mod_cluster.conf and add the following:

   Listen IP_ADDRESS:PORT_NUMBER

   Copy to Clipboard Toggle word wrap
   Where IP_ADDRESS is the IP address of a server network interface to communicate with the worker nodes, and PORT_NUMBER is the port on that interface to listen on.

   Note

   The port PORT_NUMBER must be open on the server firewall for incoming TCP connections.

   Example 6.1. Example Listen Directive

   Listen 10.33.144.3:6666

   Copy to Clipboard Toggle word wrap

2. Create Virtual Host

   Add the following to the file JBOSS_EWS_DIST/httpd/conf.d/mod_cluster.conf:

   <VirtualHost IP_ADDRESS:PORT_NUMBER> 
   
      <Directory />
         Order deny,allow
         Deny from all
         Allow from 10.33.144.
      </Directory>
   
      KeepAliveTimeout 60
      MaxKeepAliveRequests 0
   
      ManagerBalancerName mycluster
      AdvertiseFrequency 5
      EnableMCPMReceive On
   
      <Location /mod_cluster-manager>
          SetHandler mod_cluster-manager
          Order deny,allow
          Deny from all
          Allow from 10.33.144.
      </Location>
   
   </VirtualHost>

   Copy to Clipboard Toggle word wrap
   Where IP_ADDRESS and PORT_NUMBER are the values from the Listen directive.

3. Optional: Disable Server Advertisement

   The presence of the AdvertiseFrequency directive, which is set to five seconds here, causes the server to periodically send server advertisement messages via UDP multicast.
   These server advertisement messages contain the IP_ADDRESS and PORT_NUMBER specified in the VirtualHost definition. Worker nodes that are configured to respond to server advertisements use this information to register themselves with the proxy server.
   To disable server advertisement, add the following directive to the VirtualHost definition:

   ServerAdvertise Off

   Copy to Clipboard Toggle word wrap
   If server advertisements are disabled, or UDP multicast is not available on the network between the proxy server and the worker nodes, you must configure worker nodes with a static list of proxy servers. Refer to Section 8.1, “Static Proxy Configuration” for directions.

4. Restart the JBoss Enterprise Web Server Apache service

   Refer to the JBoss Enterprise Web Server documentation for detailed directions.