Upgrading from version 4.2.1.x to version 4.2.1.12 in Kubernetes

1. Connect to the Kubernetes cluster and verify running Pods with the following command.

kubectl get pods

2. Navigate to the OpenIAM Kubernetes configuration directory by running ...

cd /root/kubernetes-docker-configuration

3. Check 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 with the following set of commands.

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

5. Verify and update customization files by ensuring that env.sh and terraform.tfvars contain required configurations.
6. Update Terraform version (if required) with the following commands.

wget https://releases.hashicorp.com/terraform/0.12.31/terraform_0.12.31_linux_amd64.zip
unzip terraform_0.12.31_linux_amd64.zip
sudo mv terraform /usr/local/bin/terraform

7. Delete existing Kubernetes jobs by running the following command.

kubectl delete jobs --all

8. Verify OpenIAM Container registry credentials with the following commands.

cd /root/kubernetes-docker-configuration
vi .deploy/openiam.values.yaml

Alternatively, you can also export registry credentials with the following set of commands.

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

9. Change environment, if needed. To do this, in env.sh file, change the line ...

export BUILD_ENVIRONMENT="dev"

... to.

export BUILD_ENVIRONMENT="prod"

10. Run setup and apply terraform configuration commands, as shown below.

./setup.sh
terraform init
terraform apply --auto-approve

11. Verify running pods with the commands in step 1.

kubectl get pods

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.