Prepare Snow Integration Manager

Install Snow Integration Manager

Install the latest version of Snow Integration Manager. For more information on Snow Integration Manager, see User Guide: Snow Integration Manager.

If you are using a machine where Snow Integration Manager is already installed, upgrade it to the latest version of Snow Integration Manager.

Configure the ServiceNow catalog connector

  1. In Snow Integration Manager, open the Snow Integration Manager Properties and select the Connector Options tab.

  2. In the Available connectors list, select ServiceNow Catalog, select Add and then select Save.

    The Connector configuration dialog box appears.

  3. In the Connector Name dialog box, enter a Name for the connector and then select OK.

    The Properties dialog box of the connector appears.

  4. On the Snow License Manager tab:

    1. Enter the SLM Web API URL, along with the User Name and Password for the API user.

      catalog1.png
    2. Select Test connection to verify that a connection can be established.

    3. Select the Customer from the list.

    4. The Snow License Manager Settings section contains settings that can be used to reduce the risk of the connector collecting data from Snow License Manager at the same time as Snow License Manager is updating its data through the Data Update Job. A collision with the Data Update Job may cause gaps in the data collected by the connector.

      The settings are optional and are disabled by default.

      • To enable the connector to check the status of the Data Update Job, select the Wait for Data Update Job to finish checkbox, and in the Timeout in minutes box, select the maximum length of the wait in minutes. 

        When the setting is enabled, the connector will check the status of the Data Update Job regularly, and will not start the collection of data from Snow License Manager until the Data Update Job is finished. If the Data Update Job is still ongoing when the Timeout in minutes has expired, the connector will abort the collection of data. However, if the connector has already started the collection of data when the Data Update Job starts, the connector will continue with the data collection.

        Note

        To enable this setting, Snow License Manager version 8.3.1 or higher is required.

      • To prefetch data from Snow License Manager, select the Prefetch data from SLM checkbox. 

        When the setting is enabled, Snow Integration Manager will collect all the data from Snow License Manager before exporting it to ServiceNow, instead of collecting and exporting data continuously during the aggregation.

    5. Select OK to save the configuration.

  5. On the ServiceNow tab:

    catalog2.png
    1. Enter the ServiceNow URL along with a User Name and Password.

    2. Select Test connection to verify that a connection can be established.

    3. To adjust the number of files exported to ServiceNow, select a value from the Batch size list. The default value is 100.000 files.

    4. Select OK to save the configuration.

  6. On the Proxy tab:

    1. To activate the proxy functionality, enter proxy settings according to one of the following alternatives:

      • If you want to use the default proxy, select the Use default proxy checkbox.

      • Otherwise, enter the proxy settings manually in the boxes.

      catalog3.png
    2. In the Uses Proxy section, select the checkboxes for the product(s) which will be using the proxy functionality.

    3. Select OK to save the configuration, and close the Properties dialog box of the connector.

Configure the ServiceNow CMDB connector

  1. In Snow Integration Manager, open the Snow Integration Manager Properties and select the Connector Options tab.

  2. In the Available connectors list, select ServiceNow CMDB, select Add and then select Save.

  3. Enter the SLM Web API URL, along with the User Name and Password for the API user on the Snow License Manager tab.

  4. On the ServiceNow tab:

    cmdb1.png
    1. Enter the ServiceNow URL along with a User Name and Password.

    2. Select Test connection to verify that a connection can be established.

    3. To adjust the number of files exported to ServiceNow, select a value from the Batch size list. The default value is 100.000 files.

    4. In the Filter section, select which data objects you want to include in the export.

      By default, all data objects are included in the export, except for Users.

    5. In the Custom Fields section, select which custom fields you want to include in the export.

      Note

      To export custom fields, Snow License Manager version 8.3.1 or later is required.

    6. Select OK to save the configuration, and close the Properties dialog box of the connector.

Configure scheduling

Important

  • When setting up scheduling, it is important that the ServiceNow Catalog connector runs first.

The Snow for ServiceNow Catalog connector inserts the Software Models, and the Software Manufacturers which the CMDB connector uses to match to Software Instance manufacturers. Also, the Snow for ServiceNow Catalog connector inserts the Hardware models, used by the CMDB to map hardware inventory to. It is therefore important that Catalog inserts the complete list of manufacturers and models before the CMDB data is populated.

Both connectors should always be installed and are designed to be used together. However, they should not be scheduled to run in parallel or overlapping.

Best-practice is to enable scheduling on the entire Snow Integration Manager, which will run the connectors sequentially. This will ensure that the Catalog connector runs first, and the CMDB will follow once the Catalog is done.

Note

  • When using best-practice, verify that Catalog is positioned above CMDB in the list of Active connectors on the Connector options tab. Use the arrows to change position.

  • Verify that you schedule the integration to run after you know for sure that the Snow License Manager Data Update Job has finished. Unlike the Snow License Manager web interface, the API does not get blocked during the Data Update Job.

Scheduling.png