ssomapstatus
- Organization of this page
Format
- To delete the statuses of all the nodes:
ssomapstatus -del -all [-dest IP-address]
- To delete the status of the specified server name:
ssomapstatus -del -s server-name,... [-dest IP-address]
- To match the statuses of all the nodes:
ssomapstatus -sync -all [-dest IP-address]
- To match the statuses applicable to the specified monitoring server:
ssomapstatus -sync -s server-name,... [-dest IP-address]
- To display the statuses of all the nodes:
ssomapstatus -show -all [-dest IP-address]
- To display the status of the specified server name:
ssomapstatus -show -s server-name,... [-dest IP-address]
- To output the command usage:
ssomapstatus -h
Function
The ssomapstatus command is used to manage the status of the map cooperation (symbol cooperation) function. The command can delete, match, and display the status.
Options
-del -all
Deletes the status of resource statuses and application statuses on all the nodes in the NNMi map view.
-del -s server-name
Deletes the status of resource statuses and application statuses on nodes applicable to the monitoring server specified for server-name. Specify a host name or IP address in 255 bytes or less for the server name. If you want to specify multiple server names, delimit them with commas (,).
-sync -all
Match the resource statuses and application statuses of all the monitoring servers with the statuses in the NNMi map view.
-sync -s server-name
Match the resource statuses and application statuses of the monitoring server specified for server-name with the statuses in the NNMi map view. Specify a host name or IP address in 255 bytes or less for the server name. If you want to specify multiple server names, delimit them with commas (,).
-show -all
Outputs the resource statuses and application statuses in SSO and the statuses in the NNMi map. If no status is defined, a hyphen (-) is output. If the monitoring status in SSO matches the status in NNMi, Matched is output to the end of the output line. If the monitoring status in SSO does not match the status in NNMi, Unmatched is output to the end of the output line. If you execute the command while the SSO daemon processes (ssocolmng and ssoapmon) are running, the command is executed for the monitoring server that is monitored by SSO. If you execute the command while the SSO daemon processes (ssocolmng and ssoapmon) are stopped, the command is executed for all the nodes in the NNMi map view.
-show -s server-name
Outputs the resource statuses and application statuses in SSO and the statuses in the NNMi map for the monitoring server specified for server-name. If no status is defined, a hyphen (-) is output. If the monitoring status in SSO matches the status in NNMi, Matched is output to the end of the output line. If the monitoring status in SSO does not match the status in NNMi, Unmatched is output to the end of the output line. Specify a host name or IP address in 255 bytes or less for the server name. If you want to specify multiple server names, delimit them with commas (,).
-dest IP-address
Performs a map cooperation with NNMi on the event-destination host specified for IP-address. Specify the destination IP address in the event destination definition file for the IP address. If you do not specify this option, a map cooperation is performed with NNMi on the monitoring manager in a basic configuration or NNMi on the management manager in a distributed configuration.
-h
Outputs the command usage. This option cannot be specified together with other options.
Return values
0 |
Normal termination |
-1 |
Execution error such as incorrect arguments |
-2 |
One or both of the ssoapmon daemon process and the ssocolmng daemon process is not running. |
-3 |
The ssospmd daemon process is not running. |
-4 |
The nnm-map-coop: key in the ssoapmon action definition file and the ssocolmng action definition file is set to off. |
-5 |
NNMi cooperation cannot be performed. |
Depending on the options, unused return values may exist. Return values are listed by options in the following table.
Return values |
Option |
||
---|---|---|---|
-del |
-sync |
-show |
|
0 |
Y |
Y |
Y |
-1 |
Y |
Y |
Y |
-2 |
-- |
Y |
Y |
-3 |
-- |
Y |
-- |
-4 |
Y |
Y |
Y |
-5 |
Y |
-- |
Y |
Notes
-
If you specify -del -all in SSO in a distributed configuration, node statuses registered by other SSO are also deleted.
-
If you execute the command with -all specified, all the nodes are to be processed, and it might take a long time.
-
You cannot specify -sync while the SSO daemon processes (ssocolmng and ssoapmon) are stopped.
-
If you specify -sync or -show while the SSO daemon processes (ssocolmng and ssoapmon) are running, the processing target is the object which SSO monitors with a threshold at the initial execution of the command.
-
If you specify -show while the SSO daemon processes (ssocolmng and ssoapmon) stop, all the statuses set in the NNMi map view are displayed.
-
This command can operate when the nnm-map-coop: key in the ssoapmon action definition file and the ssocolmng action definition file is set to on.
-
If you specify -show -all, host name resolution is performed so that the output format is created. If host name resolution cannot be performed normally on the host running the monitoring manager, execution of the command takes long time.
-
Do not execute this command together with another command.
Output format
The following is the output format of the -show option:
The following is an example of output of status information by the -show option: