Upgrade from version 4.2.1.x to version 4.2.1.12/4.2.1.13 in Docker

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

1. Connect to the Linux Host and verify if containers are running by running the following command.

docker ps

2. Navigate to the OpenIAM Docker Compose directory with the following command.

cd /root/openiam-docker-compose

3. Check the Git Status and create a backup branch by running the following commands.

git status
sudo git checkout -b RELEASE-4.2.1.10-changes
sudo git add .
sudo git commit -a -m "4.2.1.10-changes"

4. Create a new branch for the upgrade and merge changes by running ...

sudo git checkout -b update_to_RELEASE-4.2.1.12
sudo git pull origin RELEASE-4.2.1.12
sudo git merge origin/RELEASE-4.2.1.12

The commands above can be used for 4.2.1.13 version of OpenIAM as well, depending on what version you are to upgrade to.

5. Stop and remove all running containers with the following command.

sudo ./shutdown.sh
docker ps  # Ensure all containers are deleted

6. Export container registry credentials with the following.

export DOCKER_REGISTRY=confidant-bhaskara.container-registry.com
export DOCKERHUB_USERNAME=test.upgrade
export DOCKERHUB_PASSWORD=XXXXXXXXXXXXXXXXX

7. Run setup and start OpenIAM commands below.

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

8. Verify the running containers, repeating the command in step 1.

docker ps

Once all the services are up and running, login to OpenIAM and navigate to Administration > About OpenIAM.

The build version must be updated to 4.2.1.12/4.2.1.13.