Use the lsvdiskhostmap command to list the hosts that a volume is
mapped to.
Syntax
lsvdiskhostmap [ -nohdr ] [ -delimdelimiter ] { vdisk_id | vdisk_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 no data exists 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 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 1-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.
- vdisk_id | vdisk_name
- (Required) Specifies the ID or name of the volume. The clustered system displays a list of
all the hosts to which this volume is mapped and the Small Computer System Interface (SCSI) ID
by which the volume is mapped.
Description
This command displays a list
of host IDs and names. These hosts specify a volume that is mapped to them; that is, the volume
is visible to these hosts. The SCSI LUN ID is also displayed. The SCSI LUN ID is the ID by which
the volume is recognized by the host.
Determining the host that a volume is
mapped to: List the hosts that this volume is mapped to, by issuing the following command:
lsvdiskhostmap vdisk_id | vdisk_name
where
vdisk_id | vdisk_name is the name or ID of the volume. A list is
displayed. Look for the host name or ID to determine which host this volume is mapped to. If no
data is displayed, the volume is not mapped to any hosts.
The command returns the
following values:
- id
- Specifies the ID of the volume in the output for lsvdiskhostmap.
- name
- Specifies the name of the volume in the output for lsvdiskhostmap.
- SCSI_id
- Specifies the SCSI ID.
- host_id
- Specifies the ID of the host.
- host_name
- Specifies the name of the host.
- vdisk_UID
- Specifies the UID of the volume.
- IO_group_id
- Specifies the ID of the input/output (I/O) group in which the host volume mapping
exists.
- IO_group_name
- Specifies the name of I/O group in which the host volume mapping exists.
- mapping_type
- Indicates the mapping type for a host system. Values are private or
shared. For more information about mapping, see Host mapping.
- host_cluster_id
- Indicates the unique ID for a host system.
- host_cluster_name
- Indicates the unique name for a host system.
- protocol
- Indicates the protocol that is used by the hosts mapping this volume. The values are
scsi or nvme.
An invocation example
lsvdiskhostmap vdisk3
The resulting output:
id name SCSI_id host_id host_name vdisk_UID IO_group_id IO_group_name mapping_type host_cluster_id host_cluster_name
3 vdisk3 3 0 server8 6005076400B10001A000000000000003 0 io_grp0 shared 0 dbcluster
3 vdisk3 3 1 server9 6005076400B10001A000000000000003 0 io_grp0 shared 0 dbcluster