HTTP Connectors Load Balancing Guide

Define list of workers that will be used
for mapping requests
Define Node1
modify the host as your host IP or DNS name.
Define Node2
modify the host as your host IP or DNS name.
Load-balancing behavior
Status worker for managing load balancer

# Define list of workers that will be used
# for mapping requests
worker.list=loadbalancer,status

# Define Node1
# modify the host as your host IP or DNS name.
worker.node1.port=8009
worker.node1.host=node1.mydomain.com
worker.node1.type=ajp13
worker.node1.ping_mode=A
worker.node1.lbfactor=1 

# Define Node2
# modify the host as your host IP or DNS name.
worker.node2.port=8009
worker.node2.host=node2.mydomain.com
worker.node2.type=ajp13
worker.node2.ping_mode=A
worker.node2.lbfactor=1

# Load-balancing behavior
worker.loadbalancer.type=lb
worker.loadbalancer.balance_workers=node1,node2
worker.loadbalancer.sticky_session=1

# Status worker for managing load balancer
worker.status.type=status

<!--Preceeding syntax removed for readability -->
<Engine name="jboss.web" defaultHost="localhost" jvmRoute="node1">
<!--Proceeding syntax removed for readability -->
</Engine>

<!--Preceeding syntax removed for readability -->
<Engine name="jboss.web" defaultHost="localhost" jvmRoute="node1">
<!--Proceeding syntax removed for readability -->
</Engine>

<Connector protocol="AJP/1.3" port="8009" address="${jboss.bind.address}"
   redirectPort="8443" />

<Connector protocol="AJP/1.3" port="8009" address="${jboss.bind.address}"
   redirectPort="8443" />

LoadModule proxy_balancer_module modules/mod_proxy_balancer.so

LoadModule proxy_balancer_module modules/mod_proxy_balancer.so

Listen IP_ADDRESS:PORT_NUMBER

Listen IP_ADDRESS:PORT_NUMBER

<VirtualHost IP_ADDRESS:PORT_NUMBER>

   <Directory>
      Order deny,allow
      Deny from all
      Allow from 10.33.144.
   </Directory>

   KeepAliveTimeout 60
   MaxKeepAliveRequests 0

   ManagerBalancerName mycluster
   AdvertiseFrequency 5

</VirtualHost>

<VirtualHost IP_ADDRESS:PORT_NUMBER>

   <Directory>
      Order deny,allow
      Deny from all
      Allow from 10.33.144.
   </Directory>

   KeepAliveTimeout 60
   MaxKeepAliveRequests 0

   ManagerBalancerName mycluster
   AdvertiseFrequency 5

</VirtualHost>

ServerAdvertise Off

ServerAdvertise Off

<Listener className="org.jboss.web.tomcat.service.deployers.MicrocontainerIntegrationLifecycleListener" delegateBeanName="ModClusterService"/>

<Listener className="org.jboss.web.tomcat.service.deployers.MicrocontainerIntegrationLifecycleListener" delegateBeanName="ModClusterService"/>

<depends>ModClusterService</depends>

<depends>ModClusterService</depends>

<Engine name="jboss.web" defaultHost="localhost" jvmRoute="worker01">

<Engine name="jboss.web" defaultHost="localhost" jvmRoute="worker01">

/sbin/iptables -A INPUT -m state --state NEW -m udp -p udp --dport 23364 -j ACCEPT 
-m comment --comment "receive mod_cluster proxy server advertisements"
/sbin/iptables save

/sbin/iptables -A INPUT -m state --state NEW -m udp -p udp --dport 23364 -j ACCEPT 
-m comment --comment "receive mod_cluster proxy server advertisements"
/sbin/iptables save

[warning] mod_advertise: ServerAdvertise Address or Port not defined, Advertise disabled!!!

[warning] mod_advertise: ServerAdvertise Address or Port not defined, Advertise disabled!!!

<Listener className="org.jboss.modcluster.ModClusterListener" advertise="true" stickySession="true" stickySessionForce="false" stickySessionRemove="true"/>

<Listener className="org.jboss.modcluster.ModClusterListener" advertise="true" stickySession="true" stickySessionForce="false" stickySessionRemove="true"/>

<Engine name="Catalina" defaultHost="localhost" jvmRoute="worker01">

<Engine name="Catalina" defaultHost="localhost" jvmRoute="worker01">

/sbin/iptables -A INPUT -m state --state NEW -m udp -p udp --dport
 23364 -j ACCEPT 
-m comment -comment "receive mod_cluster proxy server advertisements"

/sbin/iptables -A INPUT -m state --state NEW -m udp -p udp --dport
 23364 -j ACCEPT 
-m comment -comment "receive mod_cluster proxy server advertisements"

[warning] mod_advertise: ServerAdvertise Address or Port not defined, Advertise disabled!!!

[warning] mod_advertise: ServerAdvertise Address or Port not defined, Advertise disabled!!!

<property name="advertise">false</property>

<property name="advertise">false</property>

<Listener className="org.jboss.modcluster.ModClusterListener" advertise="false" stickySession="true" stickySessionForce="false" stickySessionRemove="true"/>

<Listener className="org.jboss.modcluster.ModClusterListener" advertise="false" stickySession="true" stickySessionForce="false" stickySessionRemove="true"/>

apachectl start

[sbin]$ apachectl start

./run-demo.sh

[client]$ ./run-demo.sh

<Engine name="jboss.web" defaultHost="localhost">

<Engine name="jboss.web" defaultHost="localhost">

<Engine name="jboss.web" defaultHost="localhost" jvmRoute="worker01">

<Engine name="jboss.web" defaultHost="localhost" jvmRoute="worker01">

<Engine name="jboss.web" defaultHost="localhost" jvmRoute="worker02">

<Engine name="jboss.web" defaultHost="localhost" jvmRoute="worker02">

<property name="useJK">false</property>

<property name="useJK">false</property>

<property name="useJK">true</property>

<property name="useJK">true</property>

JBOSS_EAP_DIST\bin\run.bat --host=127.0.0.1 -c default-01

JBOSS_EAP_DIST\bin\run.bat --host=127.0.0.1 -c default-01

JBOSS_EAP_DIST\bin\run.bat --host=127.0.0.100 -c default

JBOSS_EAP_DIST\bin\run.bat --host=127.0.0.100 -c default

Configuration file for the ISAPI Redirector
Extension uri definition
Full path to the log file for the ISAPI Redirector
Log level (debug, info, warn, error or trace)
Use debug only testing phase, for production switch to info
Full path to the workers.properties file
Full path to the uriworkermap.properties file

# Configuration file for the ISAPI Redirector
# Extension uri definition
extension_uri=/jboss/isapi_redirect.dll

# Full path to the log file for the ISAPI Redirector
log_file=c:\connectors\isapi_redirect.log

# Log level (debug, info, warn, error or trace)
# Use debug only testing phase, for production switch to info
log_level=debug

# Full path to the workers.properties file
worker_file=c:\connectors\workers.properties

# Full path to the uriworkermap.properties file
worker_mount_file=c:\connectors\uriworkermap.properties

#Full path to the rewrite.properties file 
rewrite_rule_file=c:\connectors\rewrite.properties

#Simple example, images are accessible under abc path
/app-01/abc/=/app-01/images/

#Simple example, images are accessible under abc path
/app-01/abc/=/app-01/images/

images and css files for path /status are provided by worker01
Path /web-console is provided by worker02
IIS (customized) error page is used for http errors with number greater or equal to 400
css files are provided by worker01
Example of exclusion from mapping, logo.gif won't be displayed
!/web-console/images/logo.gif=*
Requests to /app-01 or /app-01/something will be routed to worker01
Requests to /app-02 or /app-02/something will be routed to worker02

# images and css files for path /status are provided by worker01
/status=worker01
/images/*=worker01
/css/*=worker01

# Path /web-console is provided by worker02
# IIS (customized) error page is used for http errors with number greater or equal to 400
# css files are provided by worker01
/web-console/*=worker02;use_server_errors=400
/web-console/css/*=worker01

# Example of exclusion from mapping, logo.gif won't be displayed  
# !/web-console/images/logo.gif=*

# Requests to /app-01 or /app-01/something will be routed to worker01
/app-01|/*=worker01

# Requests to /app-02 or /app-02/something will be routed to worker02
/app-02|/*=worker02

An entry that lists all the workers defined
Entries that define the host and port associated with these workers
First EAP server definition, port 8009 is standard port for AJP in EAP
Second EAP server definition

# An entry that lists all the workers defined
worker.list=worker01, worker02

# Entries that define the host and port associated with these workers

# First EAP server definition, port 8009 is standard port for AJP in EAP 
worker.worker01.host=127.0.0.1
worker.worker01.port=8009
worker.worker01.type=ajp13

# Second EAP server definition
worker.worker02.host= 127.0.0.100
worker.worker02.port=8009
worker.worker02.type=ajp13

Configuration file for the ISAPI Redirector
Extension uri definition
Full path to the log file for the ISAPI Redirector
Log level (debug, info, warn, error or trace)
Use debug only testing phase, for production switch to info
Full path to the workers.properties file
Full path to the uriworkermap.properties file

# Configuration file for the ISAPI Redirector
# Extension uri definition
extension_uri=/jboss/isapi_redirect.dll

# Full path to the log file for the ISAPI Redirector
log_file=c:\connectors\isapi_redirect.log

# Log level (debug, info, warn, error or trace)
# Use debug only testing phase, for production switch to info
log_level=debug

# Full path to the workers.properties file
worker_file=c:\connectors\workers.properties

# Full path to the uriworkermap.properties file
worker_mount_file=c:\connectors\uriworkermap.properties

#OPTIONAL: Full path to the rewrite.properties file 
rewrite_rule_file=c:\connectors\rewrite.properties

#Simple example, images are accessible under abc path
/app-01/abc/=/app-01/images/

#Simple example, images are accessible under abc path
/app-01/abc/=/app-01/images/

images, css files, path /status and /web-console will provided by nodes defined in load-balancer
Example of exclusion from mapping, logo.gif won't be displayed
Requests to /app-01 and /app-02 will be routed to nodes defined in load-balancer
mapping for management console, nodes in cluster can be enabled or disabled here

# images, css files, path /status and /web-console will provided by nodes defined in load-balancer
/css/*=router
/images/*=router
/status=router
/web-console|/*=router

# Example of exclusion from mapping, logo.gif won't be displayed  
!/web-console/images/logo.gif=*

# Requests to /app-01 and /app-02 will be routed to nodes defined in load-balancer
/app-01|/*=router
/app-02|/*=router

# mapping for management console, nodes in cluster can be enabled or disabled here
/jkmanager|/*=status

The advanced router LB worker
First EAP server definition, port 8009 is standard port for AJP in EAP
lbfactor defines how much the worker will be used.
The higher the number, the more requests are served
lbfactor is useful when one machine is more powerful
ping_mode=A – all possible probes will be used to determine that
connections are still working
Second EAP server definition
Define the LB worker
Define the status worker for jkmanager

# The advanced router LB worker
worker.list=router,status

# First EAP server definition, port 8009 is standard port for AJP in EAP
#
# lbfactor defines how much the worker will be used. 
# The higher the number, the more requests are served
# lbfactor is useful when one machine is more powerful 
# ping_mode=A – all possible probes will be used to determine that
# connections are still working

worker.worker01.port=8009
worker.worker01.host=127.0.0.1
worker.worker01.type=ajp13
worker.worker01.ping_mode=A
worker.worker01.socket_timeout=10
worker.worker01.lbfactor=3

# Second EAP server definition
worker.worker02.port=8009
worker.worker02.host= 127.0.0.100
worker.worker02.type=ajp13
worker.worker02.ping_mode=A
worker.worker02.socket_timeout=10
worker.worker02.lbfactor=1

# Define the LB worker
worker.router.type=lb
worker.router.balance_workers=worker01,worker02

# Define the status worker for jkmanager
worker.status.type=status

cp -r default/ default-01
cp -r default/ default-02

[user@workstation jboss-ep-5.1]$ cd jboss-as/server
[user@workstation server]$ cp -r default/ default-01
[user@workstation server]$ cp -r default/ default-02

<Engine name="jboss.web" defaultHost="localhost">

<Engine name="jboss.web" defaultHost="localhost">

<Engine name="jboss.web" defaultHost="localhost" jvmRoute="worker01">

<Engine name="jboss.web" defaultHost="localhost" jvmRoute="worker01">

<Engine name="jboss.web" defaultHost="localhost" jvmRoute="worker02">

<Engine name="jboss.web" defaultHost="localhost" jvmRoute="worker02">

<property name="useJK">false</property>

<property name="useJK">false</property>

<property name="useJK">true</property>

<property name="useJK">true</property>

[user@workstation jboss-eap-5.1]$ ./jboss-as/bin/run.sh -b 127.0.0.1 -c default-01

[user@workstation jboss-eap-5.1]$ ./jboss-as/bin/run.sh -b 127.0.0.1 -c default-01

[user@workstation jboss-eap-5.1]$ ./jboss-as/bin/run.sh -b 127.0.0.100 -c default-02

[user@workstation jboss-eap-5.1]$ ./jboss-as/bin/run.sh -b 127.0.0.100 -c default-02

<!-- ==================== Built In Servlet Mappings ===================== -->

<!-- The servlet mappings for the built in servlets defined above. -->

<!-- The mapping for the default servlet -->
<!--servlet-mapping>
 <servlet-name>default</servlet-name>
 <url-pattern>/</url-pattern>
</servlet-mapping-->

<!-- The mapping for the invoker servlet -->
<!--servlet-mapping>
 <servlet-name>invoker</servlet-name>
 <url-pattern>/servlet/*</url-pattern>
</servlet-mapping-->

<!-- The mapping for the JSP servlet -->
<!--servlet-mapping>
 <servlet-name>jsp</servlet-name>
 <url-pattern>*.jsp</url-pattern>
</servlet-mapping-->

<!-- ==================== Built In Servlet Mappings ===================== -->

<!-- The servlet mappings for the built in servlets defined above. -->

<!-- The mapping for the default servlet -->
<!--servlet-mapping>
 <servlet-name>default</servlet-name>
 <url-pattern>/</url-pattern>
</servlet-mapping-->

<!-- The mapping for the invoker servlet -->
<!--servlet-mapping>
 <servlet-name>invoker</servlet-name>
 <url-pattern>/servlet/*</url-pattern>
</servlet-mapping-->

<!-- The mapping for the JSP servlet -->
<!--servlet-mapping>
 <servlet-name>jsp</servlet-name>
 <url-pattern>*.jsp</url-pattern>
</servlet-mapping-->

Init fn="load-modules" funcs="jk_init,jk_service" shlib="NATIVE/lib/nsapi_redirector.so" shlib_flags="(global|now)"
Init fn="jk_init" worker_file="/tmp/connectors/workers.properties" log_level="debug" log_file="/tmp/connectors/nsapi.log" shm_file="/tmp/connectors/jk_shm"

Init fn="load-modules" funcs="jk_init,jk_service" shlib="NATIVE/lib/nsapi_redirector.so" shlib_flags="(global|now)"
Init fn="jk_init" worker_file="/tmp/connectors/workers.properties" log_level="debug" log_file="/tmp/connectors/nsapi.log" shm_file="/tmp/connectors/jk_shm"

<Object name="default">
      [...]
   NameTrans fn="assign-name" from="/status" name="jknsapi"
   NameTrans fn="assign-name" from="/images(|/*)" name="jknsapi"
   NameTrans fn="assign-name" from="/css(|/*)" name="jknsapi"
   NameTrans fn="assign-name" from="/nc(|/*)" name="jknsapi"
   NameTrans fn="assign-name" from="/jmx-console(|/*)" name="jknsapi"
</Object>

<Object name="default">
      [...]
   NameTrans fn="assign-name" from="/status" name="jknsapi"
   NameTrans fn="assign-name" from="/images(|/*)" name="jknsapi"
   NameTrans fn="assign-name" from="/css(|/*)" name="jknsapi"
   NameTrans fn="assign-name" from="/nc(|/*)" name="jknsapi"
   NameTrans fn="assign-name" from="/jmx-console(|/*)" name="jknsapi"
</Object>

<Object name="jknsapi">
   ObjectType fn=force-type type=text/plain
   Service fn="jk_service" worker="worker01" path="/status"
   Service fn="jk_service" worker="worker02" path="/nc(/*)"
   Service fn="jk_service" worker="worker01"
</Object>

<Object name="jknsapi">
   ObjectType fn=force-type type=text/plain
   Service fn="jk_service" worker="worker01" path="/status"
   Service fn="jk_service" worker="worker02" path="/nc(/*)"
   Service fn="jk_service" worker="worker01"
</Object>

An entry that lists all the workers defined
Entries that define the host and port associated with these workers

# An entry that lists all the workers defined
worker.list=worker01, worker02

# Entries that define the host and port associated with these workers
worker.worker01.host=127.0.0.1
worker.worker01.port=8009
worker.worker01.type=ajp13

worker.worker02.host=127.0.0.100
worker.worker02.port=8009
worker.worker02.type=ajp13

SJWS/PROFILE/stop
SJWS/PROFILE/start

SJWS/PROFILE/stop
SJWS/PROFILE/start

SJWS/PROFILE/bin/stopserv
SJWS/PROFILE/bin/startserv

SJWS/PROFILE/bin/stopserv
SJWS/PROFILE/bin/startserv

<Object name="default">
      [...]
   NameTrans fn="assign-name" from="/status" name="jknsapi"
   NameTrans fn="assign-name" from="/images(|/*)" name="jknsapi"
   NameTrans fn="assign-name" from="/css(|/*)" name="jknsapi"
   NameTrans fn="assign-name" from="/nc(|/*)" name="jknsapi"
   NameTrans fn="assign-name" from="/jmx-console(|/*)" name="jknsapi"
   NameTrans fn="assign-name" from="/jkmanager/*" name="jknsapi"
</Object>

<Object name="default">
      [...]
   NameTrans fn="assign-name" from="/status" name="jknsapi"
   NameTrans fn="assign-name" from="/images(|/*)" name="jknsapi"
   NameTrans fn="assign-name" from="/css(|/*)" name="jknsapi"
   NameTrans fn="assign-name" from="/nc(|/*)" name="jknsapi"
   NameTrans fn="assign-name" from="/jmx-console(|/*)" name="jknsapi"
   NameTrans fn="assign-name" from="/jkmanager/*" name="jknsapi"
</Object>

<Object name="jknsapi">
   ObjectType fn=force-type type=text/plain
   Service fn="jk_service" worker="status" path="/jkmanager(/*)"
   Service fn="jk_service" worker="router"
</Object>

<Object name="jknsapi">
   ObjectType fn=force-type type=text/plain
   Service fn="jk_service" worker="status" path="/jkmanager(/*)"
   Service fn="jk_service" worker="router"
</Object>

The advanced router LB worker
Define the LB worker
Define the status worker

# The advanced router LB worker
worker.list=router,status

#First EAP server definition, port 8009 is standard port for AJP in EAP
#
#lbfactor defines how much the worker will be used. 
#The higher the number, the more requests are served
#lbfactor is useful when one machine is more powerful 
#ping_mode=A – all possible probes will be used to determine that
#connections are still working
worker.worker01.port=8009
worker.worker01.host=127.0.0.1
worker.worker01.type=ajp13
worker.worker01.ping_mode=A
worker.worker01.socket_timeout=10
worker.worker01.lbfactor=3

#Second EAP server definition
worker.worker02.port=8009
worker.worker02.host=127.0.0.100
worker.worker02.type=ajp13
worker.worker02.ping_mode=A
worker.worker02.socket_timeout=10
worker.worker02.lbfactor=1

# Define the LB worker
worker.router.type=lb
worker.router.balance_workers=worker01,worker02

# Define the status worker
worker.status.type=status

SJWS/PROFILE/stop
SJWS/PROFILE/start

SJWS/PROFILE/stop
SJWS/PROFILE/start

SJWS/PROFILE/bin/stopserv
SJWS/PROFILE/bin/startserv

SJWS/PROFILE/bin/stopserv
SJWS/PROFILE/bin/startserv