rmhostport

The rmhostport command deletes worldwide port names (WWPNs) or iSCSI qualified names (IQNs) from an existing host object.

Syntax


>>- svctask -- -- rmhostport -- -- -hbawwpn -- wwpn_list -- ---->

>--+------------------------------+--+----------+-- ------------>
   '- -iscsiname--iscsi_name_list-'  '- -force -'      

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

Parameters

-hbawwpn wwpn_list: (Required) Specifies the list of fibre-channel host ports to delete from the host.
-iscsiname iscsi_name_list: (Optional) Specifies the comma-separated list of IQNs to delete from the host. Up to 16 names can be specified. At least one WWPN or iSCSI name must be specified.
-force: (Optional) Forces the deletion of the specified ports. This overrides the check that all of the WWPNs or IQNs in the list are mapped to the host specified.
host_name | host_id: (Required) Specifies the host name or the host ID.

Description

This command deletes the list of HBA WWPNs or IQNs from the specified host object. If the WWPN ports are still logged in to the fabric, they become unconfigured and are listed as candidate WWPNs. See also the svcinfo lshbaportcandidate command.

Any virtual disks that are mapped to this host object are automatically unmapped from the ports.

Replacing an HBA in a host: List the candidate HBA ports by issuing the svcinfo lshbaportcandidate command. A list of the HBA ports that are available to be added to host objects is displayed. One or more of these ports corresponds with one or more WWPNs that belong to the new HBA. Locate the host object that corresponds to the host in which you have replaced the HBA. The following command lists all the defined host objects:

svcinfo lshost

To list the WWPNs that are currently assigned to the host, issue the following:

svcinfo lshost hostobjectname

where hostobjectname is the name of the host object.

Add the new ports to the existing host object by issuing the following command:

svctask addhostport -hbawwpn one or more existing WWPNs separated by : hostobjectname/ID

where one or more existing WWPNs separated by : and hostobjectname/id correspond to those values listed in the previous steps.

Remove the old ports from the host object by issuing the following command:

svctask rmhostport -hbawwpn one or more existing WWPNs separated by : hostobjectname/ID

where one or more existing WWPNs separated by : corresponds with those WWPNs that are listed in the previous step that belong to the old HBA that has been replaced. Any mappings that exist between the host object and VDisks are automatically applied to the new WWPNs. Therefore, the host recognizes that the VDisks are the same SCSI LUNs as before. See the Multipath Subsystem Device Driver: User's Guide for additional information about dynamic reconfiguration.

An invocation example

svctask rmhostport -hbawwpn 210100E08B251DD4 host_one

The resulting output

No feedback

An invocation example

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

The resulting output

No feedback