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.Use the rmhostport command to delete worldwide port names (WWPNs), Internet Small Computer System Interface (iSCSI) names, NVMe Qualified Names (NQNs), or InfiniBand port names 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| host_uuid: (Required) Specifies the host name or the host ID or the host UUID.

-fcwwpn wwpn_list: (Required if you do not use -ibgid or -nvmename.) Specifies a list of Fibre Channel (FC) WWPNs with a 16-character hexadecimal string. You cannot use this parameter with -ibgid or -nvmename.
-ibgid infiniband_gid_list: (Required if you do not use -fcwwpn or -nvmename.) Specifies a list of globally unique identifiers (GUIDs) with a 32-character hexadecimal string. You cannot use this parameter with -fcwwpn or -nvmename.
-nvmename nvme_name_list: (Required if you do not use -ibgid or -fcwwpn.) Specifies a list of a list of NVMe-qualified names that are defined for a NVMe-attached host. You cannot use this parameter with -ibgid or -fcwwpn.
host_id | host_name| host_uuid: (Required) Specifies the host object to remove ports from, either by ID or by name or by host UUID.

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.

This command deletes the list of host-bus adapter (HBA) WWPNs, iSCSI port names, NVMe Qualified Names (NQNs), or InfiniBand port 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.

Note: This command is available during the upgrade process.

When using the partition IP address to run this command, consider the following:

The user must identify objects using the name or UUID. Short IDs cannot be specified when using the partition IP address.
Only objects belonging to the partition can be created or acted upon. When creating new objects, the -partition parameter will be auto-populated for the partition. You cannot move items out of a partition when using the partition IP address.

An invocation example

rmhostport -saswwpn 210100E08B251DD4 host1

The resulting output:

No feedback