HCL Offline Download for VMware Cloud Foundation
If the
SDDC Manager appliance
does not have access to an online or offline depot, you can use the Bundle Transfer Utility to manually download the HCL file from the depot on your local computer and then upload it to the SDDC Manager appliance
. - A Windows or Linux computer with internet connectivity (either directly or through a proxy) for downloading the HCL. To upload the HCL 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 Bundle Transfer Utility is the only supported method for downloading HCL. Do not use third-party tools or other methods to download HCL.
If the computer with internet access can only access the internet using a proxy server, use the following options when downloading the HCL:
Example that combines the options:
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 . |
./lcm-bundle-transfer-util --vsanHclDownload --outputDirectory output-directory --proxyServer proxy.example.com:3128 --proxyUser vmwuser --proxyPasswordFile ../../password.txt --proxyHttps
- Download the most recent version of the Bundle Transfer Utility on a computer with internet access.
- Log in to the Broadcom Support Portal and browse to.
- Click the version ofVMware Cloud Foundationto which you are upgrading.
- ClickDrivers & Tools.
- Click the download icon for the Bundle Transfer Utility.
- Extractlcm-tools-prod.tar.gz.
- Navigate to thelcm-tools-prod/bin/and confirm that you have execute permission on all folders.
- Copy the bundle transfer utility to a computer with access to theSDDC Manager applianceand then copy the bundle transfer utility to theSDDC Manager appliance.
- SSH in to theSDDC Manager applianceusing thevcfuser account.
- Entersuto switch to the root user.
- Create thelcm-toolsdirectory.mkdir /opt/vmware/vcf/lcm/lcm-toolsIf the/opt/vmware/vcf/lcm/lcm-toolsdirectory already exists with an older version of the Bundle Transfer Utility, you need to delete contents of the existing directory before proceeding.
- Copy the Bundle Transfer Utility file (lcm-tools-prod.tar.gz) that you downloaded in step 1 to the/opt/vmware/vcf/lcm/lcm-toolsdirectory.
- Extract the contents oflcm-tools-prod.tar.gz.tar -xvf lcm-tools-prod.tar.gz
- Set the permissions for thelcm-toolsdirectory.cd /opt/vmware/vcf/lcm/chown vcf_lcm:vcf -R lcm-toolschmod 750 -R lcm-tools
- On the computer with internet access, download the HCL file../lcm-bundle-transfer-util --vsanHclDownload --outputDirectory output-directoryIt can also be downloaded to the default path:./lcm-bundle-transfer-util --vsanHclDownload
- Copy the HCL file to theSDDC Manager appliance.
- From theSDDC Manager appliance, use the Bundle Transfer Utility to upload the HCL file../lcm-bundle-transfer-util --vsanHclUpload --inputDirectoryhcl-file-path--sddcMgrFqdnsddc-manager-fqdn--sddcMgrUseruserhcl-file-pathPath from where HCL file should be picked up to upload. e.g /root/testdownload/vsan/hcl/all.json. If not given default will be taken. (/root/PROD2/vsan/hcl/all.json)sddc-manager-fqdnSDDC Manager FQDN. If not given default will be taken.userSDDC Manager user. After this, the tool will prompt for the user password.