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.
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:
|
||
**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:
- 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.