rmhostport

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

Parameters

-saswwpn wwpn_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.
-fcwwpn wwpn_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.
-iscsiname iscsi_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.
-nqn nqn_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