vSAN Health Service - Online Health - Controller Utility is Installed on Host : For vSphere 6.7 and earlier versions
search cancel

vSAN Health Service - Online Health - Controller Utility is Installed on Host : For vSphere 6.7 and earlier versions

book

Article ID: 326770

calendar_today

Updated On:

Products

VMware vSAN

Issue/Introduction

Note: The health check is applicable for vSphere 6.7 and earlier versions.

Verifies whether a recommended controller utility is installed on the ESXi host.

The controller utilities enable additional health checks based on controller settings. The yellow check status indicates that vSAN Health Service is not able to find the appropriate controller utility for the storage controller on the host. Typically, the controller utility is used to configure and view configuration data. When vSAN Health Service can retrieve controller configuration data, it can further analyze configuration issues for the current vSAN setup.



Environment

VMware vSAN 6.x
VMware vSAN 7.0.x

Resolution

Process to address Health Check Alert:

To address this health check alert, install the recommended controller utility. Typically, vSAN recommends one of the following controller utilities:

  • storcli
  • perccli
  • sas3flash
  • ssacli

Process to Install Controller Utility:

The utility version you install must be compatible with the ESXi hosts and controllers installed on your hosts. Before installing the controller utility, consult the VMware Compatibility Guide and your controller or server vendor to obtain information about the compatible utility version.

  1. Download the utility from the vendor recommended portal.

    Utility Portal
    storcli

    storcli is the controller utility for LSI based HBA and RAID controllers. Currently, storcli is officially available from Broadcom Support Web Portal.

    storcli might also be available from the server vendor. Check the server vendor support site first.

    1. Navigate to the web portal for support and driver download of the server vendor or controller maker.
    2. Search for your controller model, version, and other information.
      For example, on the Broadcom Support site, enter MEGARAID SAS 9341-8I, and click Search.
    3. Download the storcli utility for your ESXi version.
      For example, on the Broadcom Support site, expand the Management Software and Tools section of the search result and find storcli.
    perccli
    1. Navigate to the Dell Web Portal for Driver Support and Download.
    2. Input your server platform for example, PowerEdget T330.
    3. Change the Operating System option to ESXi.
    4. Find the perccli utility under the SAS RAID grouping.
    sas3flash

     

    sas3flash is the controller utility for LSI based HBA controllers. At the moment, sas3flash is available from the Broadcom Support Web Portal.. It might also be available from your server vendor. Check your server vendor support site first.

    1. Navigate to the web portal for support and driver download of the server vendor or controller maker.
    2. Enter the controller information, such as model, version, and so on.
      For example, on the Broadcom Support site, enter SAS 9305-24I and click Search.
    3. Download the sas3flash utility for your ESXi version.
      For example, on the Broadcom Support site, expand the Firmware section of the search result and find Installer_P14_for_Vmware_ESX50.
    ssacli

    ssacli is the controller utility for HP based controller. At the moment, ssacli is officially available from the HP Support Web Portal.

    1. Navigate to the HP Web Portal for Support and Driver Download.
    2. Search for the controller model.
      For example, enter Smart Array P420 and click Search.
    3. Select your ESXi version for Operating System.
      For example, VMware vSphere 6.5.
    4. Download the ssacli utility for your ESXi version.
      For example, on the HP Support site, expand the Software – System Management section of the search result and find HPE Smart Storage Administrator (HPE SSA) CLI for VMware vSphere 6.5 (American). Click this link to download ssacli-2.65.2.0-6.5.0.vib.

     
  2. Install the utility VIB by running the esxcli software vib install command.

    Note: You might need to adjust the host acceptance level to match the acceptance level for the VIB you want to install. For more information about installing individual VIBs and changing the acceptance level, see the vSphere Documentation for an appropriate version of your vSphere software.

  3. Verify that the utility was installed correctly by running one of the following commands:

    Utility Command
    storcli /opt/lsi/storcli/storcli show
    perccli /opt/lsi/perccli/perccli show
    sas3flash /opt/lsi/bin/sas3flash -list
    ssacli /opt/smartstorageadmin/ssacli/bin/ssacli

     

If after a successful installation, the utility does not run properly, verify that the utility version is correct and compatible with the controller and ESXi host. If the version is incompatible, uninstall the utility and then install the correct version.

For more information on collecting VMware vSAN logs, see How to collect vSAN support logs and upload to VMware by Broadcom.