Upgrading from versions 4.2.1.x to version 4.2.1.13 in RPM

The upgrading process to the newest OpenIAM version of 4.2.1.13 is simple and straightforward, following the steps below.

Internet-based upgrade

As a pre-requisite please ensure the following utilities are installed on the server:

• wget;
• unzip;
• tar;
• curl.

1. Update version in configuration by modifying the env.conf file to specify the upgrade versions.

vi /usr/local/openiam/env.conf

Update the following variables:

export UPGRADE_TO_VERSION="4.2.1.13"
export VAULT_VERSION_UPGRADE="1.18.1"

2. Run the upgrade script by executing the upgrade command.

openiam-cli upgrade

Non-internet-based upgrade

As a pre-requisite please ensure the following utilities are installed on the server:

• wget;
• unzip;
• tar;
• curl.

1. Update version in the env.conf file to specify the upgrade versions:

vi /usr/local/openiam/env.conf

Update the following variables:

export UPGRADE_TO_VERSION="4.2.1.13"
export VAULT_VERSION_UPGRADE="1.18.1"

2. Download required files manually and place them in the /usr/src/ directory.

cd /usr/src/

wget -P /usr/src/ https://releases.hashicorp.com/vault/1.18.1/vault_1.18.1_linux_amd64.zip

curl -o openiam-4.2.1.13.noarch.x86_64.rpm https://download.openiam.com/release/enterprise/4.2.1.13/rpm/openiam-4.2.1.13.noarch.x86_64.rpm

wget https://download.openiam.com/release/enterprise/4.2.1.13/binaries/frontend.tar.gz

wget https://download.openiam.com/release/enterprise/4.2.1.13/binaries/backend.tar.gz

3. Run the upgrade script with the upgrade command as follows.

openiam-cli upgrade

vi /bin/openiam-cli

4. Update external database configuration (if applicable). For external databases, verify the database name and update the Flyway command in the upgrade script, as given below.

vi /usr/local/openiam/utils/upgrade.sh

5. The updated script for non-internet-based upgrade is stored in /usr/local/openiam/utils.