9.15 monpath (displays the status of monitoring paths)

Format

monpath [-i] [check-interval]

Users who can execute the command

Superuser

Description

The monpath command checks the status of all monitoring paths and displays the results. You use the monpath command when a failure on a monitoring path has occurred and when the failure has been recovered.

The command displays the following information:

• device name: TCP/IP host name of each monitoring path

• host name: Host names of the remote hosts

• status: Status of communication with each remote host

A monitoring path that is currently in use is indicated by an asterisk (*) following the status of communication with each remote host. If there is an error in a monitoring path, the monitoring path's status is displayed in the status column corresponding to the host name.

The following table lists and describes the items that are displayed.

Table 9‒6: Items that are displayed by the monpath command

Displayed item			Meaning
device name	host name	status
Monitoring path's TCP/IP host name	Host name of a remote host	OK	Normal
		NO RESPONSE	There was no response for one of the following reasons: Slowdown of the host There is no HA Monitor on the remote host. Failure or disconnection of the monitoring path
	**not connect**		Connection has not been established with the HA Monitor on this remote host.
	**open err**		Open error
	**LAN err**		Transmission error

Options

• -i

  Specifies that information about a TCP/IP LAN on the remote host is to be displayed in addition to the information that is displayed when the -i option is omitted.

  The following is the additional information that is displayed:

  • host: TCP/IP host name of the monitoring path on the remote host

    This option displays the TCP/IP host name of the monitoring path on the remote host that is specified in the /etc/hosts file. If no TCP/IP host name has been specified, ---- is displayed.

  • (IP_address): IP address of the monitoring path on the remote host

    This option displays the IP address corresponding to the TCP/IP host name of the monitoring path on the remote host that is specified in the /etc/hosts file.

• check-interval

  Specifies the interval at which monitoring paths are to be checked. The permitted value range is 3 to 30 seconds. If this option is omitted, 3 seconds is assumed.

  If a failure is detected on any monitoring path during a check, the monitoring paths are checked again at the specified interval. The number of re-checks to be performed depends on the pathpatrol_retry operand value specified in the HA Monitor environment settings.

  Normally, a check interval of three seconds is sufficient. If (number of hosts × number of monitoring paths) is large or when multiple servers are engaged in startup processing, you might need to specify a larger check interval.

Return codes

Value	Meaning
0	Normal termination (status of monitoring paths has been displayed)
Other than 0	Abnormal termination

Notes

• The extent of a monitoring path that is subject to this checking is from the TCP/IP LAN adapter on the local host to the TCP/IP LAN adapter on the remote host.

• The monpath command is not accepted if another monpath command is already executing or HA Monitor is performing a health check on the reset path.

• The return code is also set to 0 when any of the following messages is issued while type2 is specified in the exitcode operand in the HA Monitor environment settings:

  KAMN206-E, KAMN320-E, KAMN393-E

Examples

This example executes the monpath command on host 1 (host1) in the hot-standby configuration shown below:

Figure 9‒1: Example of hot-standby configuration in which the monpath command is used

In this example, the -i option is omitted and a failure has occurred on monitoring path path32 on host 3 (host name: host3):

> monpath
KAMN390-I Path status Display
device name  host name  status
path11       host2      OK  *
             host3      OK  *
path12       host2      OK
             host3      NO RESPONSE

Legend: >: Indicates a user operation.

In this example, the -i option is specified and monitoring path path32 on host 3 (host name: host3) has not been specified in the /etc/hosts file:

> monpath -i
KAMN390-I Path status Display
device name  host name  host   (IP_address)  status
path11       host2      path21 (100.2.1.132) OK  *
             host3      path31 (100.2.1.133) OK  *
path12       host2      path22 (100.2.2.132) OK
             host3      ----   (100.2.2.133) OK

Legend >: Indicates a user operation.