mkhost

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

语法

 mkhost    [  -name  new_name  ]   {  -saswwpn  wwpn_list  |  -fcwwpn  wwpn_list  | -iscsinameiscsi_name_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
(可选)指定新主机对象的名称或标签。
-saswwpnwwpn_list
(如果未使用 -iscsiname-fcwwpn,那么为必需) 指定串行连接 SCSI (SAS) WWPN(含 16 个字符的十六进制字符串)的列表。
-fcwwpnwwpn_list
(如果未使用 -saswwpn-iscsiname,那么为必需)指定光纤通道 (FC) WWPN(含 16 个字符的十六进制字符串)的列表。
-iscsinameiscsi_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 端口。掩码中最右侧的位对应于 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 主机类型。tpgs 主机类型支持额外的目标端口 Unit Attention,任何 Solaris 主机都需要该主机类型。
-hostclusterhost_cluster_id | host_cluster_name
(可选)指定在其中创建新主机对象的主机集群标识(数字值)或名称(字母数字值)。

描述

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

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

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

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

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

要了解更多信息,请参阅 mkvdiskhostmaplssasportcandidatelsfcportcandidate 命令。有关特定主机的参数需求的更多信息,请访问以下支持站点:

http://support.lenovo.com.cn/lenovo/wsi/Modules/DriverDownLoadServer.aspx

调用示例

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