Upgrading OpenIAM in Docker environment

The OpenIAM platform is constantly evolving to provide more functionality and convenience for users. As a result, new versions are regularly released that require upgrades. Depending on the version, the upgrade process may differ. However, several general steps must be completed prior to the upgrade to ensure a smooth and successful OpenIAM upgrade. The prerequisite steps are described below.

Pre-requisites

  1. Ensure that all old images are removed and that at least 30 GB of free disk space is available on the partition where the OpenIAM containers are installed.
  2. Taking a backup prior to upgrading allows you to perform a quick rollback if the upgrade fails or is unsuccessful. Therefore, take a full VM snapshot before starting the upgrade.
  3. If an external database is used, take a full database snapshot before proceeding.

Upgrading

Currently, OpenIAM offers several upgrade options listed below. Before upgrading, ensure that all prerequisites have been completed.

TypeDescription
Upgrade from version 4.2.1.5-4.2.1.8 to 4.2.1.10Describes how to upgrade OpenIAM from versions 4.2.0.5-4.2.1.8 to 4.2.1.10 on Docker.
Upgrade from version 4.2.1.9 to 4.2.1.10Describes how to upgrade OpenIAM from version 4.2.1.9 to 4.2.1.10 on Docker.
Upgrade from version 4.2.1.10 to 4.2.1.11Describes how to upgrade OpenIAM from version 4.2.1.10 to 4.2.1.11 on Docker.
Upgrade from version 4.2.1.x to 4.2.1.12/4.2.1.15Describes how to upgrade OpenIAM from version 4.2.1.x to 4.2.1.12/4.2.1.15 on Docker.
Upgrade from version 4.2.1.x to version 4.2.2Describes how to upgrade OpenIAM from later 4.2.1.x versions to the newer 4.2.2 version.