In this 2 part series I will provide an example walk-thru upgrade of:
VCF 3.9.0 (VxRail 4.7.300) -> 3.9.1 upgrade (VxRail 4.7.410)
One of the great advantages of a VCF On VxRail solution is the ability to LCM your entire SDDC stack in an automated fashion driven through a single user interface (SDDC Manager). The following post details how you step through this LCM process.
By expanding the Current Versions tab within SDDC manager it is possible to view the full list of components deployed as part of VCF and their respective current running code versions. The following is a very useful VMware kb article detailing the BOM for each VCF release:
It is also advisable to read the release notes of the target version prior to performing the upgrade:
In relation to this particular example upgrade of VCF 3.9.0 -> 3.9.1 we can correlate from the above kb & release notes that the components being upgraded are as detailed below. This upgrade consists of a 6x BUNDLE upgrade process executed in the following sequence:
- VMware Cloud Foundation Upgrade contains UI server patch upgrade from VCF 126.96.36.199 to 188.8.131.52 (184.108.40.206-15219681 29MB)
- VMware Cloud Foundation Upgrade 220.127.116.11 to 18.104.22.168 contains features, critical bugs and security fixes along with change to Python 3.7.5 (22.214.171.124-15345960 10GB)
- VMware Cloud Foundation Upgrade contains configuration changes which will be applied to components of VMware Cloud Foundation 126.96.36.199 (188.8.131.52-15345960 157 MB)
- VMware Software Upgrades NSX-V from 6.4.5 to 6.4.6 (6.4.6-14819921 2GB)
- VMware Software Upgrades PSC/VC from 6.7 U3 to 6.7 P01 (6.7.0-15132721 2GB)
- VXRAIL UPGRADE BUNDLE VERSION 4.7.410-26262335 4 GB
The sequence of the upgrade is defined within SDDC Manager itself. SDDC Manager presents the next available upgrade bundle throughout the procedure which makes the overall procedure quite easy and seamless to the end user performing the upgrade. In an effort to incrementally speed up the process of upgrading it is advisable to download all the required bundles in advance (bundles marked as available/future apply), as some of the bundles can be quite large in size for example the 3.9.1 bundle is 10GB. After each of the bundles have been downloaded click View Details, which details the version changes that will be applied as part of the bundle upgrade. The update bundles can be applied manually or scheduled for a preferred time window. Note the first 3 bundles apply only to the management WLD.
Ensure to run the upgrade Precheck task from within SDDC Manager in order to validate VCF is in a healthy state before proceeding with each of the upgrades and view the health status of each component by expanding their respective results. If the precheck has failed, fix the issue and then retry the precheck task to repeat the validation process.
Before proceeding with the upgrade ensure to take snapshots of your management virtual machines. Do not perform any SDDC workflows such as VI WLD creation or WLD expansions during the upgrade and confirm no failed workflows or errors are displayed in SDDC manager.
While proceeding with the updates, click on View update activity to monitor progress and track progress via the lcm log:
tail -f /var/log/vmware/vcf/lcm/lcm.log
It is also possible to confirm a successful update via the SDDC manager ssh console:
cat /var/log/vmware/vcf/lcm/lcm.log | grep “reached final state COMPLETED_WITH_SUCCESS”
All of the above steps/guidelines are displayed as part of the walk-thru series detailed for each of the 6 upgrades below.
Stepping through each of the 6 upgrade bundles:
1. VMware Cloud Foundation Upgrade contains UI server patch upgrade
In order to check the availability of Update/Patches from within the SDDC manager console navigate to Inventory->WLD->Update/Patches. In this example we see that VCF 184.108.40.206 update is the first available bundle to be applied:
2. VMware Cloud Foundation Upgrade 220.127.116.11 to 18.104.22.168
3. VMware Cloud Foundation 22.214.171.124 Configuration Drift
4. VMware Software Upgrades: NSX-V 6.4.5 -> 6.4.6
5. VMware Software Upgrades: PSC/VC 6.7 U3 -> 6.7 P01
6. VxRail SDDC Bundle Upgrade: 4.7.410
It is highly recommended that you run the VxVerify tool before proceeding with a VxRail upgrade; more details on how to download and run VxVerify can be found here:
Note: Upgrading VMware Cloud Foundation on VxRail from 3.9.0 to 3.9.1 fails on VxRail Manager. (VMware KB77007) This is a known issue and expected behavior as part of the upgrade, the steps in the slides below detail how to handle the failure. The upgrade of VxRail actually continues which you can monitor through the VxRail VC plugin and once complete simply return to SDDC Manager and click on RETRY which then proceeds to validate all versions on the VxRail end and update SDDC Manager with the updated VxRail version.
This completes the VCF 3.9.0 (VxRail 4.7.300) -> 3.9.1 upgrade (VxRail 4.7.410). I hope this helped provide some guidance during your upgrade of VCF On VxRail!
Thank you for reading! Please let me know if this was of benefit in the comments below.