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
Parameters
- -host host_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 vdisk8The resulting output:
No feedback