If you do not have direct internet connectivity to your SDDC Manager instance, 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
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.
Procedure
- Connect to SDDC Manager appliance and generate a marker file.
- Log in to SDDC Manager by using a Secure Shell (SSH) client.
Use the user name vcf and password you specified in the deployment parameter workbook.
- Enter su to switch to the root user and enter the password.
- Generate a marker file by entering the following command.
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 file contains the checksum for the markerFile. The output contains the directory where the marker file is generated.
/opt/vmware/vcf/lcm/lcm-tools/bin/lcm-bundle-transfer-util --generateMarker
- Move the marker files to the
/opt/vmware/vcf/lcm/lcm-tools/
folder by entering the following command.mv /root/markerFile* /opt/vmware/vcf/lcm/lcm-tools/
- Modify the ownership of the marker files to ensure the vcf user has access to download by entering the following command.
chown vcf:users /opt/vmware/vcf/lcm/lcm-tools/markerFile*
- Log in to SDDC Manager by using a Secure Shell (SSH) client.
- From the SDDC Manager appliance, copy the /opt/vmware/vcf/lcm/lcm-tools directory to a computer with internet access.
- Download the bundles from a computer with internet access.
- From the /lcm-tools/bin folder where you downloaded the utility download the bundles by entering the following command.
Linux ./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>" Windows lcm-bundle-transfer-util.bat -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 my VMware 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.
-p
Filter the bundles for a specific version of VMware Cloud Foundation. The value is based on x.x.x.x format and must be enclosed in double quotes.
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 in the VMware depot. The applicable bundles identified in the delta file are downloaded. Download progress for each bundle is displayed.
- Copy the offline bundle directory from the external computer to the /nfs/vmware/vcf/nfs-mount folder on the SDDC Manager appliance.
scp -pr /downloads/offlineBundles vcf@<sddc_manager_ip>:/nfs/vmware/vcf/nfs-mount
The scp command in the example above creates a directory named offlineBundles in the /nfs/vmware/vcf/nfs-mount directory.
- On the SDDC Manager appliance, change the ownership and permissions of the uploaded bundle.
chmod -R 777 /nfs/vmware/vcf/nfs-mount/offlineBundles
- On 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 -bundleDirectory <absolute-path-output-dir>
where absolute-path-output-dir is the directory where the bundle files have been uploaded (/nfs/vmware/vcf/nfs-mount/offlineBundles 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.