Determining VMDK - SCSI controller and Target Mapping in ESXCLI for Delphix VMs (Masking, Reporting, or Virtualization) (KBA1123)
The majority of VMware administrative tasks are completed through vSphere desktop or web client. It is sometimes required to determine current device configuration via ESXCLI.
This document reviews the methodology for determining disk mapping using ESXCLI, for the purposes of Delphix troubleshooting. For example, determining the SCSI virtual controller and target ID configured for a given storage device, to correlate with what the VM has detected or configured.
The examples below references a Delphix Reporting VM (formerly known as Mission Control). Note that the process is identical for all Delphix platforms and versions released.
Example & Methodology
This example uses a virtual machine with the following configuration:
- 1x Delphix Reporting VM, with default OVA deployment (1 root disk)
- 2x additional SCSI disks added, 2GB and 3GB
To determine VMDK - SCSI controller and Target Mapping
- Determine the VM world ID using vim-cmd vmsvc/getallvms | grep <VM name>.
The left-most column provides the world ID.
For this example, look for VM named seanmc, which is indicated by world ID 33778.
[root@delong:~] vim-cmd vmsvc/getallvms | grep sean Skipping invalid VM '28866' Skipping invalid VM '32605' 33544 sean5220 [zfs_sean5220] dlpx-5.2.2.0-562-61155cf8/dlpx-5.2.2.0-562-61155cf8.vmx solaris10_64Guest vmx-08 Delphix Engine Version 5.2.2.0, VM Hardware Version 8 33778 seanmc [zfs_seanmc] delphix-reporting-1.4.2.0/delphix-reporting-1.4.2.0.vmx centos64Guest vmx-07
- With the relevant world ID, list all configured devices with vim-cmd vmsvc/device.getdevices <world id>.
The resulting output will be multiple pages long depending on the configuration and the sections of concern have the following headings:
vim.vm.device.VirtualLsiLogicController
vim.vm.device.VirtualDisk
As the titles suggest these sections of output provide the detail for each virtual SCSI controller and virtual disk respectively. The relevant information can be obtained from the output of vim-cmd for a more concise display using grep.
The following command details this (assuming world ID is retrieved in Step 1):
vim-cmd vmsvc/device.getdevices 33778 | egrep '(vim.vm.device.VirtualLsiLogicController|key|label|vim.vm.device.VirtualDisk|fileName|datastore|controllerKey|unitNumber|capacityInKB|uuid)'
Although additional device output beyond the SCSI controller and disk(s) will be returned, this will provide a summarized view of the current device mappings, extracted below:
...
(vim.vm.device.VirtualLsiLogicController) {
key = 1000,
label = "SCSI controller 0",
controllerKey = 100,
unitNumber = 3,
(vim.vm.device.VirtualLsiLogicController) {
key = 1001,
label = "SCSI controller 1",
controllerKey = 100,
unitNumber = 4,
key = 3002,
label = "CD/DVD drive 1",
controllerKey = 201,
unitNumber = 0
(vim.vm.device.VirtualDisk) {
key = 2000,
label = "Hard disk 1",
backing = (vim.vm.device.VirtualDisk.FlatVer2BackingInfo) {
fileName = "[zfs_seanmc] delphix-reporting-1.4.2.0/delphix-reporting-1.4.2.0.vmdk",
datastore = 'vim.Datastore:10.42.0.1:/dcenter/seanmc',
uuid = "6000C298-0c98-ea0a-0c86-565befc31fcd",
parent = (vim.vm.device.VirtualDisk.FlatVer2BackingInfo) null,
controllerKey = 1000,
unitNumber = 0,
capacityInKB = 52428800,
vFlashCacheConfigInfo = (vim.vm.device.VirtualDisk.VFlashCacheConfigInfo) null,
(vim.vm.device.VirtualDisk) {
key = 2016,
label = "Hard disk 2",
backing = (vim.vm.device.VirtualDisk.FlatVer2BackingInfo) {
fileName = "[zfs_seanmc] delphix-reporting-1.4.2.0/delphix-reporting-1.4.2.0_1.vmdk",
datastore = 'vim.Datastore:10.42.0.1:/dcenter/seanmc',
uuid = "6000C295-e11e-25b0-9add-590b91edad26",
parent = (vim.vm.device.VirtualDisk.FlatVer2BackingInfo) null,
controllerKey = 1001,
unitNumber = 0,
capacityInKB = 2097152,
vFlashCacheConfigInfo = (vim.vm.device.VirtualDisk.VFlashCacheConfigInfo) null,
(vim.vm.device.VirtualDisk) {
key = 2017,
label = "Hard disk 3",
backing = (vim.vm.device.VirtualDisk.FlatVer2BackingInfo) {
fileName = "[zfs_seanmc] delphix-reporting-1.4.2.0/delphix-reporting-1.4.2.0_2.vmdk",
datastore = 'vim.Datastore:10.42.0.1:/dcenter/seanmc',
uuid = "6000C295-5a4b-8904-2724-9fc58a011cbb",
parent = (vim.vm.device.VirtualDisk.FlatVer2BackingInfo) null,
controllerKey = 1001,
unitNumber = 1,
capacityInKB = 3145728,
...
- The above output determines:
- There are two configured SCSI controllers
- SCSI controller 0, with key 1000
- SCSI controller 1, with key 1001
- There are three virtual disk devices configured
- Virtual Disk "Hard disk 1", ~50GB in size, provisioned to SCSI controller 0 (key 1000), and unitNumber (target) 0
- Virtual Disk "Hard disk 2", ~2GB in size, provisioned to SCSI controller 1 (key 1001), and unitNumber (target) 0
- Virtual Disk "Hard disk 3", ~3GB in size, provisioned to SCSI controller 1 (key 1001), and unitNumber (target) 1
- The fileName parameter provides the relevant VMDK file location
Additional information can be determined if needed from the complete command output, but for this example the output captured is reduced to focus on controller and target numbers.