Red Hat Training

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

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.

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 the file 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="proxyList">${jboss.modcluster.proxyList:}</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.proxyList=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 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.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"/>