Installing LMDX with Domain Separation

The LogicMonitor Data Exchange (LMDX) application integrates Edwin AI with your ServiceNow instances. This article describes how to install and set up LMDX for domain separated ServiceNow instances.

Requirements

Ensure you have the following before getting started with the configuration:

• A ServiceNow user account with the admin role. This is required to install and configure the LMDX application.
• An Edwin API endpoint and token provided by your Edwin AI administrator.

1. Installing the LMDX Application

Start by requesting the LMDX application from the ServiceNow App Store. Once your request has been approved, you can install LMDX from the app store.

2. Creating a Service Account

A ServiceNow user record needs to be created to allow Edwin AI to access the instance, for example an integration service account. The account must have the x_lomo_dx.api_user role that comes with the application installation. 

This account must be in the Global domain to be able to access all the necessary records. For more information on how to create a user within a specific domain, see the ServiceNow documentation.

Provide the username and password of this service account, as well as the instance name to your Edwin AI administrator to be added to your Edwin AI configuration.

3. Enabling Domain Support

Do the following to enable domain support for LMDX:

1. Navigate to Configuration > LMDX properties, and under Domain Separation select “Yes” (set system property x_lomo_dx.domainEnabled to “true”).
   
2. Under Domain Separation > Endpoints, add all the Edwin AI URLs required. For each URL, create a new record and add the Endpoint URL and API Key provided by your Edwin AI administrator.
   
3. Create an Enabled domain record defining which ServiceNow domain should synchronize using LMDX. This record links the ServiceNow domain to an LMDX endpoint. In the Edwin AI domain field, enter the value provided by your Edwin AI administrator (this will be the Tenant ID in Edwin AI).
   
4. The Config table displays a mandatory Domain field indicating which Enabled domain record is associated with a Config record.
   

4. Completing the Default Configuration

After installing the LMDX app, follow the steps described in the following to complete the activation of the default configuration in ServiceNow.

1. Associate the Config record with an Enabled domain record.
   
2. Move the Business Rule that is associated with the Default configuration (for example LMDXDefaultInc sync) from the Global domain to your instance’s primary domain.
3. Select the Active checkbox.
4. Select one or more fields as Trigger fields, see Configuration Records.
5. For LMDXDefaultInc only:
   1. Navigate to the LMDXDefaultInc import (x_lomo_dx_incident_import) Import Set Table and add a string field labeled “Domain” (the field will be named u_domain).
      
   2. Navigate to the LMDXDefaultInc Import Transform Map and add a new Field Map for the Domain field you just created, mapping it to the target field Domain (sys_domain).
      
6. (Optional) Set a Condition to filter the records that are processed.
7. (Optional) Select one or more Trigger fields as an Important update field, see Configuration Records.
8. Save the Config record.

After completing the LMDXDefaultInc specific steps and saving the Config record, the configuration is activated and LMDX is ready to start processing data between Edwin AI and your ServiceNow instance.

5. Creating Scheduled Jobs for Enabled Domains

LMDX uses a scheduled job to process records in the background without affecting user sessions. For domain separated instances, you must create an individual scheduled job per Enabled Domain in LMDX. 

You can copy the original scheduled job named LMDX – Process outbound payloads, and add the name of the SN domain as a string parameter in the script.