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.
  1. 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
    …
    
  2. On the node where MySQL is active, follow the steps below:
    1. Disable ACM.
      $ /opt/aspera/acm/bin/acmctl -d
    2. 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
    3. Stop Aspera Orchestrator:
      $ asctl orchestrator:stop
    4. 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
    5. Archive the existing /opt/aspera/var.
      $ cd /opt/aspera/ ; tar cvfz /tmp/aspera_current_timestamp.tar.gz var/
    6. Import the backup database.
      $ /opt/aspera/common/mysql/bin/mysql –u root –p aspera orchestrator < /tmp/orchestrator_db_backup_orig_timestamp.sql
    7. Import the backup archive in /opt/aspera/var.
      $ cd /opt/aspera/
      $ rm –rf var/
      $ tar xvfz /tmp/aspera_orig_<timestamp>.tar.gz
      
    8. Check if there are capsules present in the following folder and if there are any, remove them.
      /opt/aspera/var/config/orchestrator/capsules/
    9. Reinstall the previous release (in this example, Orchestrator 2.3.0).
      $ yum install aspera-orchestrator-2.3.0.build_version.x86_64.rpm
    10. Restart Orchestrator.
      $ asctl orchestrator:restart
    11. Re-enable ACM.
      $ /opt/aspera/acm/bin/acmctl -e
  3. 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).
      $ yum install aspera-orchestrator-2.3.0.build_version-0.x86_64.rpm
    4. Restart Aspera Orchestrator.
      $ asctl orchestrator:start