Configure the SCOM connector instance

The SCOM connector instance requires configuration prior to receiving alerts and Operational Metric raw data from the Microsoft System Center Operations Manager (SCOM).

Before you begin

Role required: evt_mgmt_admin
Before starting this procedure, verify:
  • That the required permissions, for example, local admin, to enable the MID Server to run PowerShell are provided.
  • The MID Server resides in the same domain as the SCOM server.
  • The MID Server uses the same time zone as the SCOM server.
  • The MID Server is running on Windows.
  • The MID Server has .NET framework version 3.5.
  • The MID Server service must run with a user having read-and-write access to the SCOM API.
  • If Operational Metrics is selected, that the MID Server Operational Metric Manager Context is configured. See Configure the Operational Metric extension.
If Bi-directional is selected, ensure that:
  • PowerShell version 3.0 is installed on Windows.
  • As Windows authentication is used by the connector to access the SCOM API, the MID Server service should be running with a user having read-and-write access to the SCOM API. Do this by ensuring that the correct credentials are used:
    1. In the local services, right-click the MID Server service and select Properties.
    2. In the Log On tab, ensure that This account is selected with the details of the user in the Windows domain having access to the SCOM API.
If Collection of metric data is selected, ensure that:
  • PowerShell version 3.0 is installed on Windows.
  • As Windows authentication is used by the connector to access the SCOM database (OperationsManagerDW), the MID Server service should be running with a user having read access to the SCOM database. Do this by ensuring that the correct credentials are used:
    1. In the local services right-click the MID Server service and select Properties.
    2. In the Log On tab, ensure that This account is selected with the details of the user in the Windows domain having read access to the SCOM database.
  • If you upgraded from an earlier release and a SCOM connector was defined:
    1. Configure the Operational Metrics extension and assign it to the MID Server that is used to collect events and Operational Metrics. See Configure the Operational Metric extension.
    2. Define the Log On user on the MID Server service, ensuring that This account is selected with the details of the user in the Windows domain having read access to the SCOM database.

About this task

If you want to receive SCOM alerts, you can obtain the redistributable SCOM files from your SCOM application. Add the files to the MID Server, and then configure a SCOM connector instance to collect the alerts and Operational Metric raw data.

Procedure

  1. On the SCOM server, download the following files to a local computer.
    Version and locationSCOM path and library names
    SCOM 2012R2 or SCOM 2012 or SCOM 2016 %ProgramFiles%\Microsoft System Center 2012 R2 or 2012\Operations Manager\Server\SDK Binaries
    • Microsoft.EnterpriseManagement.Core.dll
    • Microsoft.EnterpriseManagement.OperationsManager.dll
    • Microsoft.EnterpriseManagement.Runtime.dll
    SCOM 2007 %ProgramFiles%\System Center Operations Manager 2007\SDK Binaries
    • Microsoft.EnterpriseManagement.OperationsManager.Common.dll
    • Microsoft.EnterpriseManagement.OperationsManager.dll
    Note: To work with both SCOM 2012 and SCOM 2007 in your instance, before uploading the following files to your instance, append .2012 to the end of the filename Microsoft.EnterpriseManagement.OperationsManager.dll that is found in the 2012 path and append .2007 to the end of the filename Microsoft.EnterpriseManagement.OperationsManager.dll that is found in the 2007 path. This enables the MID Server to load the applicable dll when both SCOM versions are deployed.
  2. Navigate to MID Server > JAR Files.
  3. Click New and add a separate record for the SCOM version for each of the DLL files that you downloaded from the SCOM server.
    1. In the Name field, specify the SCOM version and an identifier to make the name unique, for example 2012 1. If you are using SCOM 2007, specify 2007 as the version. For SCOM 2012, specify 2012 as the version.
    2. Click the paper clip icon in the form header and then attach one of the appropriate DLL files that you downloaded.
    3. Click Submit.
  4. Repeat step 3, creating a separate record for each of the remaining DLL files. Ensure that you have a unique identifier after the SCOM version for each file that you attach, for example 2012 2.
  5. Navigate to Event Management > Connectors > Connector Instances.
  6. Click New and create a connector instance with the following details:
    Field Value
    Name Specify a unique name for the SCOM connector instance.
    Host IP Specify the SCOM IP address.
    Credential In the Credentials form, click New and create the required credentials. Save the credentials using a unique and recognizable name, for example, SCOMOPS.
    Schedule (seconds) The frequency in seconds that the system checks for new events from SCOM Operations.
    Description Type a description for the use of the SCOM event collection instance.
    Connector definition The vendor and protocol used to gather events from the external event source. Select the SCOM connector definition.
    Last error message The last error message is automatically updated.
    Active Select this option only after running a successful test.
    Last run time The last run time value is automatically updated.
    Last run status The last run time status is automatically updated.
    Bi-directional Select to invoke the bi-directional option. This option enables the bi-directional exchange of values to-and-from the external event source. The Last bi-directional status option displays only when this option is selected.
    Note: This feature is not supported on a MID Server that is installed in a directory that has a space in its path.
    Last bi-directional status The value of this field is automatically populated. The status values are:
    • None - A valid connection has not yet been established.
    • Success - A successful connection was established.
    • Error - A connection was established. However the external event source was not updated.
    Metrics collection Select to enable the collection of Operational Metrics.
    Note:
    • The metrics connector supports working with the SCOM database (MSSQL) that is configured to work with SSL.

    • This feature is not supported on a MID Server that is installed in a directory that has a space in its path.
    Metrics collection schedule (seconds) The time, in seconds, to repeat the Operational Metrics collection scheduled job.

    This option displays only when the Metrics collection option is selected.

    Last metrics collection status Status of the Operational Metrics collection activity. The value of this field is automatically populated.

    This option displays only when the Metrics collection option is selected.

    Last error message Last error message received by the connector. If the test connector fails, an error message is displayed in this field.
    MID Servers (MID Server for Connectors section) Specify the MID Server that must run the SCOM connector instance. If not specified, an available MID Server that has a matching IP range is used.
  7. Right-click the form header and select Save.
  8. In the Connector Parameters section, specify the values of the mandatory SCOM parameters.
    1. metric_chunk_size Default value 5000.
    2. scom_date_format Default format M/d/yyyy/ h:mm:ss a
    3. scom_initial_sync_in_days Default value 7.
    4. scom_version It is mandatory to specify the SCOM version, either 2007 or 2012.
      Note: If you are working with SCOM 2016, specify 2012 for the scom_version parameter.
  9. Right-click the form header and select Save.
  10. Click Test connector to verify the connection between the MID Server and the connector.
  11. If the test fails, follow the instructions on the page to correct the problem and then run another test.
    Tip: Use a network tool, such as ping, to verify that the SCOM server is running and the IP address matches the value in the Host IP field.
  12. After a successful test, select the Active check box and then click Update.
    Note:

    The default binding rules that contain SCOM as the external source, that applies to IT alerts and Operational Metric raw data, are the following SCOM Management Packs:

    • All OS Management Packs
    • MS SQL Server
    • IIS
  13. Restart the MID Server service to copy the files.

Example

If bi-directional is configured, the bi-directional exchange of values to-and-from the external event source is enabled.

These scenarios describe the out of the box bi-directional functionality for SCOM connectors:

  • When an alert is resolved in SCOM, it is auto-closed in ServiceNow. However, it is updated irrespective of the bi-directional feature because during each collection cycle, all alert changes are updated.
  • When an alert is manually closed in ServiceNow, it is auto-closed in SCOM. If the alert state is changed to Reopen, SCOM is also updated.
  • When an incident is created and associated to an alert in ServiceNow, SCOM receives the incident number as a ticket ID. However, the state of the incident is not available on SCOM. Therefore when the incident is resolved in ServiceNow, SCOM is not updated as the incident number remains the same. When the alert is associated with a new incident, the new incident number is updated in SCOM.