使用 addhostport
命令将全球端口名 (WWPN)、因特网小型计算机系统接口 (iSCSI) 名或 NVMe 限定名 (NQN) 添加到现有主机对象。
语法
addhostport { -saswwpnwwpn_list | -fcwwpnwwpn_list | -iscsinameiscsi_name_list | -nqnnqn_list } [ -force ] { host_name | host_id }
参数
- -saswwpnwwpn_list
- （在不使用 -iscsiname、-fcwwpn 或 -nqn 的情况下为必需。）指定串行连接 SCSI (SAS) WWPN（16 个字符的十六进制字符串）的列表。
- -fcwwpnwwpn_list
- （在不使用 -iscsiname、-saswwpn 或 -nqn 的情况下为必需。）指定光纤通道 (FC) WWPN（采用 16 字符的十六进制字符串）的列表。
- -iscsinameiscsi_name_list
- （在不使用 -fcwwpn、-saswwpn 或 -nqn 的情况下为必需。）指定要添加到主机的 iSCSI 名称的逗号分隔列表。必须至少指定一个 WWPN 或 iSCSI 名称。 不能将该参数与 -fcwwpn 或 -saswwpn 参数一起使用。
- -nqnnqn_list
- （在不使用 -fcwwpn、-saswwpn 或 -iscsiname 的情况下为必需。）指定要添加到主机的 NVMe 限定名 (NQN) 的逗号分隔列表。 主机协议必须为 nvme 才能使用此参数。
- -force
- （可选）在不验证任何 WWPN 或 iSCSI 名称的情况下指定要添加到主机的端口列表。
- host_id | host_name
- （必需）指定要将端口添加到的主机对象（按标识或名称）。
描述
此命令会将主机总线适配器 (HBA) WWPN、iSCSI 名称或 NQN 的列表添加到指定的主机对象。会自动将任何映射到该主机对象的卷映射到新端口。
Note: 仅当主机端口与主机协议兼容时才能进行添加（SCSI 可以具有除 NQN 之外的所有端口类型，NVMe 只能具有 NQN）。
只可以添加以未配置状态记录的 WWPN。 要获取候选 WWPN 的列表，请使用 lssasportcandidate 或 lsfcportcandidate 命令。
某些 HBA 设备驱动程序在它们可以识别目标逻辑单元号 (LUN) 之后才能登录到光纤网。 由于它们无法登录，因此就无法将它们的 WWPN 识别为候选端口。 您可以指定带 force 参数的 addhostport 命令来停止验证 WWPN 列表。
Note: 从 iSCSI 主机中除去所有 I/O 组后，无法将端口添加到 iSCSI 主机，直至您将 iSCSI 主机映射到至少一个 I/O 组。 将 iSCSI 主机映射到至少一个 I/O 组后，重新提交 addhostport 命令。 将端口添加到主机后，必须使用 chhost 命令创建主机认证条目。
addhostport 命令在以下情况下失败：
- 主机映射到在访问集中具有多个 I/O 组的卷，并且所添加的主机端口是互联网小型计算机系统接口（iSCSI）的名称
- 添加的端口来自不支持从多个 I/O 组映射的卷的主机系统
调用示例
addhostport -saswwpn 210100E08B251DD4 host1
生成的输出：
No feedback
调用示例
addhostport -fcwwpn 210100E08B251EE6 host1
生成的输出：
No feedback
调用示例
addhostport -iscsiname iqn.localhost.hostid.7f000001 mchost13
生成的输出：
No feedback