Red Hat Training

A Red Hat training course is available for Red Hat JBoss Web Server

Chapter 8. Advanced Configuration

Read this chapter to configure advanced features of the JBoss HTTP Connector.

8.1. Static Proxy Configuration

Server advertisement allows worker nodes to dynamically discover and register themselves with proxy servers. If UDP broadcast is not available or server advertisement is disabled then worker nodes must be configured with a static list of proxy server addresses and ports.

Procedure 8.1. Configure Application Platform Worker Node with Static Proxy List

Follow this task to configure a JBoss Enterprise Application Platform worker node to operate with static list of proxy servers.
The only prerequisite for this procedure is that the JBoss Enterprise Application Platform worker node is configured. Refer to Chapter 7, Install Node with Basic Configuration for directions.

  1. Disable Dynamic Proxy Discovery

    Edit the standalone/configuration/standalone-ha.xml file and set the advertise property to false as follows: 
     <mod-cluster-config advertise='false" connector="ajp" proxy-list="${jboss.modcluster.proxyList:}">
  2. Choose and implement one of the following static proxy options:

    • Option 1: Create a Static Proxy Server List

      Edit the file standalone/configuration/standalone-ha.xml and add a comma separated list of proxies in the form of IP_ADDRESS:PORT in the proxyList property.

      Example 8.1. Example Static Proxy List

      <mod-cluster-config advertise="false" connector="ajp" proxy-list="10.33.144.3:6666,10.33.144.1:6666">

    • Option 2: Start the Worker Node with a Static Proxy List as a Parameter

      1. Edit standalone/configuration/standalone-ha.xml.
      2. Add the following line: 
        <mod-cluster-config advertise="false" connector="ajp" proxy-list="${jboss.modcluster.proxyList:}">
      3. Add a comma separated list of proxies in the form of IP_ADDRESS:PORT as the jboss.modcluster.proxyList parameter when starting the node.

        Example 8.2. Example Static Proxy List Parameter

        -Djboss.modcluster.proxyList=10.33.144.3:6666,10.33.144.1:6666

Procedure 8.2. Configure Web Server Worker Node with Static Proxy List

Follow this procedure to configure a JBoss Enterprise Web Server worker node to operate with a static list of proxy servers.
Prerequisites for this procedure are that a JBoss Enterprise Web Server worker node is configured (refer to Chapter 7, Install Node with Basic Configuration for directions) and an understanding of the proxy configuration parameters discussed in Appendix B, Java Properties Reference.

  1. Disable dynamic proxy discovery

    Edit the file JBOSS_EWS_DIST/tomcat6/conf/server.xml. and set the advertise property of the ModClusterListener to false:

  2. Define a mod_cluster listener

    Add a <Listener> element to the server.xml file . 
    <Listener className="org.jboss.modcluster.container.catalina.standalone.ModClusterListener" advertise="false" stickySession="true" stickySessionForce="false" stickySessionRemove="true"/>

  3. Create a static proxy server list

    Add a comma separated list of proxies in the form of IP_ADDRESS:PORT as the proxyList property of the ModClusterListener <Listener> element.

    Example 8.3. Example Static Proxy List

    <Listener className="org.jboss.modcluster.container.catalina.standalone.ModClusterListener" advertise="false" stickySession="true" stickySessionForce="false" stickySessionRemove="true" proxyList="10.33.144.3:6666,10.33.144.1:6666"/>