tadm set-health-check-prop common_options --config=config_name --origin-server-pool=origin_server_pool_name (property_name=property_value)+
Use this command to set the health-check properties for an origin server pool.
For information about common_options
, run the help command.
--config|-c
Specify the configuration for which you want to set the health-check properties.
--origin-server-pool|-o
Specify the name of the origin-server pool for which you want to set the health-check properties.
property-name=property-value
Specify name=value
pairs for one or more properties that you want to define. The name=value
pairs should be separated by spaces.
You can set the following health-check properties:
protocol
: Specifies the protocol for the health check requests.
Values: HTTP
.
interval
: Specifies the time interval (seconds) between two health check pings.
Values: Takes a positive integer. Default: 30.
timeout
: Specifies the timeout value (seconds) for a ping connection or a request.
Values: Takes a positive integer. Default: 5.
failover-threshold
: Specifies the number of consecutive failures for all requests sent to an origin server, after which the origin server should be marked as unavailable.
Values: Takes a positive integer. Maximum allowable value is 256. Default: 3.
request-method
: Specifies the method that should be used for HTTP ping requests.
Values: GET
or OPTIONS
. Default: OPTIONS
.
request-uri
: Specifies the URI that should be used for HTTP health-check requests.
Values: URI String. Default: "/".
response-code-match
: The response status codes that indicate a healthy origin server.
Values: A pipe-separated list of status codes. The status codes can be represented as modified regular expressions containing 3-character patterns. The first character can be either "x" or a number from 1 to 4. The second and third characters can be either "x" or a number from 0 to 9. For example, 200, 2xx|304, 1xx|2xx|3xx|4xx. This is applicable only when protocol is HTTP. For example, any 200 plus response code from the origin servers will be matched against 2xx (200=OK, 201=Created, 202=Accepted, 203=Non-Authoritative Information, 204=No Content, 205=Reset Content, and 206=Partial Content).
response-body-match
: A regular expression that is used to match the HTTP response body to determine the origin server's health. This is applicable only when protocol is HTTP.
Values: Regular expression.
response-body-match-size
: Specifies the maximum length of the response body that should match.
Values: Takes a positive integer. Default: 2048.
dynamic-server-discovery
: Specifies if the server should dynamically discover Oracle WebLogic Server cluster nodes and add them to the pool.
Values: true
, false
. Default: false
.
To reset a property to its default value, do not provide a property value.
For example, property-name=<empty_string>
tadm set-health-check-prop --user=admin --host=admin.example.com --password-file=./admin.passwd --port=8989 --no-prompt --config=www.example.org --origin-server-pool=test-pool failover-threshold=150 timeout=4
The following exit values are returned:
0: command executed successfully
>0: error in executing the command
For more information about exit codes and syntax notations, run the help command.