mkhost

使用 mkhost 命令可创建逻辑主机对象。

语法

mkhost [ -namenew_name ] [ -protocol { scsi | nvme } ] { -saswwpnwwpn_list | -fcwwpnwwpn_list | -iscsinameiscsi_name_list | -nqnnqn_list } [ -iogrp iogrp_list ] [ -mask port_login_mask ] [ -force ] [ -type { hpux | tpgs | generic | openvms | adminlun | hide_secondary } ] { [ -site { site_name | site_id } -hostcluster { host_cluster_id | host_cluster_name } ] }

参数

-namenew_name
(可选)指定新主机对象的名称或标签。
-protocolscsi|nvme
(可选)指定主机与存储系统通信所使用的协议。缺省值为 scsi
-saswwpnwwpn_list
(在不使用 -iscsiname-fcwwpn-nqn 的情况下为必需。)指定串行连接 SCSI (SAS) WWPN(采用 16 个字符的十六进制字符串)的列表。
-fcwwpnwwpn_list
(在不使用 -saswwpn-iscsiname-nqn 的情况下为必需。)指定光纤通道 (FC) WWPN(采用 16 字符的十六进制字符串)的列表。
-iscsinameiscsi_name_list
(在不使用 -fcwwpn-saswwpn-nqn 的情况下为必需。)指定要添加到主机的 iSCSI 名称的逗号分隔列表。必须至少指定一个 WWPN 或 iSCSI 名称。 不能将该参数与 -fcwwpn-saswwpn 参数一起使用。
-nqnnqn_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 的情况下创建逻辑主机对象。
-typehpux |tpgs|generic|openvms|adminlun|hide_secondary
(可选)指定主机类型。 缺省值为 genericadminlun 主机类型等同于管理 GUI 中的 VVOL 主机类型。
-hostclusterhost_cluster_id | host_cluster_name
(可选)指定在其中创建新主机对象的主机集群标识(数字值)或名称(字母数字值)。

描述

mkhost 命令用于将一个或多个 HBA WWPN、iSCSI 名称或 NQN 与逻辑主机对象关联起来。该命令会创建一个新的主机。 当命令完成时会显示标识。 随后,您可以在通过使用 mkvdiskhostmap 命令将卷映射到主机时,使用该对象。 如果通过指定 -hostcluster 在主机集群内直接创建主机,那么它会继承任何现有的共享映射。

仅当 protocolnvme 时,才能添加 NQN。仅当主机 protocolscsi 时,才能添加所有其他端口类型。不支持双协议主机。不能将主机添加到具有与主机不同的协议的主机集群。NVMe 主机必须将 type 设置为 default

请只发出 mkhost 命令一次。 集群系统会扫描主机区域中 WWPN 的光纤网。 系统本身无法过滤到主机以决定哪些 WWPN 位于哪些主机中。 因此,您必须使用 mkhost 命令来识别主机。

识别主机后,将在主机和卷之间创建映射。 这些映射会有效地向它们所映射的主机提供卷。 主机对象中的所有 WWPN 都将映射到卷。

某些 HBA 设备驱动程序在识别目标逻辑单元号 (LUN) 之后才能登录到光纤网。 由于它们无法登录,因此就无法将它们的 WWPN 识别为候选端口。 您可以使用此命令指定 force 参数以停止验证 WWPN 列表。

如果将主机添加到与超出系统限制的主机端口或主机对象关联的 I/O 组,该命令将失败。

要了解更多信息,请参阅 mkvdiskhostmaplssasportcandidatelsfcportcandidate 命令。

有关特定主机的参数需求的更多信息,请访问以下支持站点: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