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
The following is an example of an ssocolmng action definition file.
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.
(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.
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:
|
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. |