rmvolumehostclustermap
Use the rmvolumehostclustermap command to remove an existing host cluster mapping to a volume on a clustered system.
Syntax
Parameters
- -hostcluster hostcluster_id | hostcluster_name| hostcluster_uuid
- (Required) Specifies the host cluster (by ID or name) to remove from the volume mapping. The value for the ID must be a number and the value for the name must be an alphanumeric string.
- -makeprivate host_id_list | host_name_list| host_uuid_list
- (Optional) Specifies the host or hosts that acquire private mappings from the volume that is being removed from the host cluster. The value for the ID must be a number and the value for the name must be an alphanumeric string.
- volume_id | volume_name | volume_uid
- (Required) Specifies the volume by ID, name, or UID. The ID value must be a number, the name value must be an alphanumeric string, and the UID value must be 32 byte character string.
Description
This command removes an existing host cluster mapping on a host cluster. The volume is then inaccessible for input or output (I/O) transactions from the specified host cluster.
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 that moves a mapping from host cluster 0 to volume
0
rmvolumehostclustermap -hostcluster 0 0
The resulting output:
No feedback