7.2. Configure a load-balancing proxy using the HTTP Connector
Read this section to configure a load balancing proxy that uses the JBoss HTTP Connector.
Task: Configure a Proxy Server Listener
Follow this task to configure the Apache HTTP Server service to act as a load-balancing proxy using the JBoss HTTP Connector.
Prerequisites
- An installed Web Server distribution, such as JBoss Enterprise Web Server or HPWS installed (designated by HTTPD_HOME in this documentation).
- JBoss HTTP Connector modules. Refer to Chapter 6, Install proxy server components for details.
Create a listen directive for the proxy server
Edit the configuration fileHTTPD_HOME/httpd/conf/JBoss_HTTP.conf
and add the following:Listen IP_ADDRESS:PORT_NUMBER
Listen IP_ADDRESS:PORT_NUMBER
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 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 7.1. Example Listen Directive
Listen 10.33.144.3:6666
Listen 10.33.144.3:6666
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Create Virtual Host
Add the following <VirtualHost> block toHTTPD_HOME/httpd/conf/JBoss_HTTP.conf
:Copy to Clipboard Copied! Toggle word wrap Toggle overflow IP_ADDRESS and PORT_NUMBER match the values from the Listen directive.PARTIAL_IP_ADDRESS is the first 1 to 3 bytes of an IP address, to restrict access to a specific subnet - 10.33.144, for example.Configure SELinux to allow proxy traffic
Enter the following commands as a root-equivalent user to modify the SELinux configuration to allow the proxy traffic:#semanage port -a -t http_port_t -p tcp 8079 #add port to the Apache port list to enable the next command to work #setsebool -P httpd_can_network_relay 1 #for mod_proxy to work
#semanage port -a -t http_port_t -p tcp 8079 #add port to the Apache port list to enable the next command to work #setsebool -P httpd_can_network_relay 1 #for mod_proxy to work
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Optional: Disable Server Advertisement
The presence of theAdvertiseFrequency
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 theVirtualHost
definition:ServerAdvertise Off
ServerAdvertise Off
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 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 9.1, “Static proxy configuration” for directions.Restart the JBoss Enterprise Web Server Apache service
Refer to HTTPD-specific documentation for detailed instructions.