Search the VMware Knowledge Base (KB)
Products:
View by Article ID

Disabling the VAAI functionality in ESXi/ESX (1033665)

  • 55 Ratings
Language Editions

Purpose

This article provides steps to disable the vStorage APIs for Array Integration (VAAI) functionality in ESXi/ESX. You may want to disable VAAI if the storage array devices in the environment do not support the hardware acceleration functionality or are not responding correctly to VAAI primitives.

For information on VAAI support in a given storage array or required firmware levels, contact the storage array vendor.

Resolution

Note: If you are running a VMware vSAN environment, it is important that Hardware Assisted Locking (ATS) is not disabled.
 
To disable VAAI in ESXi/ESX, you must modify these advanced configuration settings:
  • HardwareAcceleratedMove
  • HardwareAcceleratedInit
  • HardwareAcceleratedLocking
To check the current value of the configuration settings:

Note: Replace OptionName with one of the configuration setting names.

  • Using the vSphere CLI:

    vicfg-advcfg connection_options -get OptionName

  • Using the PowerCLI:

    Get-VMHostAdvancedConfiguration -VMHost Hostname -Name OptionName

  • Using SSH/DCUI:

    # esxcfg-advcfg --get OptionName

    or

    # esxcli system settings advanced list --option OptionName

    For example: # esxcli system settings advanced list --option=/VMFS3/HardwareAcceleratedLocking
    #
    esxcli system settings advanced list --option=/DataMover/HardwareAcceleratedMove
    # esxcli system settings advanced list --option=/DataMover/HardwareAcceleratedInit

Impact/Risks

Note: Disabling the ATS (atomic test and set) parameter has the potential to cause data unavailability in ESXi 5.5 for volumes that were create as VMFS5 natively. Those volumes only support the use of ATS locking. Anything that is VMFS3 or upgrade from VMFS3 to VMFS5 should be fine. The other option would be to upgrade the ESXi host to version 6.x where we have added functionality to set the lock mode on native VMFS5 volumes that allows the old SCSI reservation method to function.

Additional Information

For more information, see the Turn off Hardware Acceleration section of the ESX Configuration Guide.

To revert this configuration and to enable vStorage APIs for Array Integration functionality, change each of these settings from 0 to 1.

For more information about locking mechanisms, see:
To be alerted when this article is updated, click Subscribe to Document in the Actions box. 

Tags

disable-vaai

See Also

This Article Replaces

2012967

Update History

08/30/2013 - Removed Note: You cannot disable or re-enable ATS-only on a VMFS-5 datastore which has been upgraded from VMFS-3. as it is incorrect. 01/13/2012 - Added ESXi 5.0 commands in the Disabling VAAI using an ESX/ESXi console connection section 07/25/2012 - Updated HardwareAcceleratedLocking PowerCLI command

Request a Product Feature

To request a new product feature or to provide feedback on a VMware product, please visit the Request a Product Feature page.

Feedback

  • 55 Ratings

Did this article help you?
This article resolved my issue.
This article did not resolve my issue.
This article helped but additional information was required to resolve my issue.

What can we do to improve this information? (4000 or fewer characters)




Please enter the Captcha code before clicking Submit.
  • 55 Ratings
Actions
KB: