rmvdiskhostmap

Use the rmvdiskhostmap command to delete an existing host mapping the volume is no longer accessible for input/output (I/O) transactions on the given host.

Syntax

rmvdiskhostmap -host { host_id | host_name } { vdisk_id | vdisk_name }

Parameters

-hosthost_id | host_name
(Required) Specifies the host that you want to remove from the map with the volume, either by ID or by name.
vdisk_id | vdisk_name
(Required) Specifies the name of the volume that you want to remove from the host mapping, either by ID or by name.

Description

This command deletes an existing mapping between the specified volume and the host. This effectively stops the volume from being available for I/O transactions on the given host.

This command also deletes a Small Computer System Interface (SCSI) or persistent reservation that a host has on a volume. Once the reservation is removed, a new host is allowed to access the volume in the future because the original host no longer has access.
Note: The rmvdiskhostmap command deletes the host mapping for all I/O groups in the access I/O group set of the volume.

Use caution when you process this command because to the host, it seems as if the volume has been deleted or is offline.

Remember: This command is unsuccessful if:
  • Volume protection is enabled
  • The host mapping being deleted is mapped to any volume that has received I/O within the defined volume protection time period

An invocation example

rmvdiskhostmap -host host1 vdisk8

The resulting output:

No feedback