6.19.3 User command issuance format: when the server status has changed
This subsection explains the format of user commands that are issued by HA Monitor when the server status has changed.
- Organization of this subsection
(1) Format of user commands issued by HA Monitor
When the server status has changed, HA Monitor issues a user command created by the user in the following format:
command-name -n server-alias-name -k server-type server-status-parameter start/end-parameter
(2) Parameters
- Command name
-
Indicates the command name of a user command created by the user and specified in the HA Monitor environment settings.
- -n server-alias-name
-
Indicates the server alias name of the server whose status change results in issuance of the user command.
- -k server-type
-
Indicates the type of server indicated by server-alias-name. One of the following values is passed:
-
online: Active server
-
standby: Standby server
At the start and end of hot standby processing, and during a failure, the server type of the target server is standby.
-
- Server status parameter
-
Indicates the status of the server indicated by server-alias-name. One of the following values is passed:
-
-s: Server active status
-
-e: Server normal termination status
-
-p: Server planned termination status
-
-a: Server failure status (hot standby processing could be performed after error processing terminated)
-
-o: Server failure status (hot standby processing could not be performed after error processing terminated)
-
-f: Server failure status (hot standby processing failed after error processing terminated)
-
-r: Server failure status (HA Monitor is to wait for the active server to be restarted after error processing terminated)
-
-n: Server failure status (the active server restart monitoring interval has elapsed after error processing terminated)
-
-h: Host failure status
-
-w: Planned hot standby status
-
-t: Start retry limit error during hot standby processing
-
- start/end-parameter
-
Indicates whether this is the start or the end point of the status change (HA Monitor processing) on the server indicated by server-alias-name. One of the following values is passed:
-
start: Start point of the server status change (HA Monitor processing)
-
end: End point of the server status change (HA Monitor processing)
-
sbyend: Start point of the status change only on the standby server (HA Monitor processing)
-
For a server in the monitor mode or a resource server, only the following server-status-parameter and start/end-parameter combinations can be passed:
-
Server start status: -s start
-
Server normal termination status: -e start, -e sbyend
-
Server failure status (impossible to perform hot-standby switchover): -o start or -o end
-
Server failure status (standby server failure): -a sbyend
-
Server failure status (hot standby error): -f start
-
Host failure status: -h start
-
Planned hot standby status: -w start
-
Start retry limit error during hot-standby switchover: -t start
(3) Examples of user commands issued by HA Monitor
-
This example issues a user command (/usr/bin/usrcmd) when the active server (server) starts:
/usr/bin/usrcmd -n server -k online -s start
-
This example issues a user command (/usr/bin/usrcmd) in the event of a server failure on the active server (server) (when error processing begins on the active server):
/usr/bin/usrcmd -n server -k online -a start
-
This example issues a user command (/usr/bin/usrcmd) in the event of a server failure on the active server (server) (when error processing ends on the active server):
/usr/bin/usrcmd -n server -k online -a end
-
This example issues a user command (/usr/bin/usrcmd) in the event of a server failure on the active server (server) (when hot standby processing begins on the standby server):
/usr/bin/usrcmd -n server -k standby -a start
-
This example issues a user command (/usr/bin/usrcmd) in the event of a server failure on the active server (server) (when hot standby processing ends on the standby server):
/usr/bin/usrcmd -n server -k standby -a end