VCF Salt / Aria Automation Config: Upgrade RaaS server to version 8.18.2 via rpm from Broadcom Support Downloads

Products

• VCF Operations/Automation (formerly VMware Aria Suite)
• VMware SaltStack

Issue/Introduction

Version 8.18.2 of VCF Salt RaaS is provided as an rpm package through the Broadcom Support Downloads via the following link:

VCF Salt 8.18.2 - ProductFiles - Broadcom support portal

As such, there are some tasks which must be performed manually to ensure a smooth upgrade.

Environment

• VCF Salt RaaS
• Formerly VMware Aria Automation Config / Tanzu Guardrails for Workloads / SaltStack Enterprise

Resolution

Prerequisites

• Before upgrading, you must take a snapshot the RaaS VM in a clean pre-upgrade state via vSphere
• It is recommended to also take a DB backup in advance of the DB upgrade:
  • pg_dump -U postgres -f "raas_$(date +%s).sql" raas_43cab1f4de604ab185b51d883c5c5d09
  • The above command makes some assumptions about the PSQL setup. If it fails, contact Broadcom Support referencing this article:
    • Creating and managing Broadcom support cases
• It is recommended to upgrade RaaS to version 8.17 prior to running this upgrade to 8.18

 

Upgrade steps

1. Stop masters - on each salt-master, run this command:
   • systemctl stop salt-master
2. Stop RaaS service on this server:
   • systemctl stop raas
3. Backup /etc/raas directory, for example:
   • cp -a /etc/raas /root/raas_pre-upgrade_backup
4. Upgrade the RaaS server software package:
   • rpm -Uvh raas-8.18.2.14.rpm
5. Restore /etc/raas directory from backup, for example:
   • mv /etc/raas /root/raas_post-upgrade_backup
   • cp -a /root/raas_pre-upgrade_backup /etc/raas
6. Generate a new default config file and copy your settings from /etc/raas/raas so as to make use of changes to configs which have come in with this version:
   1. su - raas -c "raas genconfig /tmp/raas-config"
   2. Edit this new config file /tmp/raas-config with reference to your existing config at /etc/raas/raas
   3. mv /etc/raas/raas /etc/raas/raas_8.17-backup
   4. mv /tmp/raas-config /etc/raas/raas
7. Upgrade the RaaS database:
   
   • su - raas -c "raas -l debug upgrade"
8. Start RaaS service:
   • systemctl start raas
9. Start master service on each salt master:
   • systemctl start salt-master

 

Once complete, log into the RaaS GUI and navigate to the Administration > Master Plugins page to download and install the new master plugin on your salt masters.