Use the rmhostport
command to delete worldwide port names (WWPNs) Internet Small Computer System Interface (iSCSI)
names, or NVMe Qualified Names (NQNs) from an existing host object.
Syntax
rmhostport { -saswwpnwwpn_list | -fcwwpnwwpn_list | -iscsinameiscsi_name_list | -nqnnqn_list } { host_name | host_id }
Parameters
- -saswwpnwwpn_list
- (Required if you do not use -iscsiname, -fcwwpn,
or -nqn.) Specifies a list of Serial Attached SCSI (SAS) WWPNs with a
16-character hexadecimal string.
- -fcwwpnwwpn_list
- (Required if you do not use -iscsiname, -saswwpn,
or -nqn.) Specifies a list of Fibre Channel (FC) WWPNs with a
16-character hexadecimal string.
- -iscsinameiscsi_name_list
- (Required if you do not use -fcwwpn, -saswwpn, or
-nqn.) Specifies the comma-separated list of iSCSI names. At least one
WWPN or iSCSI name must be specified. You cannot use this parameter with the
-fcwwpn or -saswwpn parameter.
- -nqnnqn_list
- (Required if you do not use -fcwwpn, -saswwpn, or
-iscsiname.) Specifies the comma-separated list of NVMe Qualified Names
(NQNs). The host protocol must be nvme to use this parameter.
- 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, iSCSI
names, or NQNs 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.
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