Upgrading from version 4.2.1.x to version 4.2.1.6

This document will guide the users on how to upgrade to version 4.2.1.6 from older 4.2.1.x versions.

Starting with OpenIAM version 4.2.1.4, upgrading doesn't need any add-ons. upgrade.sh is a part of the RPM installation, so the upgrading process involve simple steps, as shown below.

1. Set the parameter in the env.sh.

export UPGRADE_TO_VERSION=""

2. Run the following command.

openiam-cli upgrade

3. Check all the services are up and running, by running the following command.

openiam-cli status

4. 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.6.

Note: In case having errors in the IDM and business log, stop OpenIAM, login into UI of RabbitMQ and do the following:

• delete queues PropertyValueCacheQueue and BusinessRuleCacheQueue.
• delete exchanges PROPERTY_VALUE_CACHE_EXCAHNGE and BUSINESS_RULE_CACHE_EXCHANGE.

In the event of no access to RabbitMQ UI for any reason, you can do the same from the console using the following commands.

cd /usr/lib/rabbitmq/lib/rabbitmq_server-3.9.21/plugins/rabbitmq_management-3.9.21/priv/www/cli/

 python rabbitmqadmin -u openiam -p passwd00 -V openiam_business_rule delete exchange name=BUSINESS_RULE_CACHE_EXCHANGE
 python rabbitmqadmin -u openiam -p passwd00 -V openiam_common delete exchange name=PROPERTY_VALUE_CACHE_EXCAHNGE
 rabbitmqctl delete_queue --vhost=openiam_common PropertyValueCacheQueue
 rabbitmqctl delete_queue --vhost=openiam_business_rule BusinessRuleCacheQueue

Make sure to use your credentials, since example provides the default ones. If you don't have Python installed, you can use any preferred way to run the rabbitmqadmin.

Afterwards, start OpenIAM. The error might appear due to the change in handlers for these objects. There will be no side effects of the actions above since these are objects used for cache. They will be re-created and re-populated upon the start of OpenIAM.

Note: .NET/PS connector versions to be used with OpenIAM version 4.2.1.6. should be at least 5.20.0.0 or higher. Please note that you must update connector if you use newer versions of the product. It is recommended to use the latest connector version. All .NET/PS connectors versions as at 5.24.0.0 version are backward compatible, hence updating it will not disrupt operation of OpenIAM versions 4.2.0 and higher.