Once SDDC Manager is upgraded to 5.2, a new option for patching VMware Cloud Foundation components is available in the SDDC Manager UI. This procedure describes using the Bundle Transfer Utility to download async patches when SDDC Manager is not connected to an online depot.

Offline download of async patches involves the following steps:
  • On a computer with access to the internet, use the Bundle Transfer Utility to download the async patch bundle and other required files.
  • On a computer with access to the SDDC Manager appliance, use the Bundle Transfer Utility to upload the bundle and other required files to the SDDC Manager appliance.
  • On the SDDC Manager appliance, use the Bundle Transfer Utility to upload the bundle and other required files to the internal LCM repository.
If the computer with internet access can only access the internet using a proxy server, use the following options when downloading:
Option Description
--proxyServer, --ps Provide the proxy server FQDN and port.

For example: --proxyServer proxy.example.com:3128.
--proxyHttps Add this option if the proxy server uses HTTPs.
--proxyUser For a proxy server that requires authentication, enter the user name.
--proxyPasswordFile For a proxy server that requires authentication, enter the path to a file where the password for proxy authentication is stored. The file content is used as the proxy password.

For example, --proxyPasswordFile ../../password.txt.
Example that combines the options: 
./lcm-bundle-transfer-util --download --manifestDownload --depotUser Username --proxyServer proxy.example.com:3128 --proxyUser vmwuser --proxyPasswordFile ../../password.txt --proxyHttps

Prerequisites

  • A Windows or Linux computer with internet connectivity (either directly or through a proxy) for downloading the bundles and other required files.
  • A Windows or Linux computer with access to the SDDC Manager appliance for uploading the bundles.
  • To upload the manifest file from a Windows computer, you must have OpenSSL installed and configured.
  • Configure TCP keepalive in your SSH client to prevent socket connection timeouts when using the Bundle Transfer Utility for long-running operations.
  • The computer with internet connectivity, the computer with access to SDDC Manager appliance, and the SDDC Manager appliance must all have the latest version of the Bundle Transfer Utility installed and configured. See Offline Download of VMware Cloud Foundation 5.2 Upgrade Bundles for more information.

Procedure

  1. Download bundles and other artifacts to the computer with internet access.
    1. Download the manifest file.
      This is a structured metadata file that contains information about the VMware product versions included in the release Bill of Materials. 
      ./lcm-bundle-transfer-util --download --manifestDownload --depotUser Username
      For --depotUser, enter your Broadcom Support Portal user name.
    2. Download the compatibility data. 
      ./lcm-bundle-transfer-util --download --compatibilityMatrix --depotUser Username
      To specify a download location, use --outputDirectory followed by the path to the directory.
    3. List the available async patches. 
      ./lcm-bundle-transfer-util --listAsyncPatchBundles --depotUser Username
    4. Download an async patch. 
      ./lcm-bundle-transfer-util --download --bundle bundle-number --depotUser Username
      For example: 
      ./lcm-bundle-transfer-util --download --bundle bundle-12345 --depotUser [email protected]
  2. Copy the following files/directories to a computer with access to the SDDC Manager appliance.
    • Manifest file
    • Compatibility data file (VmwareCompatibilityData.json)
    • Entire bundle output directory
  3. From the computer with access to the SDDC Manager appliance, upload the bundles and artifacts to the SDDC Manager appliance.
    1. Upload the manifest file to the SDDC Manager appliance. 
      ./lcm-bundle-transfer-util --update --sourceManifestDirectory Manifest-Downloaded-Directory --sddcMgrFqdn FQDN --sddcMgrUser Username
      Use your vSphere SSO credentials for the --sddcMgrUser parameter.
    2. Upload the compatibility file to the SDDC Manager appliance. 
      ./lcm-bundle-transfer-util --update --compatibilityMatrix --inputDirectory compatibility-file-directory --sddcMgrFqdn FQDN --sddcMgrUser Username
    3. Copy the entire bundle output directory to the SDDC Manager appliance.
      You can select any location on the SDDC Manager appliance that has enough free space available. For example, /nfs/vmware/vcf/nfs-mount/.
      Example command to copy the output directory to the SDDC Manager appliance: 
      scp -pr /root/upgrade-bundles vcf@SDDC_MANAGER_IP:/nfs/vmware/vcf/nfs-mount/
      The scp command in the example above copies the output directory ( upgrade-bundles) to the /nfs/vmware/vcf/nfs-mount/ directory on the SDDC Manager appliance.
  4. Upload the bundle directory to the SDDC Manager appliance internal LCM repository.
    1. SSH in to the SDDC Manager appliance using the vcf user account.
    2. Enter su to switch to the root user.
    3. Navigate to /opt/vmware/vcf/lcm/lcm-tools/bin.
    4. Run the following command: 
      ./lcm-bundle-transfer-util --upload --bundle bundle-number --bundleDirectory absolute-path-bundle-dir
      • Replace number with the bundle number you are uploading. For example: 12345 for bundle-12345.
      • Replace absolute-path-bundle-dir with the path to the location where you copied the output directory. For example: /nfs/vmware/vcf/nfs-mount/upgrade-bundles.

What to do next

After the upload completes successfully, you can use the SDDC Manager UI to apply the async patch. See Patching the Management and Workload Domains.