Hitachi

JP1 Version 12 JP1/SNMP System Observer Description, Operator's Guide and Reference


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.