ServiceNow Change Management SyncPack Release Notes, version 4.1.0

Version 4.1.0 of the "ServiceNow Change Management" SyncPack adds OAuth2 support to the SyncPack and addresses an issue with the patch_window parameter.

You do not need the ServiceNow Events Module to use this SyncPack. However, you will need to install and run the "ServiceNow CMDB" SyncPack on the same PowerFlow system as this SyncPack.

Features Included in this Release

This release of the SyncPack includes the following features:

  • Added OAuth2 support to the SyncPack. There are four required parameters you can add to a configuration object to facilitate OAuth2 connection to ServiceNow:

    • snow_oauth_client_id: OAuth2 Client ID from ServiceNow
    • snow_oauth_client_secret: OAuth2 Client secret from ServiceNow
    • snow_oauth_token_url: Full authentication URL, including host and protocol from ServiceNow. For example, "https://<test-instance-name>.service-now.com/oauth_token.do"
    • snow_auth_method: You can enter 'oauth' or 'http_basic' as the value. If no value is provided, 'http_basic' will be used for connection.

The configuration options listed above are only required in the configuration object if you plan to use OAuth2 to authenticate. If the values are not present in the configuration object, normal "http_basic" authentication will be used.

To view the latest manuals for the SL1 PowerFlow Platform, see the SL1 PowerFlow page. To view the latest release notes for PowerFlow, see SL1 PowerFlow Release Notes.

Issues Addressed in this Release

The following issue was addressed in this release of the SyncPack:

  • Addressed an issue where the default value of "0" for the patch_window parameter in the "Sync Maintenance Schedules from ServiceNow to SL1" application caused more recent versions of SL1 to interpret this value as a patch window of length zero minutes. With this release, the default value of the patch_window parameter is set to "no_window".

Known Issues

This version of the SyncPack does not have any known issues.

System Requirements

The "ServiceNow Change Management" SyncPack requires:

  • SL1 PowerFlow platform version 2.4.0 or later.
  • SL1 version 11.2.0 or later. For details on upgrading SL1, see the relevant SL1 Platform Release Notes.
  • "Base Steps" SyncPack version 1.5.5 or later.
  • "ServiceNow Base" SyncPack version 3.8.0 or later.
  • "ServiceNow CMDB" SyncPack version: 3.6.0 or later
  • ServiceNow version: Tokyo or later with Web Services enabled. A ServiceNow MID Server is required for certain workflows within this SyncPack.
  • The "ScienceLogic SL1: CMDB & Incident Automation" application version 1.0.81.

You should always use the most recent version of a SyncPack and its certified application.

If your ServiceNow instance is domain-separated, install the latest "ScienceLogic Domain Separation (Global)" update set in ServiceNow. For more information, see the ServiceNow CMDB SyncPackmanual.

The following table lists the port access required by PowerFlow for this SyncPack:

Source Port Purpose

SL1 API

443

SL1 API Access

ServiceNow API

443

ServiceNow API Access

SL1 Database

7706

SL1 Database Access

Prerequisites for the SyncPack

To install this SyncPack, you must have administrator access to both SL1 and ServiceNow. Specifically, you will need:

  • ScienceLogic administrator access to the Administration Portal
  • ServiceNow administrator access

If you want to upload and install multiple ServiceNow SyncPacks at the same time, you should upload all of the SyncPacks first, and then install them to address any dependencies between the SyncPacks.

ScienceLogic highly recommends that you disable all firewall session-limiting policies. Firewalls will drop HTTPS requests, which results in data loss.

ScienceLogic does not support any deployment that attempts to sync one SL1 instance to multiple ServiceNow instances. A deployment of this type will be incredibly fragile and would require the customer to strictly control their environments. This is not something that can be controlled programmatically. Escalations related to this type of deployment are not supported.

Installing the SyncPack

If you are upgrading to this version of the SyncPack from a previous version, make a note of any settings you made on the various applications in this SyncPack, as these settings are not retained when you upgrade.

A SyncPack file has the .whl file extension type. You can download the SyncPack file from the ScienceLogic Support site.

To locate and download the SyncPack:

  1. Go to the ScienceLogic Support site at https://support.sciencelogic.com/s/.
  2. Click the Product Downloads tab and select PowerPacks & SyncPacks.
  3. In the Search field, type the name of this SyncPack and select it from the search results. The Release Version page appears.
  4. On the Files tab, click the down arrow next to the SyncPack version that you want to install, and select Show File Details. The Release File Details page appears.
  5. Click the Download File button to download the SyncPack.

After you download a SyncPack, you can import it to the PowerFlow platform using the PowerFlow user interface.

To import a SyncPack in the PowerFlow user interface:

  1. On the SyncPacks page, click Import SyncPack. The Import SyncPack page appears.
  2. Click Browse and select the .whl file for the SyncPack you want to install. You can also drag and drop a .whl file to the Import SyncPack page.
  3. Click Import. PowerFlow registers and uploads the SyncPack. The SyncPack is added to the SyncPacks page.

You cannot edit the content package in a SyncPack published by ScienceLogic. You must make a copy of a ScienceLogic SyncPack and save your changes to the new SyncPack to prevent overwriting any information in the original SyncPack when upgrading.

To activate and install a SyncPack in the PowerFlow user interface:

  1. On the SyncPacks page, click the Actions button () for the SyncPack you want to install and select Activate & Install. The Activate & Install SyncPack modal appears.

    If you try to activate and install a SyncPack that is already activated and installed, you can choose to "force" installation across all the nodes in the PowerFlow system.

    If you do not see the PowerPack that you want to install, click the Filter icon () on the SyncPacks page and select Toggle Inactive SyncPacks to see a list of the imported PowerPacks.

  1. Click Yes to confirm the activation and installation. When the SyncPack is activated, the SyncPacks page displays a green check mark icon for that SyncPack. If the activation or installation failed, then a red exclamation mark icon appears.
  2. For more information about the activation and installation process, click the check mark icon or the exclamation mark icon in the Activated column for that SyncPack. For a successful installation, the "Activate & Install SyncPack" PowerFlow application appears, and you can view the Step Log for the steps. For a failed installation, the Error Logs window appears.
  3. If you have other versions of the same SyncPack on your PowerFlow system, you can click the Actions button () for that SyncPack and select Change active version to activate a different version other than the version that is currently running.