6.3.8 ssocolmng action definition file (ssocolmng.def)

The ssocolmng action definition file contains definitions of ssocolmng daemon process actions. If you have made any changes in this definition file, perform one of the following operations to validate these changes:

Execute the ssocolmng -r command.

Note that the changes might not become valid depending on the key that has been changed.
Restart the ssocolmng daemon process.

Organization of this subsection

(1) Format
(2) Description

(1) Format

The following is an example of an ssocolmng action definition file.

[Figure]

When coding definitions in an ssocolmng action definition file, note the following:

If the definition file includes multiple definitions for the same item, the definition written last is assumed to be valid, and those definitions preceding the last definition are ignored.
When omitting the specification of a key on a line, omit the whole line.

To Page Top

(2) Description

The next table lists the items that must be or can be defined in an ssocolmng action definition file.

Key name	Value
`threshold-event:` <<`on`>>	Specify whether to issue the resource status change event to NNMi. To issue the event, specify `on`. To not issue the event, specify `off`. Even when `on` is specified, the incidents that are filtered with the event filter definition file (`ssoevtfilter.conf`) will not be issued. Note that if `off` is specified, no event is issued even when destinations are specified in the event destination definition file (`ssodest.conf`).
`status-event:` <<`on`>>	Specify whether to issue the collection status change event to NNMi. To issue the event, specify `on`. To not issue the event, specify `off`. Even when `on` is specified, the incidents that are filtered with the event filter definition file (`ssoevtfilter.conf`) will not be issued. Note that if `off` is specified, no event is issued even when destinations are specified in the event destination definition file (`ssodest.conf`).
`nnm-urlaction-coop:`^#1 <<`on`>>	Specify whether to use the NNMi map cooperation function (action cooperation). To use the function, specify `on`. To not use the function, specify `off`.
`nnm-map-coop:`^#1 <<`on`>>	Specify whether to use the NNMi map cooperation function (symbol cooperation). To use the function, specify `on`. To not use the function, specify `off`.
`map-status-warning:`^#1 <<`minor`>>	Specify the NNMi node status that corresponds to the warning-level application status for the NNMi map cooperation function (symbol cooperation). The warning-level application status can correspond to the `warning`, `minor`, `major`, or `critical` NNMi node status. For the correspondence between the application status on SSO and the status registered with NNMi, see 2.6.3(2) Correspondence between the statuses managed in SSO and the severity statuses registered in NNMi.
`map-status-critical:`^#1 <<`major`>>	Specify the NNMi node status that corresponds to the critical-level application status for the NNMi map cooperation function (symbol cooperation). The caution-level application status can correspond to the `major` or `critical` NNMi node status. For the correspondence between the application status on SSO and the status registered with NNMi, see 2.6.3(2) Correspondence between the statuses managed in SSO and the severity statuses registered in NNMi.
`max-client:` <<`32`>> ((1 to 99))	Specify the maximum number of concurrent sessions with the GUI and commands^#2 to connect to the `ssocolmng` daemon process. Note that, when creating a report, as many `ssoextractlog` commands as the number of report conditions start concurrently.
`change-my-address:`^#1 <<`none`>>	When the monitoring manager has multiple IP addresses or when it is operating in a cluster system, specify the operating IP address of SSO in the `n.n.n.n` format. (`n` is an integer from 0 to 255.) In other cases, specify `none`. When the monitoring manager has multiple IP addresses: Specify an IP address at which SSO can communicate with the monitoring server. You can freely select one of the monitoring manager's IP addresses at which SSO can communicate with the monitoring server. When operating SSO in a cluster system: Specify a logical IP address. The operating IP address of SSO defined in the `ssoapmon` action definition file is the IP address of collection database monitoring manager. The IP address is used for the following purposes: Collection database name Display of collection data list in the Resource Data Reference window Display of `ssoextractlog` `-list` command results
`max-logfile-size:` <<`4`>> ((1 to 32 megabytes))	Specify the maximum size of a log file.
`logfile-num:` <<`3`>> ((1 to 10))	Specify the number of the log files.
`trace:` <<`off`>>	Specify whether to output a trace file for troubleshooting at failure occurrence. To output the trace file, specify `on`. To not output the trace file, specify `off`.
`max-tracefile-size:` <<`4`>> ((1 to 32 megabytes))	Specify the maximum size of a trace file.
`tracefile-num:` <<`3`>> ((1 to 10))	Specify the number of the trace files.
`snmp-dump:` <<`off`>>	Specify whether to output an SNMP packet dump for troubleshooting at failure occurrence. To output the SNMP packet dump, specify `on`. To not output the SNMP packet dump, specify `off`.
`max-dumpfile-size:` <<`8`>> ((0 to 99 megabytes))	Specify the maximum size of the SNMP packet dump trace file. When `0` is specified, the trace is acquired without limiting the file size.
`max-incident-logfile-size:` <<`4`>> ((1 to 32 megabytes))	Specify the maximum size of an incident logging file.
`incident-logfile-num:` <<`3`>> ((1 to 10))	Specify the number of the incident logging files.
`fs-redirect:` <<`on`>>	Specify `on` to enable the File System Redirector when executing automated action in a WOW64 environment. Specify `off` to disable the File System Redirector. This key is valid only for the Windows version.
`omit-first-monitor-event:` <<`off`>>	Specify whether to suppress the resource status change event (`SSO_Resource_Monitor_Normal` incident) that is to be issued when the initial resource status is determined to be in the normal region after resource collection (threshold monitoring) starts. Specify `on` to suppress the event. Specify `off` to not suppress the event.
`sso-start-collect-interval:` <<`0`>> ((0 to 60 seconds))	Specify the interval at which to restart resource collection at SSO startup in units of the number of monitored servers specified by `sso-start-collect-unit`. If you specify 1 or larger value for this key, you can distribute the CPU load and communication load on the monitoring manager host at SSO startup. When you intend to distribute the loads, specify a value for this key as a rough standard that meets the following condition: `Value-of-this-key-(in seconds)` `minimum-collection-interval-(in seconds)` `/` `number-of-monitored-servers` x `value-of-the-sso-start-collect-unit-key`
`sso-start-collect-unit:` <<`1`>> ((1 to 32))	Specify the number of monitored servers for which to sequentially restart resource collection at SSO startup at the interval specified by `sso-start-collect-interval`.
`get-specific-instance:`^{#1, #3, #4} <<`none`>> ((1 to 2147483647))	When you collect resources from a specific instance, specify the resource ID to acquire only the MIB object of the specific instance. When specifying multiple resource IDs, delimit them with a comma (`,`). You can specify a range of resource IDs by using a hyphen (`-`). You cannot enter a tab or space in the specified string. Example: `10000,11000-12000` When `none` is specified, the MIB objects of all instances are acquired. When `all` is specified, this definition is valid for all resources. Specify a value within 2,047 bytes from the top of the line.

Key name

Value

threshold-event:

<<on>>

Specify whether to issue the resource status change event to NNMi. To issue the event, specify on. To not issue the event, specify off. Even when on is specified, the incidents that are filtered with the event filter definition file (ssoevtfilter.conf) will not be issued. Note that if off is specified, no event is issued even when destinations are specified in the event destination definition file (ssodest.conf).

status-event:

<<on>>

Specify whether to issue the collection status change event to NNMi. To issue the event, specify on. To not issue the event, specify off. Even when on is specified, the incidents that are filtered with the event filter definition file (ssoevtfilter.conf) will not be issued. Note that if off is specified, no event is issued even when destinations are specified in the event destination definition file (ssodest.conf).

nnm-urlaction-coop:^#1

<<on>>

Specify whether to use the NNMi map cooperation function (action cooperation). To use the function, specify on. To not use the function, specify off.

nnm-map-coop:^#1

<<on>>

Specify whether to use the NNMi map cooperation function (symbol cooperation). To use the function, specify on. To not use the function, specify off.

map-status-warning:^#1

<<minor>>

Specify the NNMi node status that corresponds to the warning-level application status for the NNMi map cooperation function (symbol cooperation). The warning-level application status can correspond to the warning, minor, major, or critical NNMi node status. For the correspondence between the application status on SSO and the status registered with NNMi, see 2.6.3(2) Correspondence between the statuses managed in SSO and the severity statuses registered in NNMi.

map-status-critical:^#1

<<major>>

Specify the NNMi node status that corresponds to the critical-level application status for the NNMi map cooperation function (symbol cooperation). The caution-level application status can correspond to the major or critical NNMi node status. For the correspondence between the application status on SSO and the status registered with NNMi, see 2.6.3(2) Correspondence between the statuses managed in SSO and the severity statuses registered in NNMi.

max-client:

<<32>> ((1 to 99))

Specify the maximum number of concurrent sessions with the GUI and commands^#2 to connect to the ssocolmng daemon process.

Note that, when creating a report, as many ssoextractlog commands as the number of report conditions start concurrently.

change-my-address:^#1

<<none>>

When the monitoring manager has multiple IP addresses or when it is operating in a cluster system, specify the operating IP address of SSO in the n.n.n.n format. (n is an integer from 0 to 255.) In other cases, specify none.

When the monitoring manager has multiple IP addresses:

Specify an IP address at which SSO can communicate with the monitoring server. You can freely select one of the monitoring manager's IP addresses at which SSO can communicate with the monitoring server.
When operating SSO in a cluster system:

Specify a logical IP address.

The operating IP address of SSO defined in the ssoapmon action definition file is the IP address of collection database monitoring manager. The IP address is used for the following purposes:

Collection database name
Display of collection data list in the Resource Data Reference window
Display of ssoextractlog -list command results

max-logfile-size:

<<4>> ((1 to 32 megabytes))

Specify the maximum size of a log file.

logfile-num:

<<3>> ((1 to 10))

Specify the number of the log files.

trace:

<<off>>

Specify whether to output a trace file for troubleshooting at failure occurrence. To output the trace file, specify on. To not output the trace file, specify off.

max-tracefile-size:

<<4>> ((1 to 32 megabytes))

Specify the maximum size of a trace file.

tracefile-num:

<<3>> ((1 to 10))

Specify the number of the trace files.

snmp-dump:

<<off>>

Specify whether to output an SNMP packet dump for troubleshooting at failure occurrence. To output the SNMP packet dump, specify on. To not output the SNMP packet dump, specify off.

max-dumpfile-size:

<<8>> ((0 to 99 megabytes))

Specify the maximum size of the SNMP packet dump trace file.

When 0 is specified, the trace is acquired without limiting the file size.

max-incident-logfile-size:

<<4>> ((1 to 32 megabytes))

Specify the maximum size of an incident logging file.

incident-logfile-num:

<<3>> ((1 to 10))

Specify the number of the incident logging files.

fs-redirect:

<<on>>

Specify on to enable the File System Redirector when executing automated action in a WOW64 environment. Specify off to disable the File System Redirector. This key is valid only for the Windows version.

omit-first-monitor-event:

<<off>>

Specify whether to suppress the resource status change event (SSO_Resource_Monitor_Normal incident) that is to be issued when the initial resource status is determined to be in the normal region after resource collection (threshold monitoring) starts. Specify on to suppress the event. Specify off to not suppress the event.

sso-start-collect-interval:

<<0>> ((0 to 60 seconds))

Specify the interval at which to restart resource collection at SSO startup in units of the number of monitored servers specified by sso-start-collect-unit. If you specify 1 or larger value for this key, you can distribute the CPU load and communication load on the monitoring manager host at SSO startup. When you intend to distribute the loads, specify a value for this key as a rough standard that meets the following condition:

Value-of-this-key-(in seconds) [Figure] minimum-collection-interval-(in seconds) / number-of-monitored-servers x value-of-the-sso-start-collect-unit-key

sso-start-collect-unit:

<<1>> ((1 to 32))

Specify the number of monitored servers for which to sequentially restart resource collection at SSO startup at the interval specified by sso-start-collect-interval.

get-specific-instance:^{#1, #3, #4}

<<none>> ((1 to 2147483647))

When you collect resources from a specific instance, specify the resource ID to acquire only the MIB object of the specific instance.

When specifying multiple resource IDs, delimit them with a comma (,). You can specify a range of resource IDs by using a hyphen (-). You cannot enter a tab or space in the specified string.

Example: 10000,11000-12000

When none is specified, the MIB objects of all instances are acquired. When all is specified, this definition is valid for all resources.

Specify a value within 2,047 bytes from the top of the line.

#1: If you change the value of this item, you must restart the ssocolmng daemon process.

#2: The following lists the GUI windows and commands to connect to the ssocolmng daemon process:

Resource Browser window
Resource Data Reference window
Resource Reference window
Resource Configuration window
Threshold verification window
ssocolchk command
ssocolmng command
ssocolset command
ssocolshow command
ssocolstart command
ssocolstop command
ssodbcheck command
ssodbdel command
ssoextractlog command

#3: When this setting is enabled and a resource that meets all the conditions below is collected, the resource value is undefined if the resource is collected right after the number of instances of the collection target MIB object has changed.

The resource is a user resource.
The MIB object ID of instance is not unique to the entity (instance) because of the specification of the collection target agent (for example, serial numbers of existing instances are always used as MIB object IDs).
The definition of the resource in the user resource definition file includes the definition of a subresource Counter-type MIB object.

When this setting is disabled, collection of the resource that meets the above conditions is skipped right after the number of instances has changed.

#4: You cannot collect only specific instances as resources from the SNMP agent in which SysUpTime (mib-2.1.3) is not installed.

To Page Top