-
Language:
English
-
Language:
English
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 Tomcat 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.
Important
Clustering is not supported in Tomcat for JBoss Enterprise Web Server 2.0.
Table B.1. Proxy Configuration Values for Tomcat
Value | Default | Description |
---|---|---|
stickySession | true | Specifies whether subsequent requests for a given session should be routed to the same node, if possible. |
stickySessionRemove | 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 is false . |
stickySessionFalse | 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 is false . |
workerTimeout | -1 | Specifies the number of seconds to wait for a worker to become available to handle a request. When none of the workers of a balancer are unusable, mod_cluster retries after an interval (the interval value is the result of dividing the value of workerTimeout by 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 | 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 | false | Specifies whether packet flushing is enabled or disabled. |
flushWait | -1 | Specifies the time to wait before flushing packets. A value of -1 means wait forever. |
ping | 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 or 1 ). |
ttl | 60 | Specifies the time (in seconds) idle connections persist, above the smax threshold. |
nodeTimeout | -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 | mycluster | Specifies the name of the load-balancer. |
loadBalancingGroup | - | Optional parameter, which specifies how load is balanced across jvmRoutes within the same load balancing group. loadBalancingGroup is used in conjunction with partitioned session replication (for example, buddy replication). |
Table B.2. Proxy Configuration Values for JBoss Enterprise Application Platform 6
Attribute | Property | Default | Description |
---|---|---|---|
sticky-session | stickySession | true | Specifies whether subsequent requests for a given session should be routed to the same node, if possible. |
sticky-session-remove | stickySessionRemove | 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 is false . |
sticky-session-force | stickySessionForce | 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 is false . |
node-timeout | workerTimeout | -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. |
max-attempts | maxAttempts | 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. |
flush-packets | flushPackets | false | Specifies whether packet flushing is enabled or disabled. |
flush-wait | flushWait | -1 | Specifies the time to wait before flushing packets. A value of -1 means wait forever. |
ping | ping | 10 | Time to wait (in seconds) for a pong answer to a ping. |
smax | smax | -1 | Specifies the soft maximum idle connection count. The maximum value is determined by the httpd thread configuration (ThreadsPerChild or 1 ). |
ttl | ttl | -1 | Specifies the time (in seconds) idle connections persist, above the smax threshold. |
load-balancing-group | loadBalancingGroup | - | Optional parameter, which specifies how load is balanced across jvmRoutes within the same load balancing group. loadBalancingGroup is used in conjunction with partitioned session replication (for example, buddy replication). |