VMware Cloud Foundation | 05 MAY 2022
Async Patch Tool 1.0.0 | 05 MAY 2022 | Build 19722387
Check for additions and updates to these release notes.
The Async Patch Tool is a utility that allows you to apply critical patches to certain VMware Cloud Foundation components (NSX-T Manager, vCenter Server, and ESXi) outside of VMware Cloud Foundation releases. The Async Patch Tool also allows you to upgrade an async patched system to a new version of VMware Cloud Foundation.
The Async Patch Tool is supported with VMware Cloud Foundation 4.2.1 and later.
See KB 88287 for information about which async patches are supported with your version of VMware Cloud Foundation. The Knowledge Base article also includes information about supported upgrade paths for VMware Cloud Foundation instances that include an async patch.
For more information, see the Async Patch Tool documentation.
Async patch bundles display non-standard version numbers in the SDDC Manager UI
Async patch bundles include non-standard version numbers wherever information about the bundles is displayed in the SDDC Manager UI. For example,
Version 1.1.1-000001 or
Required Version 1.2.0-123456 as seen below.
Async Patch Bundle Versioning
|Product Version 188.8.131.52||184.108.40.206|
|Required Version: NSX-T Manager async patch bundle||1.1.0-<xxxxxx>|
|Required Version: ESXi async patch bundle||1.2.0-<xxxxxx>|
|Required Version: vCenter Server async patch bundle||1.3.0-<xxxxxx>|
Workaround: None. This is by design and ensures that async patches are prioritized and applied in the correct order.
Update history information for workload domains does not contain all updates
When you disable all async patches from the SDDC Manager appliance, any update history for previously enabled or applied async patches is lost. No update history will be visible from the SDDC Manager UI or in the VMware Cloud Foundation API response. Disabling all patches happens implicitly when you run the Async Patch Tool with the enable VCF upgrade option (
-r, --enableVCFUpgrade). If you previously enabled an async patch, you must disable all patches before you can run the Async Patch Tool with the enable patch option (
-e, --enableAsyncPatch) again.
Workaround: View the Async Patch Tool
upgrade_history logs to review the entire async patch update history. Logs are located in the
/var/log/vmware/vcf/lcm/tools/asyncpatchtool directory on the SDDC Manager appliance.
Older install or upgrade bundles appear as available to download
If SDDC Manager is connected to the VMware Depot, and you enable an async patch, older bundles, that are not required, may appear as available for download in the SDDC Manager UI (Lifecycle Management > Bundle Management > Bundles). For example, if you enable an async patch for vCenter Server 7.0 Update 3d, the bundle for vCenter Server 7.0 Update 2c may appear as available for download.
Workaround: Remove the bundles that you do not require.
suto switch to the root user.
python /opt/vmware/vcf/lcm/lcm-app/bin/bundle_cleanup.py <bundle id>