LCM polls the VMware depot to access 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 from the depot on your local computer and then upload them to SDDC Manager.

Prerequisites

This section applies to sequential upgrades only. To download bundles for a skip-level upgrade, see Skip-Level Upgrade.

Ensure you have access to a Windows or Linux computer with internet connectivity for downloading the bundles. The computer must have Java 8 or later.

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 LCM tools 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 3.10.2.
    4. Expand VMware Cloud Foundation Tools and click Go To Downloads.
    5. In the LCM tools cell, click Download Now.
  2. Using SSH, log in to the SDDC Manager VM with the user name vcf and password you specified in the deployment parameter sheet.
  3. Change directories: 
    cd /opt/vmware/vcf/lcm/lcm-tools/bin
  4. Download the required bundles using one of the commands below. For help on available options, type the following:
    /opt/vmware/vcf/lcm/lcm-tools/bin/lcm-bundle-transfer-util --help
    • Download all bundles for a release.

      ./lcm-bundle-transfer-util -download -output Directory Output-Dir -depotUser Username -p releaseNumber

    • Download a single bundle.

      ./lcm-bundle-transfer-util -download -outputDirectory Output-Dir -depotUser Username -bundle bundle-name

    • Download bundles by type (install or patch).

      ./lcm-bundle-transfer-util -download -outputDirectory Output-Dir -depotUser -imageType INSTALL|PATCH

    • Generate a marker file with all bundles that apply based on the software version in your environment.

      ./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.

  5. Copy the /opt/vmware/vcf/lcm/lcm-tools directory, and the downloaded bundles (or marker file) from step 3 to a computer with internet access.
    The /opt/vmware/vcf/lcm/lcm-tools directory includes the bundle transfer utility required for the next step.
  6. On the computer with internet access, 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} -p ${vcf product version}
    where
    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. This is required only if you generated a marker file in step 3.

    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 download 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. Initially, only the SDDC Manager bundle will be available.

  7. Copy the update bundle directory from the external computer to the SDDC Manager VM.
    For example: 
    scp -pr /root/vcf372tovcf38Bundle vcf@SDDC_MANAGER_IP:/nfs/vmware/vcf/nfs-mount/

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

  8. In the SDDC Manager VM, change the ownership and permissions of the uploaded bundle. 
    chmod -R 0777 /nfs/vmware/vcf/nfs-mount/vcf372tovcf38Bundle
  9. In the SDDC Manager VM, upload the bundle files to the internal LCM repository. You must upload the upgrade and install bundles. 
    cd /opt/vmware/vcf/lcm/lcm-tools/bin
./lcm-bundle-transfer-util -upload -bundleDirectory ${absolute-path-output-dir}

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

    The utility uploads the bundles specified in the deltaFileDownloaded file. The console displays upload status for each bundle. Wait for all bundles to be uploaded before proceeding with the upgrade.