Configure a ServiceNow MID Server

If you are running a cloud installation of Moogsoft AIOps you do not need to configure a MID Server.

On-premise installations require ServiceNow's MID server to be set up on your Moogsoft AIOps machine or on a Linux machine that is accessible from Moogsoft AIOps. Installing the MID server achieves a bidirectional integration wherein the MID server receives updates from ServiceNow and forwards them to Moogsoft AIOps using the Graze API.

Note that in order to set up a MID Server you require a ServiceNow account with MID-server role permissions. For more help, see the ServiceNow documentation.

Follow these steps to configure a ServiceNow MID server for Moogsoft AIOps:

  1. Inside ServiceNow, locate the URL for the 64-bit MID server package for Linux.

  2. Download the 64-bit MID server Linux package to your Moogsoft AIOps machine or to a machine accessible from Moogsoft AIOps.

  3. Create the following directory for the MID server:

    mkdir -p /usr/local/servicenow/moog_mid_server
  4. Unzip the MID server package to the MID server directory. For example:

    sudo unzip <mid server package>.zip -d /usr/local/servicenow/moog_mid_server
  5. Install the latest version of Java 8. See the ServiceNow MID server system requirements for more information. The MID server requires Java 8 (update 152 or later) and will not work with Java 9, 10 or 11.

  6. Configure the wrapper.java.command property to point to the Java 8 binary in the following file: /usr/local/servicenow/moog_mid_server/agent/conf/wrapper-override.conf. For example:

    wrapper.java.command=/usr/java/jre1.8.0_171-amd64/bin/java
  7. Modify the configuration of the ServiceNow MID server, located at:

    /usr/local/servicenow/moog_mid_server/agent/conf.xml

    Replace or add the following values:

    <parameter name="url" value="Missing Value"/>
    <parameter name="mid.instance.username" value="Missing Value"/>
    <parameter name="mid.instance.password" value="Missing Value"/>
    <parameter name="name" value="Missing Value"/>
    
  8. Run the following command to allow Moogsoft AIOps processes to start the MID server binaries:

    chown -R moogtoolrunner:moogsoft /usr/local/servicenow/moog_mid_server
  9. Start the ServiceNow MID server. This can be done by running the following command:

    /usr/local/servicenow/moog_mid_server/agent/bin/mid.sh start

  10. Optionally, install the MID server as a daemon and add auto-start scripts to the init.d directory. This can be done by running the following command as root:

    /usr/local/servicenow/moog_mid_server/agent/bin/mid.sh install

After you have set up the ServiceNow integration in Moogsoft AIOps and configured the MID server, to begin using the integration you will need to start the MID server. For more information, refer to the ServiceNow documentation.

Disable a ServiceNow MID Server

The use case for this configuration is when both ServiceNow and Moogsoft AIOps are both SaaS implementations.

  1. In ServiceNow, navigate to Moogsoft AIOps Properties, and deselect the MID server.

  2. Navigate to business rules and Disable the Moogsoft AIOps apply MID server to REST business rule.

  3. Navigate to REST messages and remove the MID server from each REST messages' HTTP requests.