A.21 Microsoft System Center Operations Manager (SCOM)

Table A-21 Microsoft System Center Operations Manager (SCOM) 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. The default list is Source, RepeatCount, and State.

These alarm columns are added to the base alarm properties such as Severity, Element, and so on.

Elements Timeout (Seconds)

If there are no open alarms and the element’s condition hasn’t changed in the last n seconds, and if the element has no children, then the element disappears from the display. If another alarm is generated for this element, then it reappears. The default is 300. Set the Elements Timeout property value using one of the following logic:

ElementsTimeout = -1: Never time out.

ElementsTimeout = 0: Time out immediately.

ElementsTimeout > 0: Time out after specified time expires.

If set to 0 or a number greater than 0, the initial population of computers is not performed at adapter start up; therefore, the adapter does not show any elements without alarms.

If Integration Type is set to Event, consider setting Element Timeout to 0 to show only the computers with events.

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/DefaultSCOMEventBasedHierarchy.xml. This property must be left blank when Integration Type is set to Object.

Integration Type

The type of integration. Set to: Object, Event, or Both. Default is Both.

  • Event: Creates the object hierarchy based on the hierarchy file defined in the Hiearchy File field.

  • Object: Creates the object hierarchy based on the hierarchy found in SCOM.

  • Both: Creates the object hierarchy based on the hierarchy file and the SCOM hierarchy.

When setting to Object, be sure no value is specified (left blank) for the Hierarchy File property.

Polling Interval (Seconds)

The number of seconds between queries for new alarms or re-queries for updating existing alarms. The default is 60. Set to 0 (to disable polling), or a number greater than 0. If property is left blank, the default is used.

SCOM Domain

The domain name for the SCOM server.

SCOM Server (DNS name or IP address

The IP address or fully-qualified domain name for the SCOM server.

SCOM Username

The user name for the SCOM administrator account.

SCOM Username Password

The password for the SCOM user account.

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.

Script.onStarted

A script that executes when the adapter starts, either manually or automatically when the Operations Center server starts.

Script.onStopped

A script that executes after manually stopping the adapter.

Severity Remappings

It is necessary to translate the severity levels in SCOM to the severity codes used in Operations Center. Operations Center allows the following severities:

  • OK (usually green)

  • INFORMATIONAL (usually blue)

  • MINOR (usually yellow)

  • MAJOR (usually orange)

  • CRITICAL (usually red)

  • UNKNOWN (usually gray)

The default mappings are:

Success=OK:Information=INFORMATIONAL:Warning=MINOR:Error=CRITICAL:Uninitialized=UNKNOWN

Stylesheet File

The stylesheet file in the /OperationsCenter_install_path/database directory that applies to the HierarchyFile as a style markup to produce 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.