13.2.4 agtpatrol (Monitored Status Display Command)

NAME

agtpatrol - Displays the monitored status of storage devices monitored by Storage Cruiser's agent.

SYNOPSIS

agtpatrol

COMMAND PATH

For Windows environments
```
$INS_DIR\ESC\Agent\bin\agtpatrol
```
($INS_DIR means "Program Directory" specified at the Storage Cruiser's agent installation.)
For Solaris or Linux environments
```
/opt/FJSVssage/bin/agtpatrol
```

DESCRIPTION

This command displays the monitored status of storage devices monitored by Storage Cruiser's agent.

In this command, the following can be confirmed while operating the Storage Cluster Controller.

Whether information on the device specified for the monitoring target is correct or not?
State of communication between monitored devices and Storage Cluster Controller
Monitoring interval of monitored devices

OPERANDS

None

OPTIONS

None

Output Information

The information output by this command is as follows:

Table 13.1 Output Information of agtpatrol Command
Title	Displayed Content
INTERVAL	Monitoring interval (millisecond) of monitored devices is displayed.
TARGET IP	IP address of monitored storage device is displayed. IP address is output in the format described in the definition file (TFOConfig.ini).
TARGET TFO GROUP	Information of a monitored TFO Group is output. For details about output information, refer to "Table 13.2 Output Information of TARGET TFO GROUP ".

The information output in TARGET TFO GROUP is as follows:

Table 13.2 Output Information of TARGET TFO GROUP
Title	Displayed Content
IP ADDRESS	IP address of monitored storage device is displayed. IP address is output in the format described in the definition file (TFOConfig.ini).
GROUP NAME	Name of TFO Group is displayed.
TYPE	Type of TFO Group is displayed. Primary: Primary TFO Group Secondary: Secondary TFO Group
PAIR IP ADDRESS	IP address of the storage device that becomes a pair is displayed. IP address is output in the format described in the definition file (TFOConfig.ini).
PAIR GROUP NAME	The name of TFO Group that becomes a pair is displayed.
STATUS	Monitored status of TFO Group is displayed. Normal: Monitored status is normal. Unknown: Device information cannot be collected due to disconnected communication pathway.
INTERVAL	Monitoring interval (millisecond) set to TFO Group is displayed. Minimum value of this item is a monitoring interval of monitored device.
UPDATE TIME	Date and time is displayed when Storage Cluster Controller communicated to storage device last.

EXAMPLES

Check monitored status.

> agtpatrol
--------------------------------------------------------------------------------
INTERVAL=1000

TARGET IP:
     192.0.2.10
     192.0.2.11
--------------------------------------------------------------------------------
TARGET TFO GROUP:

IP ADDRESS=192.0.2.10
GROUP NAME=TFOG#0
TYPE=Primary
PAIR IP ADDRESS=192.0.2.11
PAIR GROUP NAME=TFOG#0
STATUS=Normal
INTERVAL=1000
UPDATE TIME=Mon Apr 24 13:59:21 CEST 2017

IP ADDRESS=192.0.2.11
GROUP NAME=TFOG#0
TYPE=Secondary
PAIR IP ADDRESS=192.0.2.10
PAIR GROUP NAME=TFOG#0
STATUS=Normal
INTERVAL=1000
UPDATE TIME=Mon Apr 24 13:59:21 CEST 2017
>

NOTES

If no entry of monitored ETERNUS Disk storage systems is output in the command execution result, take the following actions:
- Check whether Storage Cruiser's agent is started.
  If it is stopped, start it.
- Check whether the monitoring function of Storage Cluster Controller is enabled.
  If it is disabled, enable the monitoring function.
- Check whether the IP address of the ETERNUS Disk storage system listed in the TFOConfig.ini file is correct.
  If any error in writing, enter a correct IP address. Restart Storage Cruiser's agent.
- Check that communication can be done with the ETERNUS Disk storage system listed in the TFOConfig.ini file.
  Subsequently, restart Storage Cruiser's agent.
  Refer to "3.1.1 Network Requirements" for network requirements.