Updating the vSAN HCL database manually
search cancel

Updating the vSAN HCL database manually

book

Article ID: 315556

calendar_today

Updated On:

Products

VMware vSAN

Issue/Introduction

This article provides steps to update the vSAN HCL database manually.

Environment

VMware vSAN 6.2.x
VMware vSAN 6.x
VMware vSAN 8.0.x
VMware vSAN 6.1.x
VMware vSAN 6.6.x
VMware vSAN 6.5.x
VMware vSAN 6.7.x
VMware vSAN 7.0.x

Resolution

Update vSAN HCL database via the vSphere Client
1. Log in to vCenter server using vSphere Client with administrator credentials.
2. Navigate to the health sub-test: Cluster > Monitor > vSAN > Health/Skyline Health > Hardware Compatibility > vSAN HCL DB up-to-date
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. Click Retest.

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 your HTML 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 that can access the vCenter.  Log in to the vCenter server from there, and upload the file to the vCenter
  • Cluster > Monitor > vSAN > Health/Skyline Health > Hardware Compatibility > vSAN HCL DB up-to-date > Update from filevSAN-Health-HCL-update-from-file.png
  • vCenter > Configure > vSAN > Update from filevCenter-Configure-vSAN-Update.png

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.'

Additional Information