Red Hat Training
A Red Hat training course is available for Red Hat JBoss Web Server
Appendix B. Java Properties Reference
Read this appendix to learn about the JBoss HTTP Connector mod_cluster configuration properties that apply to a 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 (defaults to
true
) - Specifies whether subsequent requests for a given session should be routed to the same node, if possible.
- stickySessionRemove (defaults to
false
) - 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
isfalse
. - stickySessionForce (defaults to
true
) - 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. This property is ignored if
stickySession
isfalse
. - workerTimeout (defaults to
-1
) - 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 an 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. - maxAttempts (defaults to
1
) - Specifies the number of times the httpd proxy will attempt to send a given request to a worker before aborting. The minimum value is 1: try once before aborting.
- flushPackets (defaults to
false
) - Specifies whether packet flushing is enabled or disabled.
- flushWait (defaults to
-1
) - Specifies the time to wait before flushing packets. A value of
-1
means wait forever. - ping (defaults to
10
) - Time to wait (in seconds) for a pong answer to a ping.
- smax
- Specifies the soft maximum idle connection count. The maximum value is determined by the httpd thread configuration (
ThreadsPerChild
or1
). - ttl (defaults to
60
) - Specifies the time (in seconds) idle connections persist, above the
smax
threshold. - nodeTimeout (defaults to
-1
) - Specifies the time (in seconds) mod_cluster waits for the back-end server response before returning an error.mod_cluster always uses a cping/cpong before forwarding a request. The
connectiontimeout
value used by mod_cluster is the ping value. - balancer (defaults to
mycluster
) - Specifies the name of the load-balancer.
- domain (no default)
- Optional parameter, which specifies how load is balanced across jvmRoutes within the same domain.
domain
is used in conjunction with partitioned session replication (for example, buddy replication).