Installation guide
Reference: Java properties
Read this appendix to learn about the JBoss HT TP Connector (mod_cluster) configuration properties
that apply to either a JBoss Enterprise Application Platform or JBoss Enterprise Application Platform
server node.
B.1. Proxy configuration
The configuration values are sent to proxies under the following conditions:
During server startup;
When a proxy is detected through the advertise mechanism;
During error recovery, when a proxy's configuration is reset.
Proxy Configuration Values
stickySession
Specifies whether subsequent requests for a given session should be routed to the same
node, if possible. Default is true.
stickySessionRemove
Specifies whether the httpd proxy should remove session stickiness if the balancer is unable to
route a request to the node to which it is stuck. This property is ignored if stickySession is
false. Default is false.
stickySessionForce
Specifies whether the httpd proxy should return an error if the balancer is unable to route a
request to the node to which it is stuck. T his property is ignored if stickySession is false.
Default is true.
workerTimeout
Specifies the number of seconds to wait for a worker to become available to handle a request.
When all the workers of a balancer are usable, mod_cluster will retry after a while
(workerTimeout/100) to find a usable worker.
A value of -1 indicates that the httpd will not wait for a worker to be available and will return an
error if no workers are available. Default is -1.
maxAtte mpts
Specifies the number of times the httpd proxy will attempt to send a given request to a worker
before aborting. T he minimum value is 1: try once before aborting. Default is 1.
flushPacke ts
Specifies whether packet flushing is enabled or disabled. Default is false.
flushWait
Specifies the time to wait before flushing packets. A value of -1 means wait forever. Default is -
1.
ping
Time to wait (in seconds) for a pong answer to a ping. Default is 10.
smax
Specifies the soft maximum idle connection count. T he maximum value is determined by the
httpd thread configuration ( ThreadsPerChild or 1 ).
ttl
Specifies the time (in seconds) idle connections persist, above the smax threshold. Default is
60.
node Timeout
Specifies the time (in seconds) mod_cluster waits for the back-end server response before
JBoss Enterprise Application Platform 5 HTTP Connectors Load Balancing Guide 83