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