mkhost

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

语法

阅读语法图跳过直观语法图
>>- mkhost -- --+---------------------+-- ---------------------->
                '- -name -- new_name -'      

>--+- -saswwpn -- wwpn_list ------+----------------------------->
   +- -fcwwpn -- wwpn_list -------+   
   '- -iscsiname--iscsi_name_list-'   

>-- --+-----------------------+-- ------------------------------>
      '- -iogrp -iogrp_list  -'      

>-- --+-------------------------+-- --+----------+-------------->
      '- -mask -port_login_mask-'     '- -force -'   

>--+-------------------------------+---------------------------><
   '- -type --+- hpux -----------+-'   
              +- tpgs -----------+     
              +- generic --------+     
              +- openvms --------+     
              +- adminlun -------+     
              '- hide_secondary -'     

参数

-name new_name
(可选)指定新主机对象的名称或标签。
-saswwpn wwpn_list
(如果未使用 -iscsiname-fcwwpn,那么为必需) 指定串行连接 SCSI (SAS) WWPN(含 16 个字符的十六进制字符串)的列表。
-fcwwpn wwpn_list
(如果未使用 -saswwpn-iscsiname,那么为必需)指定光纤通道 (FC) WWPN(含 16 个字符的十六进制字符串)的列表。
-iscsiname iscsi_name_list
(如果未使用 -fcwwpn-saswwpn,那么必需) 指定要添加到主机中的以逗号分隔的 iSCSI 名称列表。必须至少指定一个 WWPN 或 iSCSI 名称。不能将该参数与 -fcwwpn-saswwpn 参数一起使用。
-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 端口 1。有效掩码值范围从 0000(未启用任何端口)到 1111111111111111111111111111111111111111111111111111111111111111(启用所有端口)。例如,掩码 111111101101 将启用端口 1、3、4、6、7、8、9、10、11 和 12。
-force
(可选)指定在不验证 WWPN 的情况下创建逻辑主机对象。
-type hpux | tpgs | generic | openvms | adminlun | hide_secondary
(可选)指定主机类型。缺省值为 generictpgs 参数启用额外的目标端口单元关注。请参阅 Storwize® V3500 主机连接文档,以了解有关需要 type 参数的主机的更多信息。
-hostcluster host_cluster_id | host_cluster_name
(可选)指定在其中创建新主机对象的主机集群标识(数字值)或名称(字母数字值)。

描述

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

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

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

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

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

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

调用示例

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