ping-response-code-rules
Use the ping-response-code-rules configuration entry to define the rules used to determine whether the HTTP status code of the ping responses indicate a healthy or an unhealthy junctioned Web server.
ping-response-code-rules = list
Description
The WebSEAL server performs a periodic background ping of each junctioned Web server, to determine whether the junctioned Web server is running. The optional ping-response-code-rules configuration entry defines the rules used to determine whether the HTTP status code of the ping responses indicate a healthy or an unhealthy junctioned Web server.
If valid values are configured for both ping-response-code-rules and response-code-rules, the specified ping-response-code-rules will be applied to the ping requests initiated by WebSEAL, and other requests will be matched against response-code-rules to determine the server state.
If a valid ping-response-code-rules value is configured but response-code-rules is not, the specified ping-response-code-rules will be applied to the ping requests initiated by WebSEAL, and other requests will not be used to determine the server state. In this case, ping-response-code-rules are the only rules used to determine the server state.
If the ping-response-code-rules configuration entry is not set, the rules that are specified by the response-code-rules configuration entry will also apply to ping requests.
If the ping-attempt-threshold entry is configured, when the junction is marked as running, it must fail this number of consecutive ping requests before it is marked as not running. If this entry is not set it is default to 1.
If the recovery-ping-attempt-threshold entry is configured, when the junction is marked as not running, it must return this number of consecutive successful recovery ping responses before it is marked as running. If this entry is not set it is default to 1.
The configuration entry contains a space separated list of rules. Each rule has the format: [+|-]<code> (e.g. -50?)
where:
+ That this is a healthy response code. - That this is an unhealthy response code. <code> The corresponding response code, which can also contain pattern matching characters such as * and ?
The HTTP response codes are evaluated against each rule in sequence until a match is found. The corresponding code (+|-) determines whether the junctioned Web server is healthy or not.If the response code matches no configured rules, the junctioned Web server is considered healthy.
We can customize this configuration item for a particular junction by adding the adjusted configuration item to a [junction:{junction_name}] stanza, where {junction_name} refers to the junction point for a standard junction (including the leading / character) or the virtual host label for a virtual host junction.
Options
list A space separated list of response code rules. These rules determine whether the ping response from a junctioned Web server indicates a healthy or an unhealthy server.
Usage: Optional
Default value None.
Example:
ping-response-code-rules = +2?? -*
Parent topic: [junction] stanza