Bypass SDDC Manager pre-check for vSAN Storage Controller

Products

• VMware Cloud Foundation

Issue/Introduction

SDDC Manager pre-upgrade check is failing on storage controller in vSAN enabled cluster even though the controller is not in use or is known to be compatible per HCL.

During SDDC Manager pre-upgrade checks, under the Cluster Image Health and Compatibility Check the following error is observed:

Task Description: Perform Stage - Hardware device compatibility check for the host
Start Time: Date time stamp
End Time: Date time stamp

Overall Status: Red
Status: Error
Message: <storage controller> Device is incompatible with the cluster's ESXi 8.0 U3

Environment

VMware Cloud Foundation 4.X

VMware Cloud Foundation 5.X

Resolution

Workaround:

1. Take a snapshot of the SDDC Manager
   
   
2. SSH into the SDDC Manager
   
   
3. Change directory:
   cd /opt/vmware/vcf/lcm/lcm-app/conf/
   
   
4. Edit the configuration file:
   vi application-prod.properties
   
   
5. Search for vsan and change the values from true to false
   Example changes:
   vsan.healthcheck.enabled=false
vsan.hcl.update.enabled=false
vsan.precheck.enabled=false
   
   
6. Save the file
   
   
7. Restart the LCM service:
   systemctl restart lcm

Additional Information

It is required to run the software on supported hardware. Make sure to verify that the controller is indeed on the HCL. Bypassing the validation steps without verifying could leave your environment in an unsupported configuration. Running unsupported hardware may result in a denial of support.

Perform the upgrade as normal. After completing the upgrade, make sure to revert the values in /opt/vmware/vcf/lcm/lcm-app/conf/application-prod.properties back to true.

Restart the LCM service: systemctl restart lcm

Also make sure to delete the SDDC Manager snapshot completing the upgrade.