使用 mkvdiskhostmap 命令在卷和主机之间创建新映射，这使得对指定主机的输入/输出 (I/O) 操作能够访问卷。
语法
mkvdiskhostmap [ -force ] -host { host_id | host_name } [ -scsiscsi_num_arg ] { vdisk_name | vdisk_id }
参数
- -force
- （可选）允许多个卷到主机分配，通常这是不允许的。
- -hosthost_id | host_name
- （必需）通过标识或名称指定要将卷映射到的主机。
- -scsiscsi_num_arg
- （可选）指定要在给定主机上分配给该卷的小型计算机系统接口 (SCSI) 逻辑单元号 LUN 标识。 scsi_num_arg 参数包含一个 SCSI LUN 标识，该标识被分配给提供卷访问权的所有 I/O 组的给定主机上的卷。 您必须检查您的主机系统，以查看给定主机总线适配器 (HBA) 上的下一个可用的 SCSI LUN 标识。 如果不指定 -scsi 参数，那么将为主机提供用于提供访问的每个 I/O 组中下一个可用 SCSI LUN 标识。NVMe 主机不支持 -scsi 参数。在将卷映射到使用 NVMe 协议的主机时，系统会分配卷名称空间标识 (NSID)。
- 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
Remember: 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。
Note: 在将同一个卷分配到多个主机时，应将同一个 SCSI 标识用于
所有主机。
这些命令为卷 4 创建两个主机到卷的映射，以映射至 host1 和 host2。 如果该卷已映射至主机，那么省略 -force 参数会导致映射失败。
如果主机对象（构成了该映射）未与包含卷的 I/O 组关联，那么该命令也会失败。
如果在主机（类型
hide_secondary）和卷（远程拷贝关系中的辅助卷）之间创建新的映射：
- 出于配置目的创建映射（可以对其进行更改或将其删除）
- 辅助卷不会提供给主机
在以下情况下将映射的卷提供给主机：
- 主机类型更改为 hide_secondary 之外的其他类型
- 远程拷贝关系通过指定 -access 来停止
- 卷不再是辅助卷，因为远程拷贝关系已删除或切换
Note: 如果卷是主动/主动关系中的辅助卷或任何类型关系中的变更卷，那么将无法指定该命令。
Remember: 该命令不能用于文件系统所拥有的卷。
Note: 由于 NVMe 规范中存在限制，无法将 HyperSwap 卷和具有多个访问 I/O 组的卷映射到 NVMe 主机。
调用示例
mkvdiskhostmap -host host1 -scsi 1 5
生成的输出：
Virtual Disk to Host map, id [1], successfully created