addhostport

The addhostport command adds worldwide port names (WWPNs) or iSCSI names to an existing host object.

Syntax

Read syntax diagramSkip visual syntax diagram
>>- svctask -- -- addhostport -- ------------------------------->

>--+- -hbawwpn -- wwpn_list ------+--+----------+-- ------------>
   '- -iscsiname--iscsi_name_list-'  '- -force -'      

>--+- host_name -+---------------------------------------------><
   '- host_id ---'   

Parameters

-hbawwpn wwpn_list
(Required if you do not use iscsiname) Specifies the list of fibre-channel host ports to add to the host. You cannot use this parameter with the iscsiname parameter.
-iscsiname iscsi_name_list
(Required if you do not use hbawwpn) Specifies the comma-separated list of iSCSI names to add to the host. Up to 16 names can be specified, and each name can contain up to 255 characters. Each name should comply with the iSCSI standard, RFC 3720. At least one WWPN or iSCSI name must be specified. You cannot use this parameter with the hbawwpn 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 HBA WWPNs or iSCSI names to the specified host object. Any virtual disks 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 svcinfo lshbaportcandidate command.

Some HBA device drivers do not log in to the fabric until they can recognize target LUNs. Because they do not log in, their WWPNs are not recognized as candidate ports. You can specify the force parameter with the svctask 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 svctask addhostport command. After adding the port to the host, you must create a host authentication entry using the svctask chhost command.

An invocation example

svctask addhostport -hbawwpn 210100E08B251DD4 host_one

The resulting output

No feedback

An invocation example

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

The resulting output

No feedback
Library | Support | Terms of use | Feedback
© Copyright IBM Corporation 2003, 2009. All Rights Reserved.