Migrate Transformations
  • Dark
    Light
  • PDF

Migrate Transformations

  • Dark
    Light
  • PDF

Migration Procedure for Transformations After IAP Upgrade

This guide covers how to migrate a JSON Schema Transformation (JST) after upgrading Itential Automation Platform (IAP) to the most current available version.

Prerequisites

Before upgrading IAP it is imperative that the database be backed up. The backup is best performed using the mongodbdump utility, which creates a binary export of the database contents. The instructions for using the mongodump utility can be found in the mongodump documentation.

Upgrading IAP

The procedure for upgrading IAP can be found on the Itential document repository. Click the link to access the documentation: IAP Upgrade Docs.

Make sure to verify that all the correct dependency packages have been installed. The correct versions are listed in the Version Verification section of the upgrading procedures guide.

Importing Transformations to Upgraded IAP

Importing transformations is actually a two-step process. First you will need to export your JST. Once the export file is saved you can import the JST back into the upgraded version of IAP.

Export and Save the JST

From the IAP home page:

  1. Click Admin Essentials in the left navbar.

    Figure 1: IAP Welcome Screen

13-iap-home-page

  1. Select Authorization in the Quick Start card.

    Figure 2: Admin Essentials Authorization

14-ae-authorization

  1. Set permissions in Authorization Manager for the application to APP-JST.

    Figure 3: Set Permissions

01-auth-mgr-jst

  1. Go to IAP → Automation Studio → Transformations.

    Figure 4: Navigate to Transformations

02-as-transformations

  1. Search for the transformation to be downloaded.

    Figure 5: Locate Transformation

03-locate-jst

  1. Export the JST using the JST Designer. Click the Download arrow.

    Figure 6: Download JST

04-download-jst

  1. Select the Save File radio button to save the downloaded JST (the default location is Downloads) and click OK.

    Figure 7: Save JST

05-save-jst

  1. Verify the location of the saved file.

    Figure 8: Verify JST Location

06-verify-jst-location

Import the Saved JST

To import the saved transformation:

  1. Click Import Automation from the Automation Studio page.

    Figure 9: Import Automation

07-import-automation

  1. Select Transformation from the dropdown menu and click the Import button.

    Figure 10: Select Transformation

08-select-jst

  1. Click the Chose New File icon.

    Figure 11: Select Transformation File

09-select-file

  1. Navigate to the JST to be imported. Click Open to upload the JST file.

    Figure 12: Locate JST

10-locate-jst-import

  1. Click the Import button.

    Figure 13: Import JST

11-import-jst-file

  1. A success message will appear, indicating the JST was imported.

    Figure 14: Import Successful

12-import-success

Note:

If the import and update to existing fails, confirm the JST-ENGINE version from the MongoDB documentation.


Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.