lshostvdiskmap

Use the lshostvdiskmap command to display a list of volumes that are mapped to a host. These volumes are the volumes that are recognized by the specified host.

Syntax

Parameters

-delim delimiter: (Optional) Specify a delimiter to separate data in the output.
-nohdr: (Optional) Suppress the headings in the output.

host_id | host_name| host_uuid: (Optional) Specifies the host in terms of its ID or name or UUID. The command displays a list of all the volumes that are mapped to the specified host and the Small Computer System Interface (SCSI) ID by which they are mapped. If you do not specify a host ID or name , the command displays a list of all recognized volume mappings.

Description

This command displays a list of volume IDs and names. These volumes are the volumes that are mapped to the specified host; that is, they are visible to the specified host. The SCSI_id is also displayed. This SCSI_id is the Logical Unit Number (LUN) by which the volume is recognized by the host in the Host, Bus, Target, LUN scheme. The SCSI_id or LUN is used for determining the path of the volume, but the volume carries an EUI-64 identifier that is tagged as the vdisk_UID.

Shared mappings, or volumes that are mapped to a host cluster visible by the lshostclustervolumemap command, are still listed in the output of lshostvdiskmap with shared as mapping_type. Shared mappings have a consistent SCSI_id across all host mappings of the same Host Cluster. To limit the number of paths, a physical host might have multiple host-objects that are defined as a subset of host ports. If you do not follow the best practices or inadvertently map the same volume to multiple sub-host objects, operating software of the host might see the same vdisk_UID with multiple paths that cover different SCSI_ids. This is functional still for some operating software, but must be avoided.

For a specific volume based on which operating system and multipath software are used, you can use different commands to determine the volume serial number, or Volume Unique Identifier (vdisk_UID). For example, in AIX with AIXPCM, lsmpio -ql hdisk finds the Volume Serial Number for volumes that are mapped to that operating software.

Find the host that is defined to the system that corresponds with the host that you are working with.

The worldwide port names (WWPNs) are an attribute of the host bus adapter (HBA). You can find the WWPNs by looking at the device definitions that are stored by your operating system. For example, on AIX® they are in the Object Data Manager (ODM), in Windows® they are in the Device Manager details for the specified HBA.
Verify which host is defined to the system 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:
lshost host_name | host_id
where host_name | host_id is the name or ID of the host. Check for matching WWPNs.
Note: Consider this when you name your hosts. For example, if the actual host is called orange, also name the host that is defined to the system orange.

The command returns the following values:

id: Indicates the host ID in the output for lshostvdiskmap.
name: Indicates the host name in the output for lshostvdiskmap.
SCSI_id: Specifies the SCSI ID for SCSI mappings. This field is blank for NVMe mappings.
vdisk_id: Specifies the UID of the volume or the NVMe namespace GUID.
vdisk_name: Indicates the name of the volume.
vdisk_UID: Indicates the UID of the volume.
IO_group_id: Indicates 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.

protocol: Indicates the protocol that is used by the hosts mapping this volume. The values are scsi or nvme.

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.