Installation guide

You can specify the port directive as part of the host directive by appending the port number
after the hostname or IP address. For example: worker.node1.host=192.168.2.1:8009 or
worker.node1.host=node1.example.com:8009
port
The port number of the remote server instance listening for defined protocol requests. The
default value is 8009, which is the default listen port for AJP13 workers. If you are using AJP14
workers, this value must be set to 8011.
ping_mode
Specifies the conditions under which connections are probed for their current network health.
The probe uses an empty AJP13 packet for the CPing, and expects a CPong in return, within a
specified timeout.
You specify the conditions by using a combination of the directive flags. The flags are not
comma-separated. For example, a correct directive flag set is worker.node1.ping_mode=CI,
which specifies that the connection will be pinged on connecting to the server and at regular
intervals afterward.
C (connect )
Specifies the connection is probed once after connecting to the server. You specify the
timeout using the connect_timeout directive, otherwise the value for ping_timeout
is used.
P (prepost)
Specifies the connection is probed before sending each request to the server. You
specify the timeout using the prepost_timeout directive, otherwise the value for
ping_timeout is used.
I (inte rval)
Specifies the connection is probed during regular internal maintenance cycles. You
specify the idle time between each interval using the connection_ping_interval
directive, otherwise the value for ping_timeout is used.
A (all)
The most common setting, which specifies all directive flags are applied. For
information about the *_timeout advanced directives, refer directly to Apache Tomcat
Connector - Reference Guide.
ping_t imeout
Specifies the time to wait for CPong answers to a CPing connection probe (refer to ping_mode).
The default value is 10000 (milliseconds).
worker.propert ies Loa d Balancing Directives
lbfact or
Specifies the load-balancing factor for an individual worker, and is only specified for a member
worker of a load balancer.
This directive defines the relative amount of HT TP request load distributed to the worker
compared to other workers in the cluster.
A common example where this directive applies is where you want to differentiate servers with
greater processing power than others in the cluster. For example, if you require a worker to take
three times the load of other workers, specify worker.worker name.lbfactor=3
balance_workers
Specifies the worker nodes that the load balancer must manage. The directive can be used
multiple times for the same load balancer, and consists of a comma-separated list of worker
names as specified in the workers.properties file.
sticky_session
JBoss Enterprise Application Platform 5 HTTP Connectors Load Balancing Guide 81