VMware Cloud Foundation Offline Bundle 4.X

Share on:

Recently I was assigined to a project within my company to deploy VMware Cloud Foundation 4.x within one of our dark sites. The team started researching updating VMware Cloud Foundation when deployed within dark site. We came across VMware doc that went over the process. Over the weekend I decided to deploy nested VMware Cloud Foudation within my home lab using Intel NUCs. Another blog post will go over in detail on how to deploy nested VMware Cloud Foundation on Intel NUCs.

This walkthrough will go over how to download the offline bundle needed to upgrade your dark site VMware Cloud Foundation enviroment.

Prerequisites

You will need the folllowing before continuing:

  • A process worked out with the security team in order to bring JSON and MD5 outside of your enviroment.
  • A process worked out with the security team in order to bring the LCM tools (Bundle Transfer Utility) outside of your enviroment. The LCM tools are included inside SDDC Manager.
    • Note: you might be able to reach out to GSS in order to have the LCM tools provided to you via Offical download link.
  • MyVMware account that has entitlement for VMware Cloud Foundation.
  • A endpoint (Linux or Windows) that has internet connectivity.
    • For this demo, I will be using a Windows 10 workstation.
  • Java Runtime Environment Installed
    • Can be downloaded here
  • WinSCP Installed
    • Can be downloaded here

Procedure

1. SSH into SDDC Manager VM

You can either use openSSH client that is now built into Windows 10 since build 1803 or Putty

  1. Use the user name “vcf” and password

  1. Change directory to the following location:

cd /opt/vmware/vcf/lcm/lcm-tools/bin

2. Generate the marker file

From VMware “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.”

1./lcm-bundle-transfer-util --generateMarker

If you see “Succesfully created Marker file: /home/vcf/markerFile and Marker MD5 file: /home/vcf/markerFile.md5” then generate command was executed succesfully.

3. Copy the LCM tools and marker file from the internal SDDC Manager VM to the external workstation with Interent Connectivity

Connect to the SDDC Manager using WinSCP

  1. Open WinSCP
  2. Set file protocol to “SCP”
  3. Provide the Hostname or IP to your SDDC Manager (example, sddc-manager.esx.lab)
  4. Port Number should be 22
  5. Username should be “vcf”
  6. Enter the password for “vcf” and press login

Copy the MarkerFile from the SDDC Manager VM to workstation.

  1. Verify your in the “/home/vcf” directory after connecting to SDDC Manager via WinSCP.
  2. Copy the following files to a directory you created on your workstation (Example, c:\temp\vcf-upgrade) * markerFile * markerFile.MD5

Copy LCM tools from the internal SDDC Manager to workstation.

  1. Change directory in WinSCP
1cd /opt/vmware/vcf/lcm/lcm-tools/
  1. Copy the following folders to the same directory you copied the markerfile. * bin * conf * lib

Verify the contents of the directory

 1 ├── bin
 2 	├── bundle-signing-tool
 3 	├── bundle-signing-tool.bat
 4 	├── lcm-bundle-transfer-util
 5 	├── lcm-bundle-transfer-util.bat
 6 	├── lcm-create-bundle
 7 	├── lcm-create-bundle.bat
 8 	├── lcm-debug-tool
 9 	├── lcm-debug-tool.bat
10 	├── lcm-validate-bundle
11 	├── lcm-validate-bundle.bats
12 	├── sddcmanager-skip-level-upgrade
13 	├── sddcmanager-skip-level-upgrade.bat
14├── conf
15        ├── skiplevelupgrade
16 	├── telemetry
17 	├── application-prod.properties
18 	├── application-skiplevelupgrade.properties
19 	├── feature.properties
20 	├── logback-prod.xml
21 	├── logback-skiplevelupgrade.xml
22 	├── logback.xml
23 	├── README.txt
24 ├──  lib
25        ├── *.jar files
26 ├── MarkerFile
27 ├── MakerFile.md5

Copy the contents of the directory you created on the internal workstation to the external workstation with internet connectivity.

For this demo, we are going to assume I have already copied the tools and marker file outside of the dark site environment.

4. Downloading offline bundle on the interent conencted workstation

  1. On the workstation with interent access. Run Powershell or Command Prompt as administrator.

  2. Chanage directory to the folder you copied over from the internal workstation.

  3. Change directory to the “bin” folder

  4. Type the following command: (Note it is case sensitive!)

    This part will require a MyVMware account that has entitlement for VMware Cloud Foundation. (Note if you have VxRail –pdu or –partnerDepotUser switch would be added.)

1.\lcm-bundle-transfer-util --download --outputDirectory C:\temp\VCF-Demo\ --depotUser 'MyVMware Account' --markerFile C:\temp\VCF-Demo\markerFile --markerMd5File C:\temp\VCF-Demo\markerFile.md5
  1. Type in your MyVMware password

  2. Verify the files and versions being downloaded

  3. Type in “y” to continue

  4. The tool should start downloading the files needed

  5. You should see the following output after the download has completed.

5. Uploading the update bundle to the SDDC Manager VM

For this demo, we are going to assume I have already copied the update bundle back into dark site environment.

  1. Open WinSCP and connect to the SDDC Manager VM
  2. Change directory in WinSCP
1/nfs/vmware/vcf/nfs-mount/
  1. Create a folder (example, bundle-1-25-2021)
  2. Copy the following contents you downloaded into new directory created on the SDDC Manager
1  ├── bundles (Folder)
2  ├── manifests (Folder)
3  ├── tmp (folder)
4  ├── deltafileDownloaded
5  ├── deltafileDownloaded.md5
6  ├── index.v3

6. In the SDDC Manager VM, change ownership and permissions of the uploaded bundle

  1. SSH into SDDC Manager VM
  2. Run the following command:
1chmod -R 0777 /nfs/vmware/vcf/nfs-mount/folderyoucreated

7. In the SDDC Manager VM, import the update bundle

  1. SSH into SDDC Manager VM
  2. Change directory to the following
1cd /opt/vmware/vcf/lcm/lcm-tools/bin
  1. Run the following command:
1./lcm-bundle-transfer-util -upload -bundleDirectory /nfs/vmware/vcf/nfs-mount/folderyoucreated

  1. Wait for the tool to validate all the files. This may take awhile * Note you can see the import process if you log into the SDDC Manager mangement interface.

Wait for all bundles to be uploaded before proceeding with the upgrade.

  1. You should see the following output when the process is completed.

8. Verify import within the SDDC Manager client

  1. Log into SDDC Manager client using a web browser.
1https://sddc-manager.esx.lab
  1. Go to “Lifecyle Management” and select “Bundle Management”

  2. You should see the applicable bundles for your environment inside Lifecyle Management. Clicking on download history will show all of the compoments that have been imported.

Thats it! You have succesfully imported offline bundles into SDDC manager. In the next blog post, I will go over how to upgrade your VMware Cloud Foundation environment.

Sources

Offline Bundle Download for VMware Cloud Foundation

Deep dive into VMware Cloud Foundation – Part 1 Building a Nested Lab