Bypass SDDC Manager pre-check for vSAN Storage Controller
search cancel

Bypass SDDC Manager pre-check for vSAN Storage Controller

book

Article ID: 386879

calendar_today

Updated On:

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

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.

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.