9.23 monshow (displays the status of servers and hosts)
Format
- Displaying server status:
-
monshow [server-alias-name]
- Displaying host status:
-
monshow -c
- Displaying server group status:
-
monshow -g [group-name]
- Displaying information about shared resources:
-
monshow -d [server-alias-name]
- Displaying resource server status:
-
monshow -r
- Displaying server priority when the multi-standby function is used:
-
monshow -p [server-alias-name]
- Displaying the server failure monitoring time:
-
monshow -t [server-alias-name]
- Displaying monitor-mode program status:
-
monshow -u [server-alias-name]
- Displaying the server monitoring status and disk monitoring status:
-
monshow -o { -s [server-alias-name] | -m }
- Displaying the host setting status:
-
monshow -j
Users who can execute the command
Superuser and general user
Description
- Displaying server status:
-
The monshow command displays the status of the servers running on the host (local host) where this command is executed and the status of servers on paired hosts (remote hosts). The command does not display the status of inactive servers. If the multi-standby function is used, the command displays the status of all servers running on remote hosts. The command displays the following information:
-
Own host name: Host name of the local host
-
Own Server: Information about servers on the local host
For the information about servers on the local host, the command displays the following:
•Alias: Alias name of a server on the local host
•Status: Status of a server on the local host
The following table describes the local host server statuses that are displayed by the command.
Table 9‒14: Server statuses on the local host Status
Meaning
ONL
Startup completed as the active server, or ready for hot-standby switchover
SBY
Startup completed as a standby server, or ready for hot-standby switchover
(ONL)
Starting as the active server
(SBY)
Starting as a standby server
*ONL*
Waiting for restart
*SBY*
Waiting for the active server or resource server to start
ONL??
Waiting for hot standby processing
SBY??
Waiting for grouped-system switchover
ONL>>
Terminating as the active server
SBY>>
Terminating as a standby server
>ONL
Retrying startup
+SBY+
Startup completed as a standby server in the online serverless mode
-
Pair Server: Information about servers on remote hosts
For the information about servers on remote hosts, the command displays the following:
•Status: Status of a server on a remote host
The following table describes the remote host server statuses that are displayed by the command.
Table 9‒15: Server statuses on a remote host Status
Meaning
ONL
Startup completed as the active server, or ready for hot-standby switchover
SBY
Startup completed as a standby server, or ready for hot-standby switchover
(ONL)
Starting as the active server
(SBY)
Starting as a standby server
*ONL*
Waiting for restart
ONL??
Waiting for hot standby processing
SBY??
Waiting for grouped-system switchover
+SBY+
Startup completed as a standby server in the online serverless mode
•Host name: Host name of the remote host
-
KAMN360-I ---------------- Detailed Information ----------------: Detailed information message
Some of the following messages are displayed as detailed command information:
KAMN242-D, KAMN243-D, KAMN244-D, KAMN364-D, KAMN423-E, KAMN931-I, KAMN932-I, KAMN936-I
-
- Displaying host status:
-
The command displays the status of remote hosts that are connected to the local host. The command displays the following information:
-
Host name: Host name
-
Host address: Host address
-
Patrol time: Host failure monitoring time
-
- Displaying server group status:
-
The command displays the status of grouped servers (server groups) that are running on the host (local host) on which the command is executed. The command displays the following information:
-
Own host name: Host name of the local host
-
Group name: Group name of the server group
The command also displays the information listed below for each server in the server group. If the server group contains a resource server, the command also displays information about the resource server.
-
Alias: Server alias name
-
Status: The following information is displayed:
•Whether grouped-system switchover can be performed on the server
possible: Grouped-system switchover can be performed
impossible: Grouped-system switchover cannot be performed
•Switchover type
exchange: Switchover is enabled
no_exchange cancel: Switchover is disabled
When information about an active server is displayed, the switchover type is displayed, but when information about a standby server is displayed, the switchover type is not displayed.
-
- Displaying information about shared resources:
-
The command displays information about the shared resources that are used by the active server on the host (local host) on which the command is executed. The command displays the following information:
-
Own host name: Host name of the local host
-
Server: Server alias name on the local host
-
*** DISK information ***: Information about a shared disk
The command displays the following information about a shared disk:
•Special file names of volume groups
•Whether the function for canceling server startup processing in the event of a connection error on a shared resource is to be used
•Options to be applied when volume groups are placed online
-
*** File system information ***: Information about file systems
The command displays the following information about a file system:
•File system name
•Target directory for mounting
•Mounting options
-
*** SCSI device information ***: Symbolic link or logical device name (when multipath software is HDLM)
-
*** DMMP device information ***: Logical device name (when multipath software is DMMP)
-
- Displaying resource server status:
-
The command displays a resource server's status in addition to the information provided in Displaying server status.
- Displaying server priority when the multi-standby function is used:
-
If the multi-standby function is used, the command displays the priority of a specified server or of all servers for each host, in addition to the information provided in Displaying server status. status is followed by the following information:
-
pri: Host's priority
-
- Displaying the server failure monitoring time:
-
The command displays the server failure monitoring time of the servers that are running on the host where the command is executed.
The command displays the following information:
-
Own host name: Host name of the local host
-
Alias: Server alias name
-
Patrol time: Server failure monitoring time
For a server for which no server failure monitoring time has been specified, hyphens (---) are displayed.
-
- Displaying monitor-mode program status:
-
The command displays the status of a program that uses the monitor-mode program management function and is running on the host (local host) where the command was executed:
-
Alias: Server alias name
-
Program Alias: Alias of the monitor-mode program
-
Status: Status of the monitor-mode program
The following table lists the statuses that are displayed for monitor-mode programs.
Table 9‒16: Statuses of monitor-mode programs Status
Meaning
(ACT)
The program is being started.
ACT
The program has started.
ACT>>
The program is being terminated.
The command does not display status for a terminated program.
-
Patrol time: Program slowdown monitoring interval
--- is displayed for a UAP for which no program slowdown monitoring interval has been specified.
-
- Displaying the server monitoring status and disk monitoring status:
-
The command displays the following monitoring statuses:
-
Monitoring status of the server# and monitoring status of disks for business use
-
Monitoring status of the system disk
- #
-
The status of the monitoring for the patrolcommand operand in the server environment definition is not displayed.
The following items are displayed as the monitoring status of the server and disks for business use:
-
Own host name: Host name of the local host
-
Alias: Server alias name
-
Function: Type of monitoring
The following items are displayed:
• ptrlcmd_ex: Monitoring of the server
• sby_ptrlcmd_ex: Monitoring of the server in the standby system
• disk_ptrl: Monitoring of disks for business use
-
Status: Monitoring status
One of the following strings is displayed:
• patrol: Now monitoring
• patrol paused: Monitoring temporarily stopped
• ----: Monitoring not performed
The following items are displayed as the monitoring status of the system disk:
-
Own host name: Host name of the local host
-
Host name: Host name of the local host
-
Function: Type of monitoring
The following items are displayed:
• disk_ptrl: Monitoring of the system disk
-
Status: Monitoring status
One of the following strings is displayed:
• patrol: Now monitoring
• patrol paused: Monitoring temporarily stopped
• ----: Monitoring not performed
-
- Displaying the host setting status:
-
The following items are displayed as the setting status of the host:
-
Own host name: Host name of the local host
-
Host name: Host name of the local host
-
Function: The following items are displayed:
Online serverless mode: onlless_mode
-
Status: Setting status
Either of the following strings is displayed:
• use: Set
• nouse: Released
-
Options
If no option is specified, the command displays the server status.
- Displaying server status:
-
-
server-alias-name
Specifies the alias name of a server whose status is to be displayed. If this option is omitted, the command displays the status of all servers running on the host where the command is executed.
-
- Displaying host status:
-
-
-c
Specifies that host status is to be displayed.
-
- Displaying server group status:
-
-
-g
Specifies that server group status is to be displayed.
If a group contains a resource server, the command also displays the status of the resource server.
-
group-name
Specifies the group name of the server group whose status is to be displayed. If this option is omitted, the command displays the status of all server groups that are running on the host where the command is executed.
-
- Displaying information about shared resources:
-
-
-d
Specifies that information about shared resources is to be displayed.
-
server-alias-name
Specifies the alias name of a server for which shared resource information is to be displayed. If this option is omitted, the command displays shared resource information for all servers.
-
- Displaying resource server status:
-
-
-r
Specifies that resource server status information is to be displayed, in addition to the information shown in Displaying server status.
-
- Displaying server priority when the multi-standby function is used:
-
-
-p
Specifies that when the multi-standby function is used, the priority of a specified server or of all servers on the host is to be displayed.
-
server-alias-name
Specifies the alias name of a server whose status and priority are to be displayed. If this option is omitted, the command displays the status and priorities of all servers that are running on the host where the command is executed. The order in which information about servers on remote hosts is displayed depends on the order in which hosts and servers were started. This order is not always the same.
-
- Displaying the server failure monitoring time:
-
-
-t
Specifies that the server failure monitoring time of the servers running on the host where the monshow command is executed is to be displayed.
-
server-alias-name
Specifies the alias name of a server whose monitoring interval is to be displayed. If this option is omitted, the command displays the server failure monitoring time for all servers running on the host where the command is executed.
-
- Displaying monitor-mode program status:
-
-
-u
Displays the status of a program that uses the monitor-mode program management function and has been running on the host where the monshow command is executed.
-
server-alias-name
Specifies the alias of the server whose program status is to be displayed. If this operand is omitted, the command displays the statuses of all programs that are running on the host where the command is executed.
-
- Displaying the server monitoring status and disk monitoring status:
-
-
-o -s server-alias-name
The monitoring status of the server and disks for business use are displayed. If a server alias name is specified, the monitoring status of the server and the monitoring status of the disks for business use on that server are displayed. If a server alias name is not specified, the monitoring status of all servers and the monitoring status of the disks for business use on those servers are displayed.
-
-o -m
The monitoring status of the system disk on the host on which the monshow was executed is displayed.
-
- Displaying the host setting status:
-
-
-j
The host setting status is displayed.
-
Return codes
Value |
Meaning |
---|---|
0 |
Normal termination (the status of servers and hosts has been displayed) |
Other than 0 |
Abnormal termination |
Notes
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:
KAMN320-E, KAMN322-E, KAMN428-E
Examples
- Displaying server status:
-
> monshow KAMN213-I Own host name : host1 Own servers Pair servers Alias Status Status Host name server1 ONL SBY host2 server2 SBY (ONL) host2 server3 *SBY* server4 ONL?? server5 *ONL* SBY host2 server6 >ONL KAMN360-I ---------------- Detailed Information ---------------- KAMN243-D There is a fail of system reset or the Server who stops abnormally in the own host:host1. Online server:server3 has the possibility that is starting in other hosts. The initial state was changed to Standby server, and it was made a start wait state. KAMN364-D Server:server4 is Hotstandby wait state, because system reset is failed.
Legend: >: Indicates a user operation.
- Displaying server status (when using the multi-standby function):
-
> monshow KAMN213-I Own host name : host1 Own servers Pair servers Alias Status Status Host name server1 ONL SBY host3 SBY host2 SBY host4 server2 ONL SBY host2 server3 *SBY* server4 SBY (SBY) host4 (ONL) host2 SBY host3 server6 >ONL
Legend: >: Indicates a user operation.
The order in which information about servers on remote hosts is displayed depends on the order in which the hosts and servers were started. This order is not always the same.
- Displaying host status:
-
> monshow -c KAMN335-I Connected host information Host name Host address Patrol time host1 100 10 host2 200 10
Legend: >: Indicates a user operation.
- Displaying server group status:
-
> monshow -g KAMN213-I Own host name : host1 Group name : groupA Alias : server1 Status : possible exchange Alias : server2 Status : possible no_exchange cancel Group name : groupB Alias : server3 Status : impossible exchange Alias : server4 Status : impossible no_exchange cancel
Legend: >: Indicates a user operation.
- Displaying information about shared resources:
-
> monshow -d KAMN213-I Own host name : host1 Server : server1 *** DISK information *** -NAME---------------------------- /dev/vg01 neck on_opt="-a y -q n" *** File system information *** -NAME---------------------------- /dev/vg01/lv_fs1 mount dir=/fs1 mount opt=-o log *** SCSI device information *** -NAME---------------------------- /dev/disk/by-id/scsi-360060e8010462fe004f2b6ae00000000 /dev/disk/by-id/scsi-360060e8010462fe004f2b6ae00000001 /dev/disk/by-id/scsi-360060e8010462fe004f2b6ae00000002 *** DMMP device information *** -NAME---------------------------- /dev/mapper/mpath1 /dev/mapper/mpath2 /dev/mapper/mpath3
Legend: >: Indicates a user operation.
- Displaying resource server status (ressrv0 is the alias name of a resource server):
-
> monshow -r KAMN213-I Own host name : host1 Own servers Pair servers Alias Status Status Host name ressrv0 ONL server1 ONL server2 ONL server6 >ONL
Legend: >: Indicates a user operation.
- Displaying server priority when the multi-standby function is used:
-
> monshow -p KAMN213-I Own host name : host1 Own servers Pair servers Alias Status pri Status pri Host name server1 ONL 0 SBY 2 host3 SBY 1 host2 SBY 3 host4 server2 ONL 0 SBY 1 host2 server3 SBY 1 ONL 0 host3 server4 SBY 1 SBY 3 host4 ONL 0 host2 SBY 2 host3 server6 >ONL 0
Legend: >: Indicates a user operation.
The order in which information about servers on remote hosts is displayed depends on the order in which the hosts and servers were started. This order is not always the same.
- Displaying the server failure monitoring time:
-
> monshow -t KAMN213-I Own host name : host1 Alias Patrol time server1 60 server2 5 server3 600 server4 ---
Legend: >: Indicates a user operation.
- Displaying monitor-mode program status:
-
> monshow -u KAMN213-I Own host name : host1 Alias Program Alias Status Patrol time server1 UAP1 ACT 3600 UAP2 (ACT) 60 server2 UAP3 ACT>> ----
Legend: >: Indicates a user operation.
- Displaying the server monitoring status and disk monitoring status:
-
> monshow -o -s KAMN213-I Own host name : host1 Alias Function Status server1 ptrlcmd_ex patrol sby_ptrlcmd_ex ---- disk_ptrl ---- server2 ptrlcmd_ex patrol paused sby_ptrlcmd_ex ---- disk_ptrl patrol server3 ptrlcmd_ex ---- sby_ptrlcmd_ex ---- disk_ptrl patrol paused > monshow -o -s server1 KAMN213-I Own host name : host1 Alias Function Status server1 ptrlcmd_ex patrol sby_ptrlcmd_ex ---- disk_ptrl ---- > monshow -o -m KAMN213-I Own host name : host1 Host name Function Status host1 disk_ptrl patrol
Legend: >: Indicates a user operation.
- Displaying the host setting status:
-
> monshow -j KAMN213-I Own host name : host1 Host name Function Status host1 onlless_mode use
Legend: >: Indicates a user operation.