Upgrading OpenIAM from versions 4.2.1.x to 2026.5.2 in RPM

The upgrading process to the newest OpenIAM version of 2026.5.2 is straightforward. The steps below detail the prerequisite steps for upgrading to OpenIAM 2026.5.2 for both single-node and HA-based RPM clusters.

Pre-upgrade prerequisites

  1. Make sure to backup the VM.
    • Take a full snapshot of all three Linux VMs.
    • Take a full snapshot/backup of the OpenIAM and Activiti databases from the external database instance.
  2. Observe the Firewall / Network requirements, as given in the table below.
HostPortDescription
OpenIAM cluster nodes8500/TCP, 8503/TCP, 8301/TCP, 8301/UDP, 8301/TCP, 8302/UDP, 8300/TCP, 8600/TCP, 8600/UDPThe following ports must be open between Consul agents (server/client) and other services.
8081(http)IDP port
8082(http)WEBCONSOLE_PORT
8083(http)SELFSERVICE_PORT
8084(http)SELFSERVICE_EXT_PORT
8085(http)REPORTVIEWER_PORT
8086(http)UI_STATIC_PORT
8087(http)Harproxy.
Note: For all communication ports required for the HA-based cluster upgrade, please refer to the link link.
  1. Access requirements
    • Admin-privileged credentials are required for all three Linux servers participating in the HA setup.
    • Admin-privileged credentials are also required for the external database instance.
  2. Database preparation
    • Create the Groovy initialization script on the database instance.
    • This script will be shared by OpenIAM as per database type prior to the upgrade.
Note: Depending on the type of database, the SQL script will be provided from OpenIAM side in the upgrade ticket.
  1. Disk space requirement
    • Approximately 50 GB of free disk space should be available.
    • This must be verified based on the current utilization of the /root partition.
  2. Please open a support case with OpenIAM before proceeding with the upgrade.
  3. Software Prerequisite: Please note that the upgrade is supported only on Enterprise Linux 8 (EL8) and Enterprise Linux 9 (EL9) platforms.
  4. Audit Log Recommendation: For environments where the audit log size is greater than 3 GB, it is recommended to export the audit log data prior to the upgrade. The upgrade script includes detailed procedures for both online and offline audit log export.

Upgrading scenarios

Internet-based upgrade

To upgrade OpenIAM from 4.2.1.x to 2026.5.2 with internet access, use the following command.

curl https://download.openiam.com/release/enterprise/infra/upgrade.sh --output /usr/src/upgrade.sh
For HA based cluster upgrade:-
curl https://download.openiam.com/release/enterprise/infra/ha_upgrade.sh --output ha_upgrade.sh

Non-internet-based upgrade

To upgrade OpenIAM from 4.2.1.x to 2026.5.2 without internet access follow the steps below.

  1. Download below files and keep it in /usr/src in Linux server and prepare the upgrade script as follows.
curl https://download.openiam.com/release/enterprise/infra/upgrade.sh --output /usr/src/upgrade.sh
chmod +x /usr/src/upgrade.sh
cp /usr/src/upgrade.sh /usr/local/openiam/utils/


For HA based cluster upgrade:-
curl https://download.openiam.com/release/enterprise/infra/ha_upgrade.sh --output ha_upgrade.sh
chmod +x ha_upgrade.sh
Copy the ha_upgrade.sh script to the openiam-cluster-rpm folder
Configure the "CONFIGURATION" section of this file
Run the script: ha_upgrade.sh
  1. Download required artifacts with the following commands.
curl https://download.openiam.com/release/enterprise/infra/elasticdump-offlines.tar.gz --output /usr/src/elasticdump-offlines.tar.gz

For EL9.

curl https://download.openiam.com/release/enterprise/2026.5.2/rpm/openiam-2026.5.2.noarch.x86_64.rpm --output /usr/src/openiam-2026.5.2.noarch.x86_64.rpm
curl https://download.openiam.com/release/enterprise/2026.5.2/dependencies/el9/openiamrepo.tar.gz --output /usr/src/openiamrepo.tar.gz
curl https://download.openiam.com/release/enterprise/2026.5.2/binaries/frontend.tar.gz --output /usr/src/frontend.tar.gz
curl https://download.openiam.com/release/enterprise/2026.5.2/binaries/backend.tar.gz --output /usr/src/backend.tar.gz

For EL8

curl https://download.openiam.com/release/enterprise/2026.5.2/rpm/openiam-2026.5.2.noarch.x86_64.rpm --output /usr/src/openiam-2026.5.2.noarch.x86_64.rpm
curl https://download.openiam.com/release/enterprise/2026.5.2/dependencies/el8/openiamrepo.tar.gz --output /usr/src/openiamrepo.tar.gz
curl https://download.openiam.com/release/enterprise/2026.5.2/binaries/frontend.tar.gz --output /usr/src/frontend.tar.gz
curl https://download.openiam.com/release/enterprise/2026.5.2/binaries/backend.tar.gz --output /usr/src/backend.tar.gz

Once all prerequisites are completed, start the upgrade using the command below:

openiam-cli upgrade
Previous
Infrastructure upgrade in v4.2.1.13
Next
Upgrading notes for v.2026.5.2 in RPM