Installation guide

Chapter 7. Configure basic proxy server
Follow the instructions in this chapter to configure JBoss Enterprise Web Server to use the JBoss HT TP
Connector (mod_cluster).
7.1. Basic proxy configuration overview
Configuration of the proxy server consists of one mandatory and one optional portion:
1. Configure a proxy server listener to receive worker node connection requests and worker node
feedback.
2. Optional: Disable server advertisement.
Server Advertisement
The proxy server can advertise itself using UDP multicast. When UDP multicast is available on the
network between the proxy server and the worker nodes server advertisement allows you to add worker
nodes with no further configuration required on the proxy server, and minimal configuration on the
worker nodes.
If UDP multicast is not available or undesirable, configure the worker nodes with a static list of proxy
servers, as detailed in Section 9.1, “Static proxy configuration. T here is no need in either case to
configure the proxy server with a list of worker nodes.
7.2. Configure a load-balancing proxy using the HTTP Connector
Read this section to configure a load balancing proxy that uses the JBoss HTT P Connector.
Task: Configure a Proxy Server Listener
Follow this task to configure a JBoss Enterprise Web Server Apache service to act as a load-balancing
proxy using the JBoss HTT P Connector.
Prerequisit es
Install JBoss Enterprise Web Server. Refer to JBoss Enterprise Web Server Installation Guide for
details.
Install JBoss HT TP Connector modules. Refer to Chapter 6, Install proxy server components for
details.
1. Creat e a listen direct ive for t he proxy server
Edit the configuration file JBOSS_EWS_DIST/httpd/conf.d/JBoss_HTTP.conf and add the
following:
Listen IP_ADDRESS:PORT_NUMBER
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 T CP connections.
Exa mple 7.1. Example Listen Directive
Listen 10.33.144.3:6666
2. Creat e Virt ual Host
Add the following <VirtualHost> block to JBOSS_EWS_DIST/httpd/conf.d/JBoss_HTTP.conf:
28 Chapter 7. Configure basic proxy server