Skip to main content
Matrix42 Self-Service Help Center

Getting started with Infrastructure Forensics - CI Federation

Overview

The new SDDM Import data provider will first import SDDM CIs into a staging database and then create ESM objects from the staging database records. This approach allows higher level of import customization. To configure all import settings correctly, take the following steps:

  1. Set up the SDDM import configuration.
  2. Adjust import definitions to work for the specific Matrix42 ESM installation.
  3. Optionally, you can also handle the import of custom attributes from FireScope.

Prerequisites

Port 38061/tcp is used for HTTPS connection to the FireScope API. Make sure that firewall rule allows outgoing traffic to port 38061 on the FireScope API Server.

Setting up the configuration

To configure the data provider:

  1. In the Administration application go to Integration > Data Providers and open the SDDM Import data provider for editing.
  2. In the Configurations grid, add a new configuration.
  3. On the General page:
  • Make sure the Enable import checkbox is selected.
  • In the FireScope URL field, enter the fully qualified domain name of the FireScope API Service (for example, firescope401apps.m42cloud.com).
  • Provide a name of the FireScope account in Account.
  • Specify FireScope user and password in corresponding fields.
  • In the optional Edge Device field, enter a name of the Edge device from which you want to import the CIs. If left empty, CIs from all Edge devices will be considered.
  • Optionally, you can use the CI Name Filter, Service Group Filter and Logical Group Filter fields to filter which devices will be imported.

All settings are case sensitive!

SDDMProviderConfig.png 

  1. Configure the Settings page:

  • If the Enable Computer Import checkbox is selected, the import will create computers with the "Server" asset type.
  • You can choose the status values that will be assigned to new computers and those computers that have been removed from FireScope.
  • Select the Enable SKU Import checkbox to import stock keeping units. The Model and Manufacturer attributes are filled in for SKUs.
  • If you select the Enable Network Import checkbox, the import will create network devices with the following asset types: ‘Firewall', 'Load Balancer', 'Router', 'Router, Firewall', 'Wireless', 'Switch' and 'Network'.
  • Select Enable Printer Import to import printers as well.
  1. Save the configuration.
  2. Run the Enable and Activate action for the data provider.

Adjusting import definitions

The import definitions for creating objects in Enterprise Service Management use the M42Production database as the source. If the database server is not located on the ESM application server, the connection information has to be updated for each import definition.

Please check this article on guidelines for updating the connection information for MS SQL data sources.

Handling custom information

The data provider imports all custom values from FireScope into the staging database. Enterprise Service Management stores those custom values as a multifragment. A stored procedure has been added to the extension in order to process this data.

If you want to import custom attributes, take the following steps:

  1. Create an import definition.
  2. Chose the configuration item you want to upgrade.
  3. Set the source as the M42 Production database.
  4. Specify the central table as SQL Expression.
  5. Enter “EXEC  [dbo].[CUSTPSO_SddmGetCustValues]” as the expression.
  6. Set your mapping rules according to your liking and use the SDDM_CI_ID as the matching attribute for the target Enterprise Service Management configuration item.

On detailed information about creating an import definition, refer to the Create an Import Definition article. 

Checking the import results

Click the configuration of the SDDM Import data provider to open its preview. The preview displays all jobs and import logs for the selected configuration.

You can also review jobs, workflow instances, and import logs on the Import History tab of the configuration dialog.

You can review imported staging CIs in the Assets application under SDDM Staging Area > Staging CI. The grid will contain computers, printers, and network cards from FireScope.

After the successful execution of the data provider, you can also find XML files with imported data in the Matrix42 root folder under Messages/Data/PSO.SDDM/LastResult.

 

  • Was this article helpful?