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| host_uuid
- (Required) Specifies the host that you want to remove from the map with the volume, either by ID or by name or by UUID.
- vdisk_id | vdisk_name | vdisk_uid
- (Required) Specifies the volume by ID, name, or UID that you want to remove from the host mapping.
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
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
rmvdiskhostmap -host host1 vdisk8The resulting output:
No feedback