http://kb.vmware.com/selfservice/microsites/search.do?language=en_US&cmd=displayKC&externalId=1033665
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.
For information on VAAI support in a given storage array or required firmware levels, contact the storage array vendor.
Resolution
To disable VAAI in ESXi/ESX, you must modify these advanced configuration settings:
When a VMFS-5 volume is formatted on a VAAI capable device, it uses ATS locking, which is termed as
The output appears similar to:
Note: Ensure that the vSphere CLI (vCLI) is installed and is able to connect to the ESXi/ESX hosts. For more information, see the vSphere Command-Line Interface Installation and Scripting Guide.
To disable VAAI using the PowerCLI:
HardwareAcceleratedMove
HardwareAcceleratedInit
HardwareAcceleratedLocking
When a VMFS-5 volume is formatted on a VAAI capable device, it uses ATS locking, which is termed as
ATS-only
. To check if a VMFS volume has been configured with VAAI ATS-only
, use this command:# vmkfstools -Ph -v1 /vmfs/volumes/VMFS-volume-name
The output appears similar to:
VMFS-5.54 file system spanning 1 partitions.
File system label (if any): ats-test-1
Mode: public ATS-only
Disabling VAAI using the vSphere Client
To disable VAAI using the vSphere Client:- Open the VMware vSphere Client.
- In the Inventory pane, select the ESXi/ESX host.
- Click the Configuration tab.
- Under Software, click Advanced Settings.
- Click DataMover.
- Change the
DataMover.HardwareAcceleratedMove
setting to0
. - Change the
DataMover.HardwareAcceleratedInit
setting to0
. - Click VMFS3.
- Change the
VMFS3.HardwareAcceleratedLocking
setting to0
. - Click OK to save your changes.
- Repeat this process for the all ESXi/ESX hosts connected to the storage.
Disabling VAAI using vSphere CLI or PowerCLI
To disable VAAI using the vSphere CLI:Note: Ensure that the vSphere CLI (vCLI) is installed and is able to connect to the ESXi/ESX hosts. For more information, see the vSphere Command-Line Interface Installation and Scripting Guide.
- Run these
vicfg-advcfg
commands to change the three settings:vicfg-advcfg connection_options -s 0 /DataMover/HardwareAcceleratedMove
vicfg-advcfg connection_options -s 0 /DataMover/HardwareAcceleratedInit
vicfg-advcfg connection_options -s 0 /VMFS3/HardwareAcceleratedLocking
Note: For more information and examples on using vCLI connection options, see the Common Options for vCLI Execution section of the vSphere Command-Line Interface Installation and Scripting Guide. - Repeat this process for all the ESXi/ESX hosts connected to the storage as no reboot is required. For a production environment, ensure that you plan accordingly.
To disable VAAI using the PowerCLI:
- Run the command:
Set-VMHostAdvancedConfiguration -VMHost Hostname -Name OptionName -Value 0
WhereOptionName
is one of:
DataMover.HardwareAcceleratedMove
DataMover.HardwareAcceleratedInit
VMFS3.HardwareAcceleratedLocking
For example:Set-VMHostAdvancedConfiguration -VMHost (Get-VMHost ($Hosts.SelectedItem)) -Name DataMover.HardwareAcceleratedMove -Value 0
Set-VMHostAdvancedConfiguration -VMHost (Get-VMHost ($Hosts.SelectedItem)) -Name DataMover.HardwareAcceleratedInit -Value 0
Set-VMHostAdvancedConfiguration -VMHost (Get-VMHost ($Hosts.SelectedItem)) -Name VMFS3.HardwareAcceleratedLocking -Value 0
Disabling VAAI using an ESXi/ESX console connection
To disable VAAI using an ESXi/ESX console connection:- Open a console to the ESXi/ESX host. For more information, see:
- Unable to connect to an ESX host using Secure Shell (SSH) (1003807)
- Using Tech Support Mode in ESXi 4.1 and ESXi 5.x (1017910)
- Using ESXi Shell in ESXi 5.x (2004746)
- Disabling the VAAI Thin Provisioning UNMAP in ESXi 5.x (KB 2007427)
Note: ESXi 5.0 issues UNMAP commands for Space Reclamation in critical regions during several operations with the expectation that the operation will complete quickly. Due to varied response times from the storage devices, the UNMAP command can result in poor performance of the system and should be disabled on the ESXi 5.0 host. For more information, see Disabling VAAI Thin Provisioning Block Space Reclamation (UNMAP) in ESXi 5.0 (2007427).
- Log in as root.
- On ESXi 5.x hosts, run these
esxcli
commands to change the three settings:# esxcli system settings advanced set --int-value 0 --option /DataMover/HardwareAcceleratedMove
# esxcli system settings advanced set --int-value 0 --option /DataMover/HardwareAcceleratedInit
# esxcli system settings advanced set --int-value 0 --option /VMFS3/HardwareAcceleratedLocking
On ESXi/ESX 4.1 hosts, run theseesxcfg-advcfg
commands to change the three settings:# esxcfg-advcfg -s 0 /DataMover/HardwareAcceleratedMove
# esxcfg-advcfg -s 0 /DataMover/HardwareAcceleratedInit
# esxcfg-advcfg -s 0 /VMFS3/HardwareAcceleratedLocking
- Repeat this process for all the ESXi/ESX hosts connected to the storage.
Note: The changes will be active after running the above commands; a reboot of the host is not required. - If you must disable VAAI for a specific storage type, use the
esxcli
command to delete the existing hardware acceleration claim rules as documented on pages 176-177 of the vSphere 5 Storage guide.
Verifying the current configuration values
To check the current value of the configuration settings:HardwareAcceleratedMove
HardwareAcceleratedInit
HardwareAcceleratedLocking
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
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.
To revert this configuration and to enable vStorage APIs for Array Integration functionality, change each of these settings from 0 to 1.
To be alerted when this article is updated, click Subscribe to Document in the Actions box.
全站熱搜
留言列表