Appendix B. Reference: Java properties
Read this appendix to learn about the JBoss HTTP 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 Attributes
- 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
isfalse
. Default isfalse
. - 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. This property is ignored if
stickySession
isfalse
. Default istrue
. - 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
. - maxAttempts
- 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. Default is
1
. - flushPackets
- 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. The maximum value is determined by the httpd thread configuration (
ThreadsPerChild
or1
). - ttl
- Specifies the time (in seconds) idle connections persist, above the
smax
threshold. Default is60
. - nodeTimeout
- 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. Default is-1
. - balancer
- Specifies the name of the load-balancer. Default is
mycluster
. - domain
- 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).