ESXCLI commands for VAAI operations

Products

• VMware vSphere ESXi
• VMware vSphere ESX 6.x
• VMware vSphere ESX 7.x
• VMware vSphere ESX 8.x

Issue/Introduction

Enabling/Disabling VAAI functions from the command line.

 

Environment

VMware vSphere ESXi Storage 7.0
VMware vSphere ESXi Storage 8.0

Resolution

1. ESXCLI commands for retrieving/setting support status for VAAI operations.

   1. esxcli storage core device vaai status
      Usage: esxcli storage core device vaai status {cmd} [cmd options]
      
      Available Commands:
      get - List VAAI properties for devices currently registered with the PSA.
      set - Enable/Disable VAAI operations on local SCSI disks. (NOTE: A request to enable an operation will take effect only if the underlying device supports the VAAI operation.)
      
      
   2. esxcli storage core device vaai status set --help
      Usage: esxcli storage core device vaai status set [cmd options]
      
      Description:
      set - Enable/Disable VAAI operations on local SCSI disks. (NOTE: A request to enable an operation will take effect only if the underlying device supports the VAAI operation.)
      
      cmd options:
      
      -A|--ats Enable or Disable ATS operation (1/0)
      -C|--clone Enable or Disable CLONE operation (1/0)
      -D|--delete Enable or Disable DELETE operation (1/0)
      -d|--device= <str></str>The device upon which to operate (NAA ID). (required)
      -Z|--zero Enable or Disable ZERO operation (1/0)
      
      
   3. esxcli storage core device vaai status get --help
      Usage: esxcli storage core device vaai status get [cmd options]
      
      Description:
      get - List VAAI properties for devices currently registered with the PSA.
      
      cmd options:
      
      -d|--device= <str></str>Filter the output of this command to only show a single device.
      
      
2. ESXCLI command to retrieve information on supported VAAI operations
   esxcli storage core device vaai status get -d <device></device>
   
   Example -
   [root@localhost:~] esxcli storage core device vaai status get -d naa.################
   naa.################
   VAAI Plugin Name:
   ATS Status: unsupported
   Clone Status: unsupported
   Zero Status: unsupported
   Delete Status: unsupported
   
   
3. ESXCLI command to set/change VAAI support.
   You can use the get request shown above to validate the settings.
   
   esxcli storage core device vaai status set -- <vaai operation=""></vaai>0/1 -d <device></device>
   
   Examples -
   # esxcli storage core device vaai status set --zero 1 -d naa.################
   
   # esxcli storage core device vaai status set --zero 0 -d naa.################
   
   # esxcli storage core device vaai status set --ats 1 --clone 1 --delete 1 -d naa.################