Chapter 9. Advanced configuration

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

9.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.

Note

Make sure your configuration definition meets the following character limits:
  • Maximum Alias length: 100 character (for example, if myapp.war is deployed in /myapp, then/myapp is the context)
  • Maximum balancer name length: 40 (thebalancer property in MBean)
  • Maximum domain name length: 20 (thedomain property in MBean)

Task: Configure Application Platform Worker Node with Static Proxy List

Follow this task to configure a JBoss Enterprise Application Platform worker node to operate with a static list of proxy servers.

Prerequisites

  1. Disable dynamic proxy discovery

    Edit the file JBOSS_EAP_DIST/jboss-as/server/PROFILE/mod-cluster.sar/META-INF/mod-cluster-jboss-beans.xml and set the advertise property to false: 
    <property name="advertise">false</property>
  2. Choose, and implement, one of the following static proxy options:

    • Option 1: Create a static proxy server list

      Edit JBOSS_EAP_DIST/jboss-as/server/PROFILE/mod-cluster.sar/META-INF/mod-cluster-jboss-beans.xml and add a comma separated list of proxies in the form of IP_ADDRESS:PORT in the proxyList property.

      Example 9.1. Example Static Proxy List

      <property name="proxyList">10.33.144.3:6666,10.33.144.1:6666</property>

    • Option 2: Start the worker node with a static proxy list as a parameter

      1. Edit JBOSS_EAP_DIST/server/PROFILE/mod-cluster.sar/META-INF/mod-cluster-jboss-beans.xml
      2. Add the following line: 
        <property name="domain">${jboss.modcluster.domain:}</property>
      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 9.2. Example Static Proxy List Parameter

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

Task: 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

  1. Disable dynamic proxy discovery

    Edit 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 server.xml. 
    <Listener className="org.jboss.modcluster.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 9.3. Example Static Proxy List

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