Chapter 9. Advanced configuration
9.1. Static proxy configuration
Note
- 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
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
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"/>