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
- (可选)指定主机类型。缺省值为 generic。tpgs 参数启用额外的目标端口单元关注。请参阅 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 组,该命令将失败。
要了解更多信息,请参阅 mkvdiskhostmap、lssasportcandidate 和 lsfcportcandidate 命令。
调用示例
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