LCM polls the VMware depot to access the update bundles. If you do not have internet connectivity in your VMware Cloud Foundation system, you can use the Bundle Transfer Utility to manually download the bundles to your local computer and then upload them to the SDDC Manager appliance.

You must download the LCM 2.0 manifest file and upload it to the SDDC Manager VM. The manifest contains information about the VMware product versions included in the release Bill of Materials and is used to determine the upgrade path. It is recommended that you download the LCM 2.0 manifest file and upload it to the SDDC Manager appliance periodically so that you are aware of the latest available bundles.

Prerequisites

A Windows or Linux computer with Java 8 or later and internet connectivity for downloading the bundles.

Note: The Bundle Transfer Utility and Skip Level Upgrade Tool is the only supported method for downloading bundles. Do not use third-party tools or other methods to download bundles.

Procedure

  1. Download the bundle transfer utility on a computer with internet access.
    1. Login to MyVMware and click Product Downloads.
    2. In the VMware Cloud Foundation row, click Drivers and Tools.
    3. In the Select Version field, select 4.3.
    4. Expand VMware Cloud Foundation Tools and click Go To Downloads.
    5. In the Bundle Transfer Utility cell, click Download Now.
  2. Navigate to utility_downloaded_directory/bin/ and confirm that you have execute permission on all folders.
  3. Validate that the utility version matches the target release. Run the following command to display the utility version:
    ./lcm-bundle-transfer-util -h
  4. In the same directory, download the LCM 2.0 manifest file.
    This is a structured metadata file that contains information about the VMware Cloud Foundation product versions included in the release Bill of Materials.
     ./lcm-bundle-transfer-util --download --manifestDownload --depotUser Username --depotUserPassword Password 
  5. Upload the manifest file to the SDDC Manager appliance.
    ./lcm-bundle-transfer-util --update --sourceManifestDirectory downloaded-manifest-directory --sddcMgrFqdn FQDN --sddcMgrUser Username --download --outputDirectory absolute-path-output-dir --depotUser Username -p releaseNumber
    Use your vSphere SSH credentials for the --sddcMgrUser credentials in the command.
  6. Download the required bundles using one of the commands below. For help on available options, type the following:
    utility_downloaded_directory/bin/lcm-bundle-transfer-util --help 
    • Download all bundles for a release.
      ./lcm-bundle-transfer-util --download --outputDirectory absolute-path-output-dir --depotUser Username -p releaseNumber
    • Download a single bundle.
      ./lcm-bundle-transfer-util --download --outputDirectory absolute-path-output-dir --depotUser Username -bundle bundle-name
    • Download bundles by type (install or patch).
      ./lcm-bundle-transfer-util --download --outputDirectory absolute-path-output-dir --depotUser Username --imageType INSTALL or PATCH
    • Generate a marker file with all bundles that apply based on the software version in your environment. To do this, SSH to the SDDC Manager VM and then run the following command.
      ./lcm-bundle-transfer-util --generateMarker

      The marker file (named markerFile) is a JSON file that contains information on the current software versions running on SDDC Manager. It also contains the bundles IDs for bundles that were downloaded before this file was generated. The markerFile.md5 contains the checksum for the markerFile. The output contains the directory where the marker file is generated.

      Copy the generated marker file to the computer where you downloaded the Bundle Transfer Utility and run the following command:
      ./lcm-bundle-transfer-util --download --outputDirectory absolute-path-output-dir --depotUser depotUser --markerFile absolute-path-markerFile --markerMd5File absolute-path-markerFile.md5
      Note: When you download the NSX-T Data Center or vCenter Server bundles, provide the additional argument withCompatibilitySets, which downloads the compatibility sets along with the bundles. For example, --download "withCompatibilitySets".
      Note: When you download the VxRail bundles, provide the additional argument downloadPartnerBundle. When downloading partner bundles, you must also provide login information for the Dell EMC depot. For example, --download "downloadPartnerBundle" --pdu emcdepotuser:emcdepotpassword.
      absolute-path-output-dir Path to the directory where the bundle files are to be downloaded. This directory folder must have 777 permissions.

      If you do not specify the download directory, bundles are downloaded to the default directory with 777 permissions.

      depotUser User name for myVMware depot. You are prompted to enter the depot user password. If there are any special characters in the password, specify the password within single quotes.
      markerFile Absolute path to the marker file, as generated in the above step.

      If you do not specify the path to the marker file, all update bundles on the depot are downloaded.

      markerMd5File Absolute path to the marker MD5 checksum file, as generated in the above step.

      The utility generates a delta file (deltaFileDownloaded) in the output directory based on the software versions in the marker file and the update bundles available on the depot. The applicable bundles identified in the delta file are downloaded. Download progress for each bundle is displayed.

  7. If you downloaded compatibility sets, copy the downloaded softwareCompatibilitySets.json to the /nfs/vmware/vcf/nfs-mount/bundle/depot/local directory on the SDDC Manager appliance.
  8. If you downloaded VxRail bundles:
    1. Copy the partner bundle to the /nfs/vmware/vcf/nfs-mount/bundle/depot/local/bundles directory on the SDDC Manager appliance.
    2. Copy partnerBundleMetadata.json to the /nfs/vmware/vcf/nfs-mount/bundle/depot/local directory on the SDDC Manager appliance.
    3. Copy softwareCompatibilitySets.json to the /nfs/vmware/vcf/nfs-mount/bundle/depot/local directory on the SDDC Manager appliance.
    4. Run following commands on the SDDC Manager appliance:
      chown -R vcf_lcm:vcf /nfs/vmware/vcf/nfs-mount/bundle/depot/local
      chmod -R 755 /nfs/vmware/vcf/nfs-mount/bundle/depot/local
    5. In the SDDC Manager appliance, upload the bundle files to the internal LCM repository.
      cd /opt/vmware/vcf/lcm/lcm-tools/bin
      ./lcm-bundle-transfer-util --upload "uploadPartnerBundle" --bundleDirectory 
      absolute-path-output-dir
  9. If you downloaded bundles for VMware Cloud Foundation and it's components, copy the output directory from the external computer to the SDDC Manager appliance.
    For example:
    scp -pr /Work/UpdateBundles vcf@SDDC_MANAGER_IP:/nfs/vmware/vcf/nfs-mount/

    The scp command in the example above creates a directory named UpdateBundles in the /nfs/vmware/vcf/nfs-mount/ directory.

  10. In the SDDC Manager appliance, change the ownership and permissions for the directory to which you the uploaded bundles.
    chmod -R 0777 /nfs/vmware/vcf/nfs-mount/UpdateBundles
  11. In the SDDC Manager appliance, upload the bundle files to the internal LCM repository.
    cd /opt/vmware/vcf/lcm/lcm-tools/bin
    ./lcm-bundle-transfer-util --upload "withCompatibilitySets" --bundleDirectory 
    absolute-path-output-dir

    where absolute-path-output-dir is the directory where the bundle files have been be uploaded, or /nfs/vmware/vcf/nfs-mount/UpdateBundles as shown in the previous step.

    The console displays upload status for each bundle.