ESXCLI commands for VAAI operations
search cancel

ESXCLI commands for VAAI operations

book

Article ID: 334407

calendar_today

Updated On:

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.################