User guide

configure server-group health-check http
ExtremeWarePx1 1.2 Command Reference Guide 211
configure server-group health-check http
configure server-group name <name string> health-check http
{object <object string> {return <return string>}}
Description
ConÞgures HTTP health checks for the speciÞed server group.
Syntax Description
Default
If no health-check type is conÞgured for a server group, that group uses ping health checks by default.
Usage Guidelines
You must have administrator privileges to issue this command.
The object parameter speciÞes the name of the object to be retrieved by an HTTP GET request. You
may also use the return parameter to specify a string to match in the returned page. When the health
check is performed on a server:
1 A connection is opened to the port conÞgured for the server. The health check fails if the connection
cannot be opened.
2 If the object parameter was speciÞed, that the health check requests the speciÞed object. The health
check fails if no object is returned.
3 If the return parameter was speciÞed, the health check examines the Þrst 1000 bytes of returned text
to see if it contains the speciÞed return string; the health check passes if the return string is found.
If the return parameter was not speciÞed, the HTTP response codes are checked. Acceptable HTTP
response codes are 200-299 and 401.
If you omit the object parameter, when the health check is performed on a server:
1 A connection is opened to the port conÞgured for the server. The health check fails if the connection
cannot be opened.
2 The health check sends an HTTP ÒheadÓ request (HEAD / HTTP/1.0\r\n\r\n) to the server. The
HTTP response codes are checked. Acceptable HTTP response codes are 200-299 and 401.
All data requests use HTTP 1.0.
You must use the build command to commit the conÞguration changes made by this command.
name string Name of the server group for which to configure the health-check type.
object string Name of the object to be retrieved.
return string String to match in the returned page.