Updating the vSAN HCL database through HTML5 Client or manually

Sep 13, 2022 | VMware, vSAN, VxRail

vSAN HCL database update

 

Steps to download a local copy of the vSAN HCL database file

 

  1. Log in to a workstation where you have internet access.
  2. Open the below link in browser: https://partnerweb.vmware.com/service/vsan/all.json (Right click, Save as)
  3. Save the file as all.json. If you are unable to save the file, you must copy the entire content and create a new file with extension “*.json”.
  4. Copy the file to another workstation which connects to the vCenter. Log in to vCenter server from there, and upload the file to the vCenter.

 

Update vSAN HCL database through vSphere Client (HTML5) Method 1

  1. Log in to vCenter server using vSphere Client with administrator credentials.
  2. Choose vCenter > Configure > vSAN > Update and select HCL Database

3. If the vCenter server can communicate with the internet, click Get latest version online.

4. If the vCenter server does not have a proxy and is unable to communicate with the internet, click Update from file to upload a local copy of the vSAN HCL database file.

5. Choose Cluster > Monitor > vSAN > Skyline Health  and click Retest.

 

Update vSAN HCL database through vSphere Client (HTML5) Method 2

  1. Log in to vCenter server using vSphere Client with administrator credentials.
  2. Choose Cluster > Monitor > vSAN > Skyline Health > Hardware compatibility > vSAN HCL DB up-to-date. If the vCenter server can communicate with the internet, click Get latest version online.

3. If the vCenter server does not have a proxy and is unable to communicate with the internet, click Update from file to upload a local copy of the vSAN HCL database file.

 

Update vSAN HCL database manually

1. Log in to your VCSA per SSH

2. Download vSAN Release Catalogue to vCenter VCSA:

wget https://partnerweb.vmware.com/service/vsan/all.json


3. Login to RVC and navigate to cluster

#rvc [options] [username[:password]@]hostname
rvc administrator@vsphere.local@localhost

cd <vcenter_fqdn>
cd <datacenter_name>
cd computers
cd <cluster_name>

4. Update HCL DB with the following command and accept with “Yes”:

/localhost/VSANClusterName/computers>vsan.health.hcl_update_db /localhost/ -l /tmp/all.json

5. If you receive the below error while trying to update the HCL database manually collect vCenter logs and open a ticket with VMware support for assistance.

  • “Unable to update the release catalog. Check the vSphere Client logs for details.”