Upgrade from VCF 5.0 on VxRail 8.0.100 to VCF 5.0 on VxRail 8.0.110, use the VMware Async Patch (AP) tool v1.1.0.2.

For a detailed overview of the AP Tool please read this excellent post by Daniel: VCF on VxRail: Async Patch Tool

This post details how to apply the VxRail upgrade in a VCF On VxRail system using the AP Tool Online Mode. The content provides a detailed walkthrough on how to apply the VxRail upgrade in a VCF On VxRail system. It includes necessary links and images to guide the readers. Details of the VxRail 8.0.110 version can be found in the VCF On VxRAIL Release Notes.

Async VxRAIL patches for VCF On VxRail 5.x and 4.x deployments have been made available. Please see KB88287 for more information:

Important APT Links:

To apply the aync patch online your SDDC Manager appliance requires a connection to the internet, you can run the Async Patch Tool from the SDDC Manager appliance to download and enable an async patch. Once the patch is successfully enabled, you can use the SDDC Manager UI to apply the patch to all workload domains.

Before proceeding it is advisable to run healt pre-checks of your system. This example showcases the context level pre-check for VxRail (More details on context level prechecks here):

This example walks through the VxRAIL Async Patch prcedure in a VCF 5.0 On VxRail system:

Begin by downloading the latest Async Patch Tool 1.1.0.2 to a computer with access to the SDDC Manager appliance (Direct Download Link – AP Tool download):

Note: The entire operation must be run with the vcf user.

SSH into the SDDC Manager appliance using the vcf user account & create the asyncPatchTool directory:

mkdir /home/vcf/asyncPatchTool

Copy the Async Patch Tool file to the /home/vcf/asyncPatchTool directory. Navigate to /home/vcf/asyncPatchTool and extract the contents of vcf-async-patch-tool. Set the permissions for the asyncPatchTool directory:

  • cd /home/vcf/asyncPatchTool
  • ls -alh
  • tar -xvf vcf-async-patch-tool-1.1.0.2.tar.gz
  • chmod -R 755 /home/vcf/asyncPatchTool
  • chown -R vcf:vcf /home/vcf/asyncPatchTool
  • ls -la

Copy the VxRail async patch-specific partner bundle metadata file using KB 91830.

Note: At this point take a snapshot of SDDC Manager VM.

Next navigate to the /bin directory where the APT is located and list the available patches to gather the required details for enabling the vCenter patch. Then run the commands to precheck & enable the patch and follow the prompts to enter credentials including the DELL Depot u/n & p/w:

  • cd /home/vcf/asyncPatchTool/bin/
  • ./vcf-async-patch-tool -l --depotUser depotusername --depotPassword password --sku VCF_ON_VXRAIL
  • ./vcf-async-patch-tool -e --patch VX_MANAGER:8.0.0110-28169413 --du depotusername --depotPassword password --pdu pduser --pdp password --sddcSSOUser administrator@vsphere.local --sddcSSOPassword password --sddcSSHUser vcf --sddcSSHPassword password --it ONLINE
  • tail -f async_patch_tool.log

When enable patch completes successfully then you can log in to the SDDC Manager UI and apply the async patch to all workload domains. Ensure a valid backup of the vCenter before applying the upgrade from SDDC UI. In this example we apply the patch to the Managment WLD:

Monitoring progress to completion:

  • tail -f /var/log/vmware/vcf/lcm/lcm.log
  • cat /var/log/vmware/vcf/lcm/lcm.log | grep "reached final state COMPLETED_WITH_SUCCESS"

Upgrade of VxRAIL COMPLETED SUCCESSFULLY!

Hope that helped! Please leave a comment!

Thanks for reading!

Leave a comment