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
- JBoss Enterprise Application Platform worker node configured. Refer to Chapter 8, Install node with basic configuration for directions.
Disable dynamic proxy discovery
Edit the fileJBOSS_EAP_DIST/jboss-as/server/PROFILE/mod-cluster.sar/META-INF/mod-cluster-jboss-beans.xml
and set theadvertise
property to false:<property name="advertise">false</property>
- Choose, and implement, one of the following static proxy options:
Option 1: Create a static proxy server list
EditJBOSS_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 theproxyList
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
- Edit
JBOSS_EAP_DIST/server/PROFILE/mod-cluster.sar/META-INF/mod-cluster-jboss-beans.xml
- Add the following line:
<property name="domain">${jboss.modcluster.domain:}</property>
- 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
- JBoss Enterprise Web Server worker node configured. Refer to Chapter 8, Install node with basic configuration for directions.
- Understand the Proxy Configuration parameters discussed in Appendix B, Reference: Java properties
Disable dynamic proxy discovery
EditJBOSS_EWS_DIST/tomcat6/conf/server.xml
. and set theadvertise
property of the ModClusterListener to false:Define a mod_cluster listener
Add a <Listener> element toserver.xml
.<Listener className="org.jboss.modcluster.ModClusterListener" advertise="false" stickySession="true" stickySessionForce="false" stickySessionRemove="true"/>
Create a static proxy server list
Add a comma separated list of proxies in the form of IP_ADDRESS:PORT as theproxyList
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"/>