You can list path information with ESXCLI or with vicfg-mpath.

Listing Path Information with ESXCLI

You can run esxcli storage core path to display information about Fibre Channel or iSCSI LUNs.

Important: Use industry-standard device names, with format eui.xxx or naa.xxx to ensure consistency. Do not use VML LUN names unless device names are not available.

Names of virtual machine HBAs are not guaranteed to be valid across reboots.

You can display information about paths by running esxcli storage core path. Specify one of the options listed in Connection Options for vCLI Host Management Commands in place of <conn_options>.

  • List all devices with their corresponding paths, state of the path, adapter type, and other information.
    esxcli <conn_options> storage core path list
  • Limit the display to only a specified path or device.
    esxcli <conn_options> storage core path list --path <path>
    esxcli <conn_options> storage core path list --device <device>
  • List the statistics for the SCSI paths in the system. You can list all paths or limit the display to a specific path.
    esxcli <conn_options> storage core path stats get
    esxcli <conn_options> storage core path stats get --path <path>
  • List detailed information for the paths for the device specified with --device.
    esxcli <conn_options> storage core path list -d <naa.xxxxxx>
  • List all adapters.
    esxcli <conn_options> storage core adapter list
  • Rescan all adapters.
    esxcli <conn_options> storage core adapter rescan

Listing Path Information with vicfg-mpath

You can run vicfg-mpath to list information about Fibre Channel or iSCSI LUNs.

Important: Use industry-standard device names, with format eui.xxx or naa.xxx to ensure consistency. Do not use VML LUN names unless device names are not available.

Names of virtual machine HBAs are not guaranteed to be valid across reboots.

You can display information about paths by running vicfg-mpath with one of the following options. Specify one of the options listed in Connection Options for vCLI Host Management Commands in place of <conn_options>.

  • List all devices with their corresponding paths, state of the path, adapter type, and other information.
    vicfg-mpath <conn_options> --list-paths
  • Display a short listing of all paths.
    vicfg-mpath <conn_options> --list-compact
  • List all paths with adapter and device mappings.
    vicfg-mpath <conn_options> --list-map
  • List paths and detailed information by specifying the path UID (long path). The path UID is the first item in the vicfg-mpath --list display.
    vicfg-mpath <conn_options> --list
       -P sas.5001c231c79c4a00-sas.1221000001000000-naa.5000c5000289c61b
  • List paths and detailed information by specifying the path runtime name.
    vicfg-mpath <conn_options> -l -P vmhba32:C0:T0:L0
    The return information includes the runtime name, device, device display name, adapter, adapter identifier, target identifier, plugin, state, transport, and adapter and target transport details.
  • List detailed information for the paths for the device specified with --device.
    vicfg-mpath <conn_options> -l -d mpx.vmhba32:C0:T1:L0
    vicfg-mpath <conn_options> --list --device naa.60060...