A.7 Castle Rock Computing SNMPc

Table A-7 SNMPc Adapter Properties

Property

Specify…

Alarm Columns

A comma-separated list that determines which alarm columns display and the order in which the alarm items display (date/time, rule, etc.) in the Alarms view. For SNMPc, the default is:

Current,CurrentPriority,SRCActual,SRCImplied,MessageText, VarValNth0,VarValNth1… VarValNth9

Alarm Severity Mapping

Maps the SNMPc severity codes to Operations Center severity codes. List the SNMPc severity code first. The default is:

Critical=CRITICAL,Severe=CRITICAL,Major=MAJOR,Minor=MINOR,Warning=MINOR,Info=INFORMATIONAL,Normal=OK

Alarms Discovery

Specify any combination of the following comma delimited values to filter and control discovered alarms:

MaxAlarms=[The max number of alarms to discover] BlockSize=[The number of alarms per discovery chunk] Severity=[SNMPc Severity String Value] 
BackTime=[The number of minutes to subtract from the current time to filter out old events]

MaxAlarms is a numeric value which represents the maximum number of alarms to discover. Specify any number less than 50000. If no value is specified, the overall Max Alarms property value is used.

BlockSize is a numeric value that controls the number of alarms read per discovery block, The default is 1000, The maximum value is 5000.

BackTime is a numeric value that represents the number of minutes to subtract from the current time. Events that are older than the calculated time are not included in the discovered set of alarms. The default is no back time limit.

Severity is any valid SNMPc severity string value. Specify one or more severity settings. Only events with the specified severity are discovered, in the order listed.

The valid severities are: CRITICAL, SEVERE, MAJOR, MINOR, WARNING, NORMAL, INFO. If no setting is specified, events of all severities are discovered. Use the other adapter properties to select a subset of alarms.

For example, to discover no more than 5000 alarms, set the maximum BlockSize to 100, To exclude events older than 24 hours and to discover CRITICAL, SEVERE, MAJOR, MINOR, WARNING, and INFO alarms, use the following property settings:

MaxAlarms=5000,BlockSize=100,BackTime=1440,Severity=CRITICAL,Severity=SEVERE,Severity=MAJOR,Severity=MINOR,Severity=WARNING, Severity=INFO

Discovery Timeout Interval

By default, adapter discovery times out after 30 seconds.Set to a number greater than 30 to increase the timeout interval in seconds. If this property is left empty or set to a number less than 30, the default is used.

Hierarchy File

A file in the /OperationsCenter_install_path/database directory that contains an XML description of the element hierarchy to build below the adapter element. The default is examples/DefaultSnmpcHierarchy.xml.

Max Alarms

The maximum number of alarms that the adapter queries and retains. The default is 500. Set to 0 to allow an unlimited number of alarms.

SNMPc Login Password

The password for the user name supplied in SNMPc Login User ID.

SNMPc Login User ID

The user ID used to log in to the SNMPc server.

SNMPc Server IP Address

The IP address of the server where SNMPc is installed.

Script.onError

A script that executes if the adapter fails for any reason. For example, the script can print the reason for the failure as msg using log.info(msg).

Script.onInitialized

A script that executes when the adapter initializes. All of the Script.* properties are optional.

Script.onStarted

A script that executes when the adapter is starts.

Script.onStopped

A script that executes after manually stopping the adapter.

StylesheetFile

The stylesheet file in the /OperationsCenter_install_path/database directory that applies to the HierarchyFile as a style markup and produces the final output.

Use Alarm Times For Condition Changes

The date/time stamp to use for all alarm data stored by the Operations Center Data Warehouse. If true, the alarm’s date/time stamp is used. If false, the date/time stamp of when the Operations Center server received the alarm is used. The default is true.

Alarm history is stored based on the alarm time rather than alarm receipt time. Also, for SLA metric data based on alarm properties, the property values are recorded based on the alarm time instead of the alarm receipt time. Note that recording historical condition data for historical alarms is not supported.