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