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

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

book

Article ID: 418401

calendar_today

Updated On:

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:
  • 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.