SD-WAN VeloCloud Gateway (VCG) Upgrade

Products

• VMware SD-WAN by VeloCloud

Issue/Introduction

The purpose of this article is to upgrade the VeloCloud Gateway (VCG).

Symptoms:
N/A

Environment

VMware SD-WAN by VeloCloud Gateway

Cause

Upgrade is needed for many causes including fixing known defects or upgrading to the latest LTS version, or upgrade to a supported version

Resolution

The Customer environment could be based on VMware or KVM. You can download the images from below link and  make sure it is the correct one before using it. Attached the link to download 5.2.4 Software Images -ProductFiles - Support Portal - Broadcom support portal

Before upgrade:

• As the underlying Operating System is Ubuntu, and we provide the complete OVA or QCOW package the upgrade will also update/upgrade Ubuntu packages as necessary.
• Ubuntu upgrade will require port 80 and 443 to be open so if there is any access list blocking them then upgrade will fail. 
• Check if you can ping (If allowed) to www.google.com just to make sure you have proper Internet Connectivity and DNS works. 

Upgrade Steps (VMware or KVM):

• The upgrade package would be a tar file, e.g. vcg-update-v2-5.2.4.1-8690489-R5241-20241112-GA-5008849603-signed.tar
• Upload the image to the VeloCloud Gateway system using, for example, SCP command. Then, copy the image to the following location on the system: /var/lib/velocloud/software_update/vcg_update.tar. Make sure to while you copy the tar file the name is vcg_update.tar and nothing else as the script will match/use this file while upgrading. If it does not matches the upgrade will fail.
• Run /opt/vc/bin/vcg_software_update to start the upgrade.

After Upgrade:

• Check the software version by running this on VCG CLI - /opt/vc/sbin/gwd -v. Sample output: vcsupport@vcg34-usca3:~$ /opt/vc/sbin/gwd -v

  VCG Info
  
  ========
  
  Version:    5.2.4
  
  Build rev:  R5241-20241112-GA-
  
  Build Date: 2024-11-12_20-22-58

• Check if the correct DPDK Package is installed using this command - dpdg -l | grep dpdk. For 5.2.4 upgrade, the dpdk version should be 17. Sample output:

• vcsupport@vcg34-usca3:~$ dpkg -l | grep dpdk
  
  ii  gatewayd-dpdk                    17.11-5-bf26924                            all          Velocloud Gateway DKMS modules

• Check if gwd process in running - ps -eaf | grep gwd. Sample output:

•  vcsupport@vcg34-usca3:~$ ps -eaf | grep gwd
  
  root      1711  1459 99 Nov29 ?        18-21:39:35 /opt/vc/sbin/gwd -F/etc/config/gatewayd
  
  root      2132     1  0 Nov29 ?        00:00:15 /usr/lib/quagga/watchquagga -dz -T 5 -R /opt/vc/bin/gwd_watchquagga_script.sh bgpd
  
  vcsuppo+ 14481 12216  0 21:20 pts/0    00:00:00 grep --color=auto gwd

• As per 5.2.4 Release notes, reboot the VCG after upgrade to ensure the new DPDK modules are loaded properly. 
• Check if VCG is showing up on the VCO GUI 
• BGP is up and routes are advertised - /opt/vc/bin/debug.py --bgp_view_summary