Examining LUNs with vicfg-scsidevs

You can use vicfg-scsidevs to display information about available LUNs on ESXi 4.x hosts.

Important: You can run vicfg-scsidevs --query and vicfg-scsidevs --vmfs against ESXi version 3.5. The other options are supported only against ESXi version 4.0 and later.

You can run one of the following commands to examine LUNs. Specify one of the connection options listed in Connection Options for vCLI Host Management Commands in place of <conn_options>.

List all logical devices known on this system with detailed information.

vicfg-scsidevs <conn_options> --list

The command lists device information for all logical devices on this system. The information includes the name (UUID), device type, display name, and multipathing plugin. Specify the --device option to only list information about a specific device. The following example shows output for two devices. The actual listing might include multiple devices and the precise format differs between releases.

mpx.vmhba2:C0:T1:L0
   Device Type: cdrom
   Size: 0 MB
   Display Name: Local HL-DT-ST (mpx.vmhba2:C0:T1:L0)
   Plugin: NMP
   Console Device: /vmfs/devices/cdrom/mpx.vmhba2:C0:T1:L0
   Devfs Path: /vmfs/devices/cdrom/mpx.vmhba2:C0:T1:L0
   Vendor: SONY Model: DVD-ROM GDRXX8XX Revis: 3.00
   SCSI Level: 5 Is Pseudo: Status:
   Is RDM Capable: Is Removable:
   Other Names:
      vml.000N000000XXXdXXXXXXXXaXXXaXX
      VAAI Status: nnnn
 
naa.60060...
   Device Type: disk
   Size: 614400 MB
   Display Name: DGC Fibre Channel Disk (naa.60060...)
   ...

List all logical devices with abbreviated information.
```
vicfg-scsidevs <conn_options> --compact-list
```
The information includes the device ID, device type, size, plugin, and device display name.
List all device unique identifiers.
```
vicfg-scsidevs <conn_options> --uids
```
The command lists the primary UID for each device, such as naa.xxx or other primary name, and any other UIDs for each UID (VML name). You can specify --device to only list information for a specific device.
List a specific logical device with its detailed information.
```
vicfg-scsidevs <conn_options> -l -d mpx.vmhba32:C0:T1:L0
```
Print mappings for VMFS volumes to the corresponding partition, path to that partition, VMFS uuid, extent number, and volume names.
```
vicfg-scsidevs <conn_options> --vmfs
```
Print HBA devices with identifying information.
```
vicfg-scsidevs <conn_options> --hbas
```
The return value includes the adapter ID, driver ID, adapter UID, PCI, vendor, and model.
Print a mapping between HBAs and the devices it provides paths to.
```
vicfg-scsidevs <conn_options> --hba-device-list
```