ssoapcom
- Organization of this page
Format
- To match the monitoring status between the monitoring manager and the monitoring server:
ssoapcom [-S connection-target-server-name] -g monitoring-server-name
- To execute an on-demand health check for the monitoring server:
ssoapcom [-S connection-target-server-name] -H monitoring-server-name
- To give the ssoapmon daemon process an order to re-read a definition file:
ssoapcom [-S connection-target-server-name] -r
- To delete process and service monitoring conditions held on the monitoring server:
ssoapcom -a monitoring-server-name -s monitoring-manager-name
- To give the ssoapmon daemon process an order to update the NNMi cooperation information (node information):
ssoapcom -n
- To instruct the ssoapmon daemon process to output a function trace dump file:
ssoapcom [-S connection-target-server-name] -F
Function
The ssoapcom command synchronizes the process and service monitoring statuses, executes an on-demand health check, reloads definition files to the ssoapmon daemon process, updates the NNMi cooperation information (node information), or issues an instruction to output a function trace dump file. Also, the command deletes monitoring conditions remaining on the monitoring server.
Options
-S connection-target-server-name
Specifies the connection-target monitoring manager. Specify the connection-target server name by using a host name or an IP address. If this option is not specified, the connection target is SSO on the local host.
-g monitoring-server-name
Matches the monitoring status of processes and services with the specified monitoring server. Specify the monitoring server name by using a host name or an IP address.
-H monitoring-server-name
Executes an on-demand health check for the specified monitoring server. Specify the monitoring server name by using a host name or an IP address.
-r
Instructs the ssoapmon daemon process to re-read the following definition files:
-
ssoapmon action definition file (ssoapmon.def)
-
Event destination definition file (ssodest.conf)
-
SNMP definition file (ssosnmp.conf)
-
Event filter definition file (ssoevtfilter.conf)
-
Action log definition file (ssoauditlog.conf)
-
TCP agent definition file (ssotcpagent.conf)
-a monitoring-server-name
Issues a request to the specified monitoring server to stop monitoring processes and services from the SSO specified for the -s option. Specify the monitoring server name by using a host name or an IP address.
-s monitoring-manager-name
Use this option with the -a option. When you change the IP address of the monitoring manager without stopping monitoring processes and services, this option deletes the monitoring conditions set by the monitoring manager (the IP address before the change) that remain on the monitoring server. Specify the IP address before the change for the monitoring manager name. Although the monitoring process on the monitoring server temporarily stops when this command is executed, the process will automatically resume at the next regular health check.
-n
Instructs the ssoapmon daemon process to update NNMi cooperation information (node information). Use the -n option in either of the following cases:
-
When you re-create a node symbol for the monitoring server after the ssoapmon daemon process has started
-
When you create or re-create a node symbol for the monitoring manager after the ssoapmon daemon process has started (However, when you select the node symbol of the monitoring manager and do not use the map cooperation (action cooperation) function, the option is not necessary.)
-F
Instructs the ssoapmon daemon process to output a function trace dump file. To output a function trace dump file, on must be set for the func-trace: key in the ssoapmon action definition file.
Both this option and the -S option can be specified only if the version of SSO on the connection-destination server is 11-50 or later.
Return values
0 |
Normal termination |
-1 |
Execution error such as incorrect arguments |
-2 |
Not executable (because, if you specified the -H option, a regular health check is being executed for the specified monitoring server, or if you specified the -n option, NNMi cooperation cannot be performed) |
Note
When you execute the ssoapcom -r command after deleting the line containing a key in the ssoapmon action definition file, the deleted key value is not changed to the default value. To allow the default value of the deleted key to take effect, restart the ssoapmon daemon process.