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