Rolling back from v5.2.6

This section guides you on how to roll back from Adeptia Automate v5.2.6 to Adeptia Automate v5.2.5, v5.2.4, v5.2.3, v5.2.1 or v5.2.

	This rollback guide is applicable only for the aforementioned version and cannot be used for any other version.

Prerequisites

Before you start rolling back from v5.2.6, ensure that you have:

• ​No Process Flows or Templates/Automations in queued or running state.
• Take a backup of the cacerts file present in the /shared/truststore folder.
• Deactivated all the dedicated deployments (if any).
• Scaled down the following microservices deployment:
  • api-publisher-gateway
  • event
  • listener
  • runtime

Steps to roll back from Adeptia Automate v5.2.6

Follow the steps below to roll back from v5.2.6.

1. Locate and open the values.yaml file that was used for the target version.

2. In the databaseMigrationsection of the values.yaml file, do the following:

   1. Set the existing tag for the Database migration job to 5.2.
   2. update the DB_UPDATE_MODE property to rollback.

3. Ensure that the value for the variables are set as mentioned in the table below:

   Variable	Section in values.yaml	Value
   EXECUTE_STATIC_JOB	global > static	true
   EXECUTE_MIGRATION_JOB	global > migration	true
   EXECUTE_CLEANUP_JOB	global > cleanup	false
   DELETE_RABBITMQ_STATEFULSET	global > cleanup	false
   DELETE_RABBITMQ_PVC	global > cleanup	false
   DELETE_RABBITMQ_CLUSTER	global > cleanup	false
   DELETE_RABBITMQ_CONFIG_SECRET	global > cleanup	false

4. If you are switching from HA mode of RabbitMQ to non-HA mode or vice-versa, ensure that the values for the following variables under the global > cleanup section of the values.yaml file are set to true to delete the existing RabbitMQ resources before rollback. 

   	Ensure that there are no messages in running or queued state before proceeding.

   Variable	Description
   EXECUTE_CLEANUP_JOB	Set to true to enable the cleanup job.
   DELETE_RABBITMQ_STATEFULSET	Set to true to remove the existing RabbitMQ StatefulSet.
   DELETE_RABBITMQ_PVC	Set to true to remove the existing RabbitMQ Persistent Volume Claims.
   DELETE_RABBITMQ_Cluster	Set to true to remove the existing RabbitMQ Cluster resources.
   DELETE_RABBITMQ_CONFIG_SECRET	Set to true to remove the existing RabbitMQ configuration secret.

5. Ensure that all the remaining settings in the values.yaml file, except those discussed in this guide, remain as per the previous configuration.

6. Run the following command to rollback:

Code

[Code]  helm upgrade -i <Release Name> <Repo Name>/adeptia-connect --version <Target version, for example, 5.2.0> -f <Path of the values.yaml> -n <Namespace>

Post rollback steps

After rolling back the application, you need to perform the following post-rollback steps:

1. Scale up the microservices deployments that you scaled down before the rollback.
2. Import the certificates that were manually added to cacerts before the upgrade.
3. Restart all microservices.
4. Activate the dedicated deployments that you had deactivated before the rollback.