6.19.3 User command issuance format: when the server status has changed

(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

To Page Top

(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

To Page Top

(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

To Page Top