Skip to main content

Microsoft SCOM

To integrate with Microsoft System Center Operations Manager (SCOM), install the SCOM Connector on the SCOM Server. After you have installed and configured the SCOM Connector, it posts alert data to Moogsoft Enterprise.

These instructions apply to the SCOM Connector for single-server SCOM implementations. If you have set up multiple SCOM servers for high availability, see Configure the SCOM Connector and Configure SCOM for HA.

When you use the integrations UI, you can only configure the visible properties. If you want to implement a more complex SCOM integration with custom settings, see Configure the SCOM LAM.

See the SCOM documentation for details on SCOM components.

Before You Begin

The SCOM integration has been validated with SCOM 2012, SCOM 2016, and SCOM 2019. Before you start to set up your SCOM integration, ensure you have met the following requirements:

  • You have enabled Internet Information Services 6.0 or later to view the Status GUI.

  • You have Administrator privileges to the SCOM server.

  • You have uninstalled any versions of the SCOM Connector you had previously installed.

  • You have opened a port for the SCOM Connector to receive connections from Moogsoft Enterprise. You use this port to configure the Connector URL. The default is 8085.

  • If communications between the SCOM Server and Moogsoft Enterprise the server must pass through a proxy, ensure you know the proxy details including IP address, port, and required user credentials.

Configure the SCOM Integration

Configure the SCOM integration in Moogsoft Enterprise as follows:

  1. Navigate to the Integrations tab.

  2. Click Microsoft SCOM in the Monitoring section.

  3. Follow the instructions to create an integration name.

Install the SCOM Connector

To install the SCOM Connector on your SCOM server, follow the steps below.

Note that if you want to install multiple SCOM connectors, you must point each of them to a different management group.

  1. Click here to download the latest version of the SCOM Connector. Improvements in this version include:

    • INT-6285 : A fix for the SCOM Connector polling the SCOM server even if there is an issue connecting to the LAM

    • INT-6286 : A fix for the SCOM Connector not handling DateTime string conversions properly where system has a non-standard 'Culture'

    • INT-6298 : A fix for the SCOM connector not recovering from SCOM SQL server failures

    • INT-6328 : A fix for the SCOM connector status in the HA service logs

    • MOOG-17674 : A fix for the SCOM Connector not sending clear events for the alerts it creates when encountering a problem itself

    Important

    The previous version of the Connector is available here: Link. This is only needed in case of issues with the latest version.

  2. Unzip the SCOMConnectorInstaller to a directory of your choice.

  3. Right-click on the SCOMConnectorInstaller and select Run as Administrator.

  4. To add your SCOM Server, click the Add SCOM Server. The SCOM Server Connection dialog opens.

  5. Enter the following details in the dialog box and click the Add Connection button:

    Field

    Value

    Domain

    Domain name of the SCOM Server.

    SCOM Server Host Name

    Host name of the SCOM Server where you are installing the Connector.

    User ID

    User name of the SCOM Server. For example, "Administrator" or "Domain/user".

    Password

    Password for the SCOM Server user.

  6. Click the Add Moog Server button to add your server. The Moog Server Connection dialog box opens.

  7. Enter the following details in the dialog box and then click the Add Connection button.

    Field

    Value

    Moog URL

    Your SCOM integration URL. For example:

    https://example.Moogsoft.com/integrations/api/v1/events/microsoftscom1

    Either configure this field or Moog IP and Moog Port.

    Moog IP

    If not using Moog URL, the IP address of the server.

    Moog Port

    If not using Moog URL, the port of the SCOM Integration (SCOM LAM) on the server.

    Enable SSL

    Encrypt communications with the server.

    Public Key

    Public Key for the server.

    Proxy Authentication Required

    Enable when communications must pass through a proxy server that requires authentication.

    Username

    Proxy username in the format <domain name>\<user name>. For instance, "mdomain\user1".

    Password

    Password for the proxy user.

    Proxy IP

    IP address of the proxy server.

    Proxy Port

    Port of the proxy server.

  8. Enter the Connector URL in the Connector URL field in the following format: http://<IP Address>:<port> . For example, "http://192.0.2.0:8085". Moogsoft Enterprise uses this URL to communicate back to the SCOM server.

    Use the IP address of the machine where you're installing the connector and the open port you selected for communications with Moogsoft Enterprise.

  9. Enter an appropriate Connector Service Name, i.e. "Moogsoft-Connector".

  10. To prevent alert storms, enter the Alert Storm Threshold on the Config tab, by default 10000.

    The SCOM connector notifies Moogsoft Enterprise if the number of alerts breaches the threshold.

  11. Select the Auto Start Service on Installation checkbox on the Config tab to start the SCOM Connector automatically after installation.

  12. Click Install. The installer package installs the SCOM Connector and saves your configuration choices within the installer folder.

The connector runs as a service named "SCOM Connector". You can use the Services to control the SCOM Connector as you would any other service. If you restart the connector, ensure it stops completely before starting again. This can take 3-4 minutes.

You can view the logs for the SCOM Connector at <Install-Folder>\Logs\SCOMConnector.log.

See Configure the SCOM Connector for more information.

Check SCOM Status

You can use a GET request to check the status of the SCOM integration on Moogsoft Enterprise. See "Check the LAM status" in Configure the REST LAM for more information and examples.

In this section: