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.

What's New

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.

Known Issues

  • 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

    Version 1.1.1-<xxxxxx>
    Product Version 1.1.1.1 1.1.1.1
    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.

    1. Get the bundle ID for the bundle you want to remove.
      1. In the SDDC Manager UI, browse to Lifecycle Management > Bundle Management > Bundles.
      2. Find the bundle you want to remove and click View Details.
      3. Copy the bundle ID.
    2. SSH in to the SDDC Manager appliance using the vcf user account.
    3. Enter su to switch to the root user.
    4. Enter the following command, replacing <bundle id> with the bundle ID from step 1: python /opt/vmware/vcf/lcm/lcm-app/bin/bundle_cleanup.py <bundle id>

check-circle-line exclamation-circle-line close-line
Scroll to top icon