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