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.x
VMware vSAN 7.x
VMware vSAN 8.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.'


Additional Information