Prerequisites 

This process is only valid if you have a known good backup from the target version you would like to downgrade to. 

• Valid database backup for the target version

• Working knowledge of using SSH

• Working knowledge of using YUM and RPM to manage packages

• Packages for the manual installation of RaaS

  • At the time of writing SaltStack only has packages available back to SSE 5.5 available for download. 

Process Outline 

The downgrade process may be summarized simply by the following steps:

1. Disconnect the Salt masters from RaaS during the upgrade process either by stopping the Salt masters, or renaming /etc/salt/master.d/raas.conf and restarting the master.

2. Stop the RaaS daemon

   • Depending on the installed version, you may also want to stop Redis, although this is not critical.

3. Create a backup of the current RaaS Configuration directory

   • This should contain the entire contents of /etc/raas as there are important hidden files

4. Uninstall the RaaS rpm

   • Depending on the target version you may also uninstall Redis

   • Depending on your package manager, this step will remove the /etc/raas directory

5. Drop the existing database in Postgresql

   • It may be recommended to take another database backup before downgrading as a precaution although this should not be necessary

6. Import the database backup that matches the desired target version of RaaS

7. Install the RaaS RPM

8. Configure the RaaS daemon

   • You should be able to restore the directory contents from the backup created in a previous step

9. Start the RaaS daemon and verify functionality

   • Login to the UI and verify that you are able to do simple tasks such as add a user, create a job, etc.

10. Now on the Salt masters you need to uninstall the current version of the master plugin.

    • It is recommended to stop the Salt master before doing this

11. Install the version of the master plugin that matches your now running version of RaaS.

    • You will need to regenerate a new eAPIMasterPaths.conf file since the paths for the master plugin will have changed.

    • Use sseapi-config --ext-modules > /etc/salt/master.d/eAPIMasterPaths.conf to generate the new master paths file.

These generic steps provide the basic overview for downgrading. For more information on any of these particular steps, please email enterprisesupport@saltstack.com.