lshostvdiskmap

The lshostvdiskmap command displays a list of VDisks that are mapped to a given host. These are the VDisks that are recognized by the specified host.

Syntax


>>- svcinfo -- -- lshostvdiskmap -- --+----------+-- ----------->
                                      '- -nohdr -'      

>--+-----------------------+-- --+-------------+---------------><
   '- -delim -- delimiter -'     +- host_id ---+   
                                 '- host_name -'

Parameters

-nohdr: (Optional) By default, headings are displayed for each column of data in a concise style view, and for each item of data in a detailed style view. The -nohdr parameter suppresses the display of these headings.
Note: If there is no data to be displayed, headings are not displayed.
-delim delimiter: (Optional) By default in a concise view, all columns of data are space-separated. The width of each column is set to the maximum possible width of each item of data. In a detailed view, each item of data has its own row, and if the headers are displayed, the data is separated from the header by a space. The -delim parameter overrides this behavior. Valid input for the -delim parameter is a one-byte character. If you enter -delim : on the command line, the colon character (:) separates all items of data in a concise view; for example, the spacing of columns does not occur. In a detailed view, the data is separated from its header by the specified delimiter.
host_id | host_name: (Optional) Specifies the host in terms of its ID or name. The command displays a list of all the virtual disks that are mapped to the specified host and the SCSI ID by which they are mapped. If neither a host ID or name are entered, the command displays a list of all recognized host-to-VDisk mappings.

Description

This command displays a list of VDisk IDs and names. These are the VDisks that have been mapped to the specified host; that is, they are visible to the specified host. The SCSI LUN ID is also displayed. This SCSI LUN ID is the ID by which the VDisk is recognized by the host.

Each VDisk that is exported by the cluster is assigned a unique vpath number. This number identifies the VDisk and determines which VDisk corresponds to the volume that the hosts recognize. This procedure can only be performed using the command-line interface.

For the specified volume, find the vpath serial number by issuing the datapath query device command. Find the host that is defined to the cluster that corresponds with the host that you are working with.

The WWPNs are an attribute of the HBA. You can find these by looking at the device definitions stored by your operating system. For example, on AIX® they are in the ODM, in Windows® they are in the Device Manager details for the given HBA.
Verify which host is defined to the cluster that these ports belong to. The ports are stored as part of the detailed view, so you must list each host in turn by issuing the following command:
svcinfo lshost host_name | host_id
where host_name | host_id is the name or ID of the host. Check for matching WWPNs.
Note: Name your hosts accordingly. For example, if the actual host is called orange, also name the host that is defined to the cluster orange.

When you have the hostname defined to the cluster and the vpath serial number, issue the following command:

svcinfo lshostvdiskmap hostname

where hostname is the name of the host. A list is displayed. Look for the VDisk UID that matches the vpath serial number and record the VDisk name or ID.

An invocation example

svcinfo lshostvdiskmap -delim : 2

The resulting output

id:name:SCSI_id:vdisk_id:vdisk_name:vdisk_UID
2:host2:0:10:vdisk10:6005076801958001500000000000000A
2:host2:1:11:vdisk11:6005076801958001500000000000000B
2:host2:2:12:vdisk12:6005076801958001500000000000000C
2:host2:3:13:vdisk13:6005076801958001500000000000000D
2:host2:4:14:vdisk14:6005076801958001500000000000000E