Downgrade SSE to a Previous Release
A general guide for downgrading SSE to a previous version.
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:
-
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.
-
Stop the RaaS daemon
-
Depending on the installed version, you may also want to stop Redis, although this is not critical.
-
-
Create a backup of the current RaaS Configuration directory
-
This should contain the entire contents of /etc/raas as there are important hidden files
-
-
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
-
-
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
-
-
Import the database backup that matches the desired target version of RaaS
-
Install the RaaS RPM
-
Configure the RaaS daemon
-
You should be able to restore the directory contents from the backup created in a previous step
-
-
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.
-
-
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
-
-
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.