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

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.

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.

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