mkhost
使用 mkhost 命令可创建逻辑主机对象。
语法
参数
- -name new_name
- (可选)指定新主机对象的名称或标签。
- -protocol scsi | nvme
- (可选)指定主机与存储系统通信所使用的协议。缺省值为 scsi。
- -saswwpn wwpn_list
- (在不使用 -iscsiname、-fcwwpn 或 -nqn 的情况下为必需。)指定串行连接 SCSI (SAS) WWPN(16 个字符的十六进制字符串)的列表。
- -fcwwpn wwpn_list
- (在不使用 -saswwpn、-iscsiname 或 -nqn 的情况下为必需。)指定光纤通道 (FC) WWPN(采用 16 字符的十六进制字符串)的列表。
- -iscsiname iscsi_name_list
- (在不使用 -fcwwpn、-saswwpn 或 -nqn 的情况下为必需。)指定要添加到主机的 iSCSI 名称的逗号分隔列表。必须至少指定一个 WWPN 或 iSCSI 名称。不能将该参数与 -fcwwpn 或 -saswwpn 参数一起使用。
- -nqn nqn_list
- (在不使用 -fcwwpn、-saswwpn 或 -iscsiname 的情况下为必需。)指定要添加到主机的 NVMe 限定名 (NQN) 的逗号分隔列表。主机协议必须为 nvme 才能使用此参数。
- -iogrp iogrp_list
- (可选)指定主机能够访问其中卷的一个或多个输入/输出 (I/O) 组的集合。使用名称或标识(以冒号隔开)指定多个 I/O 组。可以在列表中混用名称和标识。如果未指定此参数,那么主机将与所有 I/O 组关联。
- -mask port_login_mask
- (可选)指定主机可访问的节点目标端口和主机的光纤通道 (FC) 端口掩码。主机对象中的全球端口名 (WWPN) 必须从掩码中包含的节点端口访问卷,并且位于主机对象 I/O 组中。端口掩码是 64 个二进制位,由 0 和 1 组合而成,其中
0表示不使用对应的 FC I/O 端口,1表示使用对应的 FC I/O 端口。掩码中最右侧的位对应于 FC I/O 端口 1。有效掩码值范围从0000(未启用任何端口)到1111111111111111111111111111111111111111111111111111111111111111(启用所有端口)。例如,掩码111111101101启用端口 1、3、4、6、7、8、9、10、11 和 12。 - -force
- (可选)指定在不验证 WWPN 的情况下创建逻辑主机对象。
- -type hpux | tpgs | generic | openvms | adminlun | hide_secondary
- (可选)指定主机类型。缺省值为 generic。adminlun 主机类型等同于管理 GUI 中的 VVOL 主机类型。
- -hostcluster host_cluster_id | host_cluster_name
- (可选)指定在其中创建新主机对象的主机集群标识(数字值)或名称(字母数字值)。
- -ownershipgroup owner_id | owner_name
- (可选)对象添加到的所有权组的名称或标识。
描述
mkhost 命令用于将一个或多个 HBA WWPN、iSCSI 名称或 NQN 与逻辑主机对象关联起来。该命令会创建一个新的主机。当命令完成时会显示标识。 随后,您可以在通过使用 mkvdiskhostmap 命令将卷映射到主机时,使用该对象。如果通过指定 -hostcluster 在主机集群内直接创建主机,那么它会继承任何现有的共享映射。
仅当 protocol 为 nvme 时,才能添加 NQN。仅当主机 protocol 为 scsi 时,才能添加所有其他端口类型。不支持双协议主机。不能将主机添加到具有与主机不同的协议的主机集群。NVMe 主机必须将 type 设置为 default。
请只发出 mkhost 命令一次。集群系统会扫描主机区域中 WWPN 的光纤网。系统本身无法过滤到主机以决定哪些 WWPN 位于哪些主机中。因此,您必须使用 mkhost 命令来识别主机。
识别主机后,将在主机和卷之间创建映射。这些映射有效地将卷提供给它们映射到的主机。主机对象中的所有 WWPN 都将映射到卷。
某些 HBA 设备驱动程序在识别目标逻辑单元号 (LUN) 之后才能登录到光纤网。由于它们无法登录,因此就无法将它们的 WWPN 识别为候选端口。您可以使用此命令指定 force 参数以停止验证 WWPN 列表。
如果将主机添加到与超出系统限制的主机端口或主机对象关联的 I/O 组,该命令将失败。
要了解更多信息,请参阅 mkvdiskhostmap、lssasportcandidate 和 lsfcportcandidate 命令。
有关特定主机的参数需求的更多信息,请访问以下支持站点:http://www-03.ibm.com/systems/support/storage/ssic/interoperability.wss。
调用示例
mkhost -name hostone -saswwpn 210100E08B251DD4:210100F08C262DD8 -force -mask 111111101101
生成的输出:
Host id [1] successfully created
调用示例
mkhost -iscsiname iqn.localhost.hostid.7f000001 -name newhost生成的输出:
Host, id [10], successfully created
调用示例
mkhost -fcwwpn 210100E08B251EE6:210100F08C262EE7 -type openvms
生成的输出:
Host, id [1], successfully created
调用示例
mkhost -fcwwpn 210100E08B251EE6 -site site1生成的输出:
Host, id [1], successfully created
调用示例
mkhost -nqn nqn.2014-08.org.nvmexpress:NVMf:uuid:644f51bf-8432-4f59-bb13-5ada20c06397 -protocol nvme
生成的输出:
Host, id [1], successfully created
