If SDDC Manager does not have internet connectivity, you can use the Bundle Transfer Utility to manually download bundles from the VMware depot to a computer that does have internet access. Then you copy the bundles to a computer that has access to the SDDC Manager VMand upload the bundles to SDDC Manager.

This procedure provides information about downloading all bundles that are on the VMware depot, but not available in the SDDC Manager LCM repository. To download specific bundles, see Download Specific Bundles.

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. Using SSH, log in to the SDDC Manager VM with the user name vcf and password you specified in the deployment parameter sheet.
  2. Navigate to the /opt/vmware/vcf/lcm/lcm-tools/bin directory.
  3. Generate a marker file by running the following command: 
    ./lcm-bundle-transfer-util --generateMarker
    The marker file ( markerFile) is a JSON file that contains information on the current software versions running on SDDC Manager. It also contains the bundle 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. The marker file is used to determine the bundles required to upgrade VMware Cloud Foundation.
  4. Copy markerFile and markerFile.md5 to a computer with internet access.
  5. Download the Bundle Transfer Utility & Skip Level Upgrade Tool to the computer with internet access.
    1. Log in to My VMware and browse to the Download VMware Cloud Foundation page.
    2. In the Select Version field, select the version to which you are upgrading.
    3. Click Drivers & Tools.
    4. Expand VMware Cloud Foundation Tools and click Go To Downloads.
    5. Click Download Now for the Bundle Transfer Utility & Skip Level Upgrade Tool.
  6. Extract lcm-tools-3x-<build number>.tar.gz.
  7. Navigate to the extracted folder and confirm that you have execute permission on all folders.
  8. 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
    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 the VMware depot (My VMware). You are prompted to enter the depot user password. If there are any special characters in the password, specify the password within single quotes.
    absolute-path-markerFile Absolute path to the marker file.

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

    absolute-path-markerFile.md5 Absolute path to the marker MD5 checksum file.

    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.

  9. When the bundle downloads complete, copy the output directory to a computer with access to the SDDC Manager VM, and then copy the directory to the SDDC Manager VM.
    For example: 
    scp -pr /root/upgrade-bundles vcf@SDDC_MANAGER_IP:/nfs/vmware/vcf/nfs-mount/

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

  10. In the SDDC Manager VM, change the ownership and permissions for the directory where you uploaded the bundles.
    For example: 
    chown vcf_lcm:vcf -R /nfs/vmware/vcf/nfs-mount/upgrade-bundles
    chmod -R 0777 /nfs/vmware/vcf/nfs-mount/upgrade-bundles
  11. In the SDDC Manager VM, upload the bundle files to the internal LCM repository. 
    ./lcm-bundle-transfer-util -upload -bundleDirectory absolute-path-bundle-dir

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

    The utility uploads the bundles and displays upload status for each bundle. Wait for all bundles to be uploaded before proceeding with the upgrade.