rmhostport

Use the rmhostport command to delete worldwide port names (WWPNs) or Internet Small Computer System Interface (iSCSI) names from an existing host object.

Syntax

 rmhostport    {  -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 the colon-separated 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 the colon-separated 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 delete from 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) Overrides the check that specifies all of the WWPNs or iSCSI names in the list are mapped to the host. Ports not associated with the host are ignored.
Important: Using the force parameter might result in a loss of access. Use it only under the direction of your product support information.
host_name | host_id
(Required) Specifies the host name or the host ID.
-force
(Optional) Overrides the check that specifies all of the WWPNs or iSCSI names in the list are mapped to the host. Ports that are not associated with the host are ignored.
Important: Using the force parameter might result in a loss of access. Use it only under the direction of your product support information.

Description

This command deletes the list of host-bus adapter (HBA) WWPNs or iSCSI names 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.

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

Remember: This command is unsuccessful if:
  • Volume protection is enabled (using the chsystem command)
  • The last host port being deleted is mapped to any volume that has received I/O within the defined volume protection time period
If multiple hosts are mapped to the same active volume, the host port removal is allowed if the host is offline. This allows for the removal of ports from hosts that might be part of the same system.
List the candidate Fibre Channel (FC) or serial-attached SCSI (SAS) ports by issuing the lsfcportcandidate or lssasportcandidate command. A list of the ports that are available to be added to host objects is displayed. To list the WWPNs that are currently assigned to the host, issue the following:

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:

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

where one or more existing WWPNs separated by colon (:) and hostobjectname/id is the name or ID of the host object.
Remove the old ports from the host object by issuing the following command:

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

where one or more existing WWPNs separated by colon (:) corresponds with those WWPNs that are listed in the previous step. Any mappings that exist between the host object and volumes are automatically applied to the new WWPNs.

An invocation example

rmhostport -saswwpn 210100E08B251DD4 host1

The resulting output:

No feedback

An invocation example

rmhostport -fcwwpn 210100E08B251EE6 host1

The resulting output:

No feedback

An invocation example

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

The resulting output:

No feedback