lsvdiskhostmap

Use the lsvdiskhostmap command to list the hosts to which a volume is mapped.

Syntax

Read syntax diagramSkip visual syntax diagram lsvdiskhostmap vdisk_idvdisk_namevdisk_uid

Parameters

-delim delimiter
(Optional) Specify a delimiter to separate data in the output.
-nohdr
(Optional) Suppress the headings in the output.
vdisk_id | vdisk_name| vdisk_uid
Specifies the ID, name, or UID 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.

You can use only one I/O group (the group ID value is always 0).

Determining the hosts to which a volume is mapped:

To list the hosts that this volume is mapped to, issue 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 Mapping volumes to a host.
host_cluster_id
Indicates the unique ID for a host system.
host_cluster_name
Indicates the unique name for a host system.
When using the partition IP address to run this command, consider the following:
  • The user must identify objects using the name or UUID. Short IDs cannot be specified when using the partition IP address.
  • Views will be filtered to display only objects related to the partition associated with the IP address. An error will be displayed if the user requests a detailed view for an object that is not related to the partition.