rmhostport

You can use the rmhostport command to delete WWPNs from an existing host object.

Syntax

Read syntax diagramSkip visual syntax diagram>>- svctask -- -- rmhostport -- -- -hbawwpn -- wwpn_list -- ---->

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

Parameters

-hbawwpn wwpn_list
Specifies the list of ports to delete from the host.
-force
Forces the deletion of the ports that you entered. This argument deletes the WWPNs in the list from the host specified. The ports become unconfigured WWPNs.
host_name | host_id
Specifies the host name or the host ID.

Description

This command deletes the list of HBA WWPNs from the specified host object. If these 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. You should see a list of the HBA ports that are available to be added to host objects. One or more of these should correspond with the one or more WWPNs that belong to the new HBA. Locate the host object that corresponds with the host in which you have replaced the HBA. The following command lists all the defined host objects:
svcinfo lshost
To list the WWPNs 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 with those 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 :> correspond with those 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 will automatically be applied to the new WWPNs. Therefore, the host should see the VDisks as the same SCSI LUNs as before. See the IBM TotalStorage Subsystem Device Driver: User's Guide for additional information about dynamic reconfiguration.

Possible failures

Examples

An invocation example

svctask rmhostport -hbawwpn 210100E08B251DD4 host_one