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


Prerequisites

The following are a series of prerequisites for this procedure:

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

To configure JBoss Enterprise Web Server service to act as a load-balancing proxy using the JBoss HTTP Connector:
  1. Create a Listen Directive for the Proxy Server

    Edit the configuration file JBOSS_EWS_DIST/httpd/conf.d/JBoss_HTTP.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/JBoss_HTTP.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
    
    </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 AdvertiseFrequency directive, set to five seconds, makes 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 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, configure worker nodes with a static list of proxy servers. See Section 8.1, “Static Proxy Configuration” for directions.
  4. Restart the JBoss Enterprise Web Server Apache service

    See the JBoss Enterprise Web Server documentation for detailed directions.
Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat