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 7.x
VMware vSAN 8.x
VMware vSAN 9.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 > 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 SAN HCL database file.
  5. Click Retest.


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

  1. Log in to a workstation with internet access.
  2. Open the below link in HTML browser:
    https://partnerweb.vmware.com/service/vsan/all.json (Right click, Save as)
  3. Save the file as all.json. If unable to save the file, 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 file
    • vCenter > Configure > vSAN > Update > Update from file


If the below error message appears 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.'

If you get the following error message 'Failed to decode the HCL DB' when uploading file, open the link another tab and copy the text into notepad and then save file as all.json.

Additional Information

Powered by Wolken Software