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 { -saswwpn wwpn_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 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
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