Wipe out RAAS 8.17.0 and reinstall RAAS at a lower version

Products

• VMware Aria Suite

Issue/Introduction

Due to https://knowledge.broadcom.com/external/article/375483/aria-automation-config-404-in-ui-when-up.html need to downgrade RaaS to a lower version to test the upgrade to 8.16.2. 

In this scenario, there is a need to go back to 812.2 to test the upgrade in a lower environment before upgrading production. There is not a backup from before the upgrade to 8.17, and there is no need to retain any data from the current database, as it is a test environment. 

IMPORTANT: If there is a backup from before upgrading to 8.17, the recommendation is to revert to the backup.  

 

Environment

Aria Automation Config 8.17.0 
Aria Automation Config 8.16.2 and lower

Cause

There is a requirement to roll back due to https://knowledge.broadcom.com/external/article/375483/aria-automation-config-404-in-ui-when-up.html but your test environment does not have a backup from before the upgrade to 8.17

Resolution

These steps will delete the current RaaS database, and it cannot be recovered without a valid back up. 

IMPORTANT: This process is only valid for non-production environments, and if there is NOT a need to retain data. If there is a backup from before upgrading to 8.17, the recommendation is to revert to the backup.

Before making any changes, take a backup of the existing database and configurations as per the "Back up Automation Config files and directories" and "Back up your database schema" sections in the documentation: https://docs.vmware.com/en/VMware-Aria-Automation/8.16/Installing-Automation-Config/GUID-1637E178-B1A7-4FAC-A348-1516A6F0C4F0.html 

NOTE: Even if there is no requirement to retain data, it is still recommended to back up the database.

It is also recommended that you take snapshots of the Aria Automation Config components before running these steps.

1. Stop the raas service
   systemctl stop raas
   
   
2. Then access postgres and drop the db:
   su - postgres

3. Find the name of your RaaS database:
   psql --list | grep -i raas

4. This returns something like this:
   raas_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx | salt_eapi | UTF8 | en_US.utf8 | en_US.utf8 |

5. Connect to Postgres:
   psql
   
   
6. Drop the Database using the database name from the previous step:
   drop database raas_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx;
   
   
7. Quit Postgres:
   \q
   
   
8. Logout:
   Ctrl+D
   
   
9. Then you can uninstall RaaS using the steps in the "Upgrade the RaaS node" section of this page: https://docs.vmware.com/en/VMware-Aria-Automation/8.16/Installing-Automation-Config/GUID-1637E178-B1A7-4FAC-A348-1516A6F0C4F0.html
   
   
10. Un-install the Master plugin using the removal and cleanup steps from the "Upgrade the Master Plugin Using the CLI" section of https://docs.vmware.com/en/VMware-Aria-Automation/8.16/Installing-Automation-Config/GUID-1637E178-B1A7-4FAC-A348-1516A6F0C4F0.html
11. After that, re-install the desired RaaS version.
    https://docs.vmware.com/en/VMware-Aria-Automation/8.16/Installing-Automation-Config/GUID-DBE6D84B-0D4B-4747-8291-B0D80851CE62.html
    
    
12. Then re-install the Master plugin via the UI as per the "Upgrade the Master Plugin Using the Automation Config User Interface" section here: https://docs.vmware.com/en/VMware-Aria-Automation/8.16/Installing-Automation-Config/GUID-1637E178-B1A7-4FAC-A348-1516A6F0C4F0.html