Itential Automation Platform

On this page:

Upgrading

Upgrading IAP

For customers running IAP 2019.3, a newer method of procedure (MOP) to upgrade on-premise software can be found by clicking the link below for the desired target version.

Existing Version Target Version
From To
2019.x.x 2020.1.x
2020.2.x
2021.1.x

Note: Version 2019.3 will reach end-of-support on December 06, 2021.

How to handle tasks before a major version upgrade

Before any major version upgrade, all jobs should be paused, canceled or completed before starting the upgrade process.

To ensure active paused jobs work on a major upgrade, follow the below steps. Note that primed tasks are not supported with the script, so it is suggested that all jobs are paused and no primed tasks exist prior to the upgrade. Jobs with primed tasks will hang and the primed tasks will never run.

  1. Change the current directory to app-workflow_engine.

    cd /opt/pronghorn/current/node_modules/@itential/app-workflow_engine
  2. Run the migration script.

    node migration_scripts/migrateJobsFrom20193.js
  3. The migration script will migrate all active jobs to work in the new major version.