vSAN Health Service – vSAN HCL Health – Controller driver is VMware certified
Article ID: 326965
Updated On:
Products
Issue/Introduction
Adherence to the VMware Compatibility Guide (VCG)/Hardware Compatibility Guide (HCL) is critically important to the stability of vSAN environments. Experience has shown that failing to observe the VCG often leads to production outages over time. It is therefore very important to monitor the health checks in the HCL checker category. For more information, see the link related to Compatibility Guide
Environment
Resolution
Q: What does the vSAN HCL Health – Controller driver is VMware certified check do?
This health check displays whether or not the storage I/O controller driver is supported for controller installed on the host running ESXi, and whether it is supported with that release of ESXi.
Assuming that the SCSI controller is VMware certified and Controller is VMware certified for ESXi release health checks have passed, this check will further verify that the driver version in use is on the list of supported drivers.
This is important as drivers play a critical role in the stability and integrity of vSAN. Vendors often update their drivers to address critical bugs. In such cases, Broadcom may revoke the certification status of an old driver and only support the new version of the driver. Hence it is possible this check to turn from a healthy green (OK) state to showing warnings after refreshing the VCG database. In such cases, Broadcom recommends to upgrade the driver to the recommended version.
Note: There is also the possibility of a vendor updating a driver, and making it downloadable from their website. If Broadcom has not certified the driver for vSAN (either because the certification has not happened yet, or because it actually failed the certification) Broadcom does not recommend upgrading to this driver unless it appears on the VCG.
Before upgrading a driver, Broadcom recommends a refresh of the VCG database, checking the details section and checking for the supported drivers. If the new driver is supported, you can proceed with the upgrade with confidence.
Q: What does it mean when it is in an error state?
Note: If the SCSI controller is VMware certified or Controller is VMware certified for ESXi release check failed, then this check will also fail. If the driver is not listed in the VCG for this device and ESXi release, the vSAN environment may be at risk. If the driver is listed in the VCG for this device and ESXi release but still reports warning, it may indicate the driver is not certified with the current firmware.
Q: How does one troubleshoot and fix the error state?
If this test fails, Broadcom recommends to search the VCG and identify a desired driver and firmware pair and update the driver or firmware accordingly. It is possible the hardware (or it's firmware) or the release of the driver were recently added to the VCG.
For detailed instructions on how to query the make, model and version of your storage I/O controller, see the VMware vSAN Diagnostics and Troubleshooting Reference Manual (See Attached). If you still have difficultly determining storage I/O controller information, contact Broadcom Support to assess the situation fully. Do not simply rely on the automated health checks. Broadcom Support will also assist with any mitigation steps.
If the driver is not currently certified with the current controller firmware, an error will be reported and you should either update the controller driver or update the controller firmware to ensure them to be a certified pair.
Additional Information
Attachments
Feedback
