addhostport

Use the addhostport command to add worldwide port names (WWPNs) or Internet Small Computer System Interface (iSCSI) names from an existing host object.

Syntax

addhostport { -saswwpnwwpn_list | -fcwwpn wwpn_list | -iscsinameiscsi_name_list } [ -force ] { host_name | host_id }

Parameters

-saswwpnwwpn_list
(Required if you do not use -iscsiname or -fcwwpn) Specifies a list of Serial Attached SCSI (SAS) WWPNs with a 16-character hexadecimal string.
-fcwwpnwwpn_list
(Required if you do not use -iscsiname or -saswwpn) Specifies a list of Fibre Channel (FC) WWPNs with a 16-character hexadecimal string.
-iscsinameiscsi_name_list
(Required if you do not use -fcwwpn or saswwpn) 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.
-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 or iSCSI names 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.

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.

Note: When all I/O groups are removed from an iSCSI host, you cannot add a port to the iSCSI host until you have mapped the iSCSI host to at least one I/O group. After mapping the iSCSI host to at least one I/O group, resubmit the addhostport command. After adding 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 being added is an Internet Small Computer System Interface (iSCSI) name
  • Port being added is from a host system that does not support volumes being mapped from multiple I/O groups

An invocation example

addhostport -saswwpn 210100E08B251DD4 host1

The resulting output:

No feedback

An invocation example

addhostport -fcwwpn 210100E08B251EE6 host1

The resulting output:

No feedback

An invocation example

addhostport -iscsiname iqn.localhost.hostid.7f000001 mchost13

The resulting output:

No feedback