使用 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
- (可选)指定主机类型。缺省值为 generic。adminlun 主机类型等同于管理 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 组,该命令将失败。
要了解更多信息,请参阅 mkvdiskhostmap、lssasportcandidate 和 lsfcportcandidate 命令。有关特定主机的参数需求的更多信息,请访问以下支持站点:
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