Installation guide

Table 10.2. Proxy Configurat ion
Attribut e De fault De script ion
stickySession true Indicates whether subsequent
requests for a given session
should, if possible, be routed to
the same node.
stickySessionRemove false Indicates whether the ht t pd
proxy should remove session
stickiness in the event that 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.
stickySessionForce true Indicates whether the ht t pd
proxy should return an error in
the event that 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.
workerTimeout -1 Number of seconds to wait for a
worker to become available to
handle a request. When all the
workers of a balancer are
unusable, mod_cluster will retry
after a specified period
(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 none is available.
maxAttempts 1 Number of times an httpd proxy
will attempt to send a given
request to a worker before
giving up. T he minimum value is
1, meaning try only once.
Note t hat mod_proxy de fault
is also 1: no retry.
flushPackets false Enables/disables packet
flushing.
flushWait -1 Time to wait before flushing
packets. A value of -1 means
wait forever.
ping 10 seconds Time to wait for an answer to a
ping.
smax Determined by ht tpd
configuration.
Soft maximum idle connection
count (that is the smax in worker
mod_proxy documentation). The
maximum value depends on the
httpd thread configuration
(ThreadsPerChild or 1).
ttl 60 seconds Time to live (in seconds) for idle
connections above smax.
nodeTimeout -1 (none) Timeout (in seconds) for proxy
connections to a node. That is
the time mod_cluster will wait for
the back-end response before
returning an error.
This corresponds to timeout in
the worker mod_proxy
documentation.
Note that mod_cluster always
uses a cping/cpong before
forwarding a request and the
connectiontimeout value
used by mod_cluster is the ping
value.
balancer mycluster The balancer name.
domain None If specified, load will be balanced
36 Chapter 10. Java Properties