Please note the following:
- The entire AP Tool operation must be run as the vcf user.
- Enabling VC 7.0U3s patch will also update SDDC Manager services on VCF 4.4.0.0, 4.4.1.1, 4.5.0.0 and 4.5.1.0
- Download the latest Async Patch Tool to a computer with access to the SDDC Manager appliance.
- Option 1: Direct Download Link - AP Tool download
- Option 2:
- Log in to Broadcom Support Portal
- Navigate to the Async Patch Download:
Software > VMware Cloud Foundation > My Downloads > VMware Cloud Foundation > VMware Cloud Foundation 5.2 > Drivers & Tools > Async Patch Tool
- Copy the Async Patch Tool to the SDDC Manager appliance and configure it.
- SSH into the SDDC Manager appliance using the vcf user account.
Note: If an existing or older version of the Async Patch Tool (and older bundles) exists in the following directories, you must remove these files before downloading the latest version using the following command: rm -rf /home/vcf/asyncPatchTool && rm -rf /nfs/vmware/vcf/nfs-mount/apToolBundles
- Create the asyncPatchTool directory:
mkdir /home/vcf/asyncPatchTool
- Copy the Async Patch Tool file (vcf-async-patch-tool-<version>.tar.gz) downloaded in step 1 to the
/home/vcf/asyncPatchTool
directory.
- Navigate to
/home/vcf/asyncPatchTool
and extract the contents of vcf-async-patch-tool-<version>.tar.gz.
cd /home/vcf/asyncPatchTool
tar -xvf vcf-async-patch-tool-1.2.0.0.tar.gz
- Set the permissions for the asyncPatchTool directory.
chmod -R 755 /home/vcf/asyncPatchTool && chown -R vcf:vcf /home/vcf/asyncPatchTool
- Take a snapshot of the SDDC Manager VM.
- Configure TCP keepalive in your SSH client to prevent socket connection timeouts when using the Async Patch Tool for long-running operations.
- 300 = five minutes, generally enough to ensure the connection doesn't time out during download.
- Example: Putty > Change Settings > Connection > Seconds between keepalives (0 to turn off) > set to 300 > Apply
- Enable the async patch with the relevant command below:
If you connect to the internet through a proxy server, add the --proxyServer, --ps
option to specify the FQDN and port of the proxy server. For example, --proxyServer FQDN:port
.
4.x VMware Cloud Foundation:
/home/vcf/asyncPatchTool/bin/vcf-async-patch-tool -e --patch VCENTER:7.0.3.02100-24201990 --du customer_connect_email --sddcSSOUser SSOuser --sddcSSHUser vcf --it ONLINE
4.x VMware Cloud Foundation on Dell EMC VxRail:
/home/vcf/asyncPatchTool/bin/vcf-async-patch-tool -e --patch VCENTER:7.0.3.02100-24201990 --du customer_connect_email --sddcSSOUser SSOuser --pdu dell_emc_depot_email --sddcSSHUser vcf --it ONLINE
- Ensure a valid backup of the vCenter before applying the upgrade from SDDC UI.
- Log in to the SDDC Manager UI and apply the async patch to all workload domains
- After successfully applying the async patch, use the Async Patch Tool to deactivate the patch.
- SSH into the SDDC Manager appliance using the vcf user account.
- Run the following command and complete the prompts:
/home/vcf/asyncPatchTool/bin/vcf-async-patch-tool --disableAllPatches --sddcSSOUser SSOuser --sddcSSHUser vcf