Rolling Back an Upgrade

Note: The full procedure below is applicable to an active/active ACM-based cluster. For a single node rollback, skip the ACM-related steps.

Disable ACM.

In the STDOUT below, the orchestrator1 node has MySQL running as active. This is your starting point.

$ /opt/aspera/acm/bin/acmctl –i
Checking current ACM status...
Aspera Cluster Manager for Orchestrator - status
------------------------------------------
Local hostname:         orchestrator1
Active node:            orchestrator1 (me)
Status of this node:    active
Status file:            current
Disabled globally:      no
Disabled on this node:  no
…

On the node where MySQL is active, follow the steps below:

Disable ACM.
```
$ /opt/aspera/acm/bin/acmctl -d
```
Copy the backup packages into a local directory, for example, /tmp/.
The following are examples of backup packages.
```
orchestrator_db_backup_timestamp.sql
aspera_orig_timestamp.tar
```
Stop Aspera Orchestrator:
```
$ asctl orchestrator:stop
```

Use mysqldump to back up the current database.

$ /opt/aspera/common/mysql/bin/mysqldump –h <IP address> –u root –p orchestrator > /tmp/orchestrator_db_backup_current_timestamp.sql

Archive the existing /opt/aspera/var.

$ cd /opt/aspera/ ; tar cvfz /tmp/aspera_current_timestamp.tar.gz var/

Import the backup database.

$ /opt/aspera/common/mysql/bin/mysql –u root –p aspera orchestrator < /tmp/orchestrator_db_backup_orig_timestamp.sql

Import the backup archive in /opt/aspera/var.

$ cd /opt/aspera/
$ rm –rf var/
$ tar xvfz /tmp/aspera_orig_<timestamp>.tar.gz

Check if there are capsules present in the following folder and if there are any, remove them.
```
/opt/aspera/var/config/orchestrator/capsules/
```
Reinstall the previous release (in this example, Orchestrator 2.3.0).
```
$ rpm -ivh aspera-orchestrator-2.3.0.build_version.x86_64.rpm
```
Restart Orchestrator.
```
$ asctl orchestrator:restart
```
Re-enable ACM.
```
$ /opt/aspera/acm/bin/acmctl -e
```

On the node where MySQL is passive,follow the steps below:
1. Disable ACM.
```
$ /opt/aspera/acm/bin/acmctl -d
```
2. Stop Aspera Orchestrator.
```
$ asctl orchestrator:stop
```
3. Reinstall the previous release (in this example, v2.3.0).
```
$ rpm -ivh aspera-orchestrator-2.3.0.build_version-0.x86_64.rpm
```
4. Restart Aspera Orchestrator.
```
$ asctl orchestrator:start
```