使用 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/EsWeb/ThinkServerAndStore.aspx?MachineClass=7271&MachineName=12810&station=4
调用示例
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