Upgrade from 4.2.0.8 to 4.2.0.11

This section describes how customers and partners using OpenIAM on Docker can upgrade from version 4.2.0.7 to 4.2.0.8.

To start the upgrade process, connect to your Linux host where you installed OpenIAM and go to the directory where you installed the OpenIAM Docker compose. By default this should be:/usr/local/openiam/openiam-docker-compose. Go to that directory and check the status using the command shown below.

cd /usr/local/openiam/openiam-docker-compose
git status

During installation of the previous version, at a minimum, the env.sh file was updated. Output from the command above, which is shown below, will indicate the files which were changed.

On branch RELEASE-4.2.0.8
Your branch is up to date with 'origin/RELEASE-4.2.0.8'.
Changes not staged for commit:
(use "git add <file>..." to update what will be committed)
(use "git restore <file>..." to discard changes in working directory)
modified: env.sh

To preserve the customizations create a new branch and add the changes to that branch as shown below. You can name your branches based on your standards or preference.

sudo git checkout -b RELEASE-4.2.0.8-changes
sudo git add .
sudo git commit -a -m "4.2.0.8-changes" // Now you have saved branch with customizations
sudo git checkout -b update_to_RELEASE-4.2.0.11 // New branch to do a merge so you can keep original customized branch safe
sudo git pull origin RELEASE-4.2.0.11
sudo git merge origin/RELEASE-4.2.0.11

At this point, you have updated your docker-compose project to Release-4.2.0.11. Next, run the following commands to update your local containers and then start the applications.

sudo ./shutdown.sh
sudo ./setup.sh
sudo ./startup.sh

Wait for the containers to fully startup and then the application will be ready for use.