This document describes how to upgrade OpenIAM from the older 4.2.1.x versions to version 4.2.1.9 with Terraform. To perform the upgrade, follow the steps described below.

1. Commit your local customizations by pulling the respective repository at https://bitbucket.org/openiam/kubernetes-docker-configuration.git.

2. Checkout to RELEASE-4.2.1.9.

3. Merge your customizations.

4. Verify that env.sh and terraform.tfvars contain your customizations.

5. Update terraform-0.12.21 to terraform-0.12.31 by running 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

6. Run the following command.

kubectl delete jobs -all

7. Now that you've finished the manual steps, you can redeploy OpenIAM.

./setup.sh

terraform init

terraform apply

OpenIAM should be successfully updated, but not started yet because need to update RabbitMQ queues, see below.

RabbitMQ queue types upgrade

In 4.2.1.9 we've updated the RabbitMQ queue types to be resilient for HA. This means that the following manual steps must be performed after upgrading.

1. Switch to RELEASE-4.2.1.9 branch of the project.
2. Perform the following command.

helm delete $(helm list | grep rabbitmq | awk '{print $1}')

3. If using terraform, perform the following

terraform state rm $(terraform state list  | grep rabbitmq | awk '{print $1}')

4. Run ./setup.sh
5. Finally, run

terraform init && terraform apply

or re-run helm script.