addhostport

Use the addhostport command to add worldwide port names (WWPNs), NVMe Qualified Names (NQNs), or InfiniBand port names to an existing host object.

Syntax

Read syntax diagramSkip visual syntax diagram addhostport -saswwpnwwpn_list-fcwwpnwwpn_list-iscsinameiscsi_name_list-nqnnqn_list-forcehost_namehost_id
Read syntax diagramSkip visual syntax diagram addhostport -fcwwpnwwpn_list-ibgidinfiniband_gid_list-nvmenamenvme_name_list-iscsinameiscsi_name_list-forcehost_namehost_id

Parameters

-saswwpn wwpn_list
(Required if you do not use -iscsiname, -fcwwpn, or -nqn.) Specifies a list of Serial Attached SCSI (SAS) WWPNs with a 16-character hexadecimal string.
-fcwwpn wwpn_list
(Required if you do not use -iscsiname, -saswwpn, or -nqn.) Specifies a list of Fibre Channel (FC) WWPNs with a 16-character hexadecimal string.
-iscsiname iscsi_name_list
(Required if you do not use -fcwwpn, -saswwpn, or -nqn.) Specifies the comma-separated list of iSCSI names to add to the host. At least one WWPN or iSCSI name must be specified. You cannot use this parameter with the -fcwwpn or -saswwpn parameter.
-nqn nqn_list
(Required if you do not use -fcwwpn, -saswwpn, or -iscsiname.) Specifies the comma-separated list of NVMe Qualified Names (NQNs) to add to the host. The host protocol must be nvme to use this parameter.
-force
(Optional) Specifies that the list of ports be added to the host without the validation of any WWPNs or iSCSI names.
host_id | host_name
(Required) Specifies the host object to add ports to, either by ID or by name.
-fcwwpn wwpn_list
(Required if you do not use -ibgid or -nvmename.) Specifies a list of Fibre Channel (FC) WWPNs with a 16-character hexadecimal string. You cannot use this parameter with -ibgid or -nvmename.
-ibgid infiniband_gid_list
(Required if you do not use -fcwwpn or -nvmename.) Specifies a list of globally unique identifiers (GUIDs) with a 32-character hexadecimal string. You cannot use this parameter with -fcwwpn or -nvmename.
-nvmename nvme_name_list
(Required if you do not use -ibgid or -fcwwpn.) Specifies a list of NVMe qualified names that are defined for a NVME-attached host. You cannot use this parameter with -ibgid or -fcwwpn.
-force
(Optional) Specifies that the list of ports be added to the host without the validation of any port names.
host_id | host_name
(Required) Specifies the host object to add ports to, either by ID or by name.

Description

This command adds a list of host bus adapter (HBA) WWPNs, iSCSI names, or NQNs to the specified host object. Any volumes that are mapped to this host object automatically map to the new ports.

Note: The host port can only be added if it is compatible with the protocol of the host (SCSI can have all port types except NQNs, NVMe can have only NQNs).

This command adds a list of host bus adapter (HBA) WWPNs, NVMe Qualified Names (NQNs), or InfiniBand IDs to the specified host object. Any volumes that are mapped to this host object automatically map to the new ports.

Only WWPNs that are logged-in unconfigured can be added. For a list of candidate WWPNs, use the lssasportcandidate or lsfcportcandidate command.

Only port names that are logged-in unconfigured can be added. For a list of candidate port names, use the lsibportcandidate or lsfcportcandidate command.

Some HBA device drivers do not log in to the fabric until they can recognize target logical unit numbers (LUNs). Because they do not log in, their WWPNs are not recognized as candidate ports. You can specify the force parameter with the addhostport command to stop the validation of the WWPN list.You can specify the force parameter with the addhostport command to stop the validation of the port name list.

Note: When all I/O groups are removed from an iSCSI host, you cannot add a port to the iSCSI host until you map the iSCSI host to at least one I/O group. After you map the iSCSI host to at least one I/O group, resubmit the addhostport command. After you add the port to the host, you must create a host authentication entry using the chhost command.
The addhostport command fails if the:
  • Host is mapped to a volume with more than one I/O group in the access set and the host port you add is an Internet Small Computer System Interface (iSCSI) name
  • Port being added is from a host system that does not support volumes mapped from multiple I/O groups

A host can have a single port type from the following list:

  • sas
  • fcscsi
  • iscsi
  • fcnvme or rdmanvme

An invocation example

addhostport -saswwpn 210100E08B251DD4 host1

The resulting output:

No feedback