- 05 Dec 2024
-
DarkLight
-
PDF
Migrate Transformations
- Updated on 05 Dec 2024
-
DarkLight
-
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:
- Click Admin Essentials in the left navbar.
- Select Authorization in the Quick Start card.
- Select Roles under the Authorization Manager accordian menu.
- Set permissions for the application to
APP-JST
.
Figure 1: Admin Essentials - Authorization
Figure 2: Authorization - Roles
- Navigate to IAP → Automation Studio → Transformations.
- Search for the transformation to be downloaded.
- Export the JST using JST Designer. Click the Download arrow.
- Select the Save File radio button to save the downloaded JST to your system and click OK.
- Verify the location of the saved file.
Figure 3: Download JST
Figure 4: Save JST
_Figure 5: Verify JST Location_ ![Figure 05](https://cdn.document360.io/608a5b1c-c031-48b8-8c28-fe71e0b4e64a/Images/Documentation/06-Verify-JST-Download.png){height="" width=""}
Import the Saved JST
To import the saved transformation:
- Navigate to **IAP → Automation Studio
2 Click the Import Automation buttonin the top tool bar on the Automation Studio home page. - Select Transformation from the dropdown menu and click the Import button.
- Click the Chose New File icon.
Figure 6: Select Transformation
Figure 7: Select Transformation File
- Navigate to the JST to be imported. Click Open to upload the JST file.
- Click the Import button and success message banner will appear, indicating the JST was imported.
Figure 8: Locate JST
Figure 9: Import JST
If the import and update to existing fails, confirm the JST-ENGINE version from the MongoDB documentation.