mkvdiskhostmap

使用 mkvdiskhostmap 命令在卷和主机之间创建新映射，这使得对指定主机的输入/输出 (I/O) 操作能够访问卷。

语法

参数

-force: （可选）允许多个卷到主机分配，通常这是不允许的。
-host host_id | host_name: （必需）通过标识或名称指定要将卷映射到的主机。
-scsi scsi_num_arg: （可选）指定要在给定主机上分配给该卷的小型计算机系统接口 (SCSI) 逻辑单元号 LUN 标识。scsi_num_arg 参数包含一个 SCSI LUN 标识，该标识被分配给提供卷访问权的所有 I/O 组的给定主机上的卷。您必须检查您的主机系统，以查看给定主机总线适配器 (HBA) 上的下一个可用的 SCSI LUN 标识。如果不指定 -scsi 参数，那么将为主机提供用于提供访问的每个 I/O 组中下一个可用 SCSI LUN 标识。NVMe 主机不支持 -scsi 参数。在将卷映射到使用 NVMe 协议的主机时，系统会分配卷名称空间标识 (NSID)。此参数与 -allowmismatchedscsiids 互斥。
-allowmismatchedscsiids: （可选）在创建新的主机映射时，此参数允许系统在访问 I/O 组中为卷分配不同的 SCSI LUN 标识。此参数与 -scsi 互斥。
vdisk_name | vdisk_id: （必需）按标识或名称指定要映射至主机的卷的名称。

描述

该命令在卷和指定的主机之间创建新映射。这样会将卷提供给主机，就像磁盘直接连接到主机一样。只有在处理该命令之后，主机才能执行到卷的 I/O 事务。

（可选）可以为 SCSI 主机映射分配一个 SCSI LUN 标识。当主机中的 HBA 扫描已与它连接的设备时，它将发现映射到其光纤通道端口的所有卷。当找到设备时，会向每个设备分配一个标识（SCSI LUN 标识）。例如，找到的第一个磁盘通常是 SCSI LUN 0，以此类推。您可通过根据需要分配 SCSI LUN 标识来控制 HBA 发现卷的顺序。如果您不指定 SCSI LUN 标识，那么集群会自动分配下一个可用的 SCSI LUN 标识，前提是在该主机中已存在任何映射。发出 mkvdiskhostmap 命令时，会返回分配的 SCSI LUN 标识号。

对于 NVMe，SCSI LUN 标识不相关，而系统会分配无法更改的 NSID。在创建到 NVMe 卷的映射时，会返回 NSID（NSID 是 vdisk_ID + 1)。

在以下情况下，mkvdiskhostmap 命令将失败：

作为该映射目标的主机没有与卷访问集中的任何 I/O 组关联
卷在自己的访问集中包含不止一个 I/O 组，并且映射到该卷的主机不支持从多个 I/O 组映射卷
主机协议与卷协议不兼容
卷具有多个访问 IO 组，主机协议为 NVMe
相同的 SCSI LUN 标识并非在所有访问 I/O 组中都不可用

如果未指定 SCSI LUN 标识，那么系统会尝试分配所有访问 I/O 组中最小的通用 SCSI LUN 标识。返回的标识对于将卷映射到的所有 I/O 组均相同。

使用 -allowmismatchedscsiids 参数可允许系统在访问 I/O 组中分配不同的 SCSI LUN 标识。将使用每个访问 I/O 组中可用的最小值。在所有访问 I/O 组中，此值可能会不同。确保主机支持此配置。此参数不能与 -scsi 参数一起使用，并且不受 NVMe 主机支持。如果将卷映射到使用 NVMe 协议的主机，那么系统会分配卷名称空间标识 (NSID)。

切记： iSCSI 主机可以访问通过多个 I/O 组（以及单个 I/O 组）可访问的卷。

如果您生成其他 SCSI LUN 标识，那么仅返回一个标识。返回的标识是卷映射到的编号最高的 I/O 组的标识。要查看其他值，请发出 lshostvdiskmap 或 lsvdiskhostmap。

该 SCSI LUN 标识用于卷映射到的编号最高的 I/O 组。

某些 HBA 设备驱动程序发现 SCSI LUN 标识不连续时，将会停止。例如：

卷 1 映射到 SCSI LUN 标识为 1 的主机 1
卷 2 映射到 SCSI LUN 标识为 2 的主机 1
卷 3 映射到 SCSI LUN 标识为 4 的主机 1

当设备驱动程序扫描 HBA 时，在识别卷 1 和 2 以后就必须停止，因为没有 SCSI LUN 映射到标识 3。为了获得最佳性能，请确保 SCSI LUN 标识分配的连续性。

您可以创建多个卷分配（例如，将同一个卷分配给多个主机，这在集群系统主机将一个卷分配给多个主机时尤其有用）。通常，不会使用多个卷到主机分配，原因是如果多个主机可访问磁盘，那么可能发生损坏。但是，在某些多路径环境中，一个卷必须映射到多个主机。这包括 IBM® SAN File System。要映射至一个以上的主机，必须使用带有 -force 参数的 mkvdiskhostmap 命令。例如：mkvdiskhostmap -host host1 -force 4 mkvdiskhostmap -host host2 -force 4。

注：在将相同卷分配给多个主机时，请对所有主机使用相同的 SCSI 标识。

这些命令为卷 4 创建两个主机到卷的映射，以映射至 host1 和 host2。如果该卷已映射至主机，那么省略 -force 参数会导致映射失败。

如果主机对象（构成了该映射）未与包含卷的 I/O 组关联，那么该命令也会失败。

如果在主机（类型 hide_secondary）和卷（远程拷贝关系中的辅助卷）之间创建新的映射：

出于配置目的创建映射（可以对其进行更改或将其删除）
辅助卷不会提供给主机

在以下情况下将映射的卷提供给主机：

主机类型更改为 hide_secondary 之外的其他类型
远程拷贝关系通过指定 -access 来停止
卷不再是辅助卷，因为远程拷贝关系已删除或切换

注：如果卷是主动/主动关系中的辅助卷或任何类型关系中的变更卷，那么将无法指定该命令。

切记：该命令不能用于文件系统所拥有的卷。

注：由于 NVMe 规范中存在限制，无法将 HyperSwap® 卷和具有多个访问 I/O 组的卷映射到 NVMe 主机。

调用示例

mkvdiskhostmap -host host1 -scsi 1 5

生成的输出：

Virtual Disk to Host map, id [1], successfully created