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 -------+ '- -iscsiname--iscsi_name_list-' >--+----------+-- --+- host_name -+---------------------------->< '- -force -' '- host_id ---'
Parameters
- -saswwpn wwpn_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.
- -fcwwpn wwpn_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.
- -iscsiname iscsi_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.
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
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
Remove the
old ports from the host object by issuing the following command:
rmhostport -fcwwpn one or more existing WWPNs
separated by : hostobjectname/ID
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