rmvdisk

Use the rmvdisk command to delete a volume. This command cannot be used for high availability volumes. Use the rmvolume command for high availability volumes.

Syntax

 rmvdisk    [  -keepaux   vdisk  ]   [  -force  ] { [  -removehostmappings  ] | [  -force  ] }   {  vdisk_id  |  vdisk_name  }

Parameters

-keepauxvdisk
(Optional) Retains accessibility of the auxiliary copy through the master volume's host mappings if the volume being deleted is the master volume of an active-active relationship.
Remember: Use this parameter for stand-alone relationships (not relationships in consistency groups).
-force
(Optional) Deletes the specified volume, even if mappings still exist between this volume and one or more hosts. This parameter deletes any host-to-volume mappings and any FlashCopy mappings that exist for this volume.
Important: To prevent an active volume from being deleted unintentionally, you can use a global system setting to enable volume protection (see the chsystem command). You can specify a time period for which the volume must be idle before you can delete it. If volume protection is enabled and the time period has not expired, the volume deletion fails even if the -force parameter is used."
This parameter also deletes any Metro Mirror or Global Mirror relationships that exist for the specified volume. Data that is on the volume is lost. Before you issue this command, ensure that the volume and any data that resides on it are no longer required. If the -force deletion of a volume causes dependent mappings to be stopped, any target volumes for those mappings that are in Metro Mirror or Global Mirror relationships are also stopped. The dependent mappings can be identified by using the lsvdiskdependentmaps command on the volume that you want to delete.
Note: Using the -force parameter might result in a data loss. Use it only under the direction of your product support information, or if you are willing to accept the risk of volume data loss.

If you do not specify this parameter a volume cannot be deleted while a backup operation is in progress. Additionally, a volume containing image mode copies cannot be deleted while a restore operation is in progress (if the volume contains inconsistent data).

-removehostmappings
(Optional) Removes all host mappings for the specified volume before deleting the volume itself.
Note: Using the -removehostmappings parameter might result in a data loss. Use it only under the direction of your product support information, or if you are willing to accept the risk of volume data loss.
vdisk_id | vdisk_name
Specifies the name of the volume to delete, either by ID or by name.
Note: To deactivate compression, use the rmvdiskcopy to delete the last compressed volume copy for an I/O group.

Description

This command deletes an existing managed mode volume or an existing image mode volume. The extents that made up this volume are returned to the pool of free extents that are available on the storage pool, if the volume is in managed mode.
Remember: If you issue this command, any data that was on the volume is lost. Before you issue this command, ensure that the volume (and any data that resides on it) is no longer required.
This command is unsuccessful if:
  • Volume protection is enabled (using the chsystem command)
  • The volume being removed has received I/O within the defined volume protection time period

With an active-active relationship, either or both of the master and auxiliary volumes can provide the information for host systems to read through the master volume ID. To remove the auxiliary volume from the relationship, delete the relationship so hosts can access the master copy.

To remove the master volume from the relationship while leaving the host able to access the auxiliary copy without disruption, specify rmvdisk -keepaux on the master volume. Specifying rmvdisk -keepaux deletes the master volume and replaces it with the auxiliary volume. This leaves the auxiliary volume with the deleted master volume's ID and host mappings. No volume is left at the auxiliary volume's previous ID. The volume that remains is cached in the I/O group that the auxiliary volume was cached in. This can happen only when the auxiliary volume is already processing host read and write information. This volume is either a current copy of an active-active relationship, or it is the copy specified with stoprcrelationship -access.

Remember: Any FlashCopy mappings with the specified volume as their source volume are deleted when you specify this command.

Deleting a managed mode volume

When you use this command to delete a managed mode volume, all the data on the volume is deleted. The extents that make up the volume are returned to the pool of free extents that are available in the storage pool.

If host mappings exist for the volume, or if any FlashCopy mappings would be affected, the deletion fails. You can use the -force parameter to force the deletion. If you use the -force parameter, mappings that have the volume as source or target are deleted, other mappings in a cascade might be stopped, and then the volume is deleted. The -force parameter also deletes any Metro Mirror or Global Mirror relationships that exist for the specified volume (and any information that is not staged in the fast write cache).

If the volume is in the process of migrating to an image mode volume (using the migratetoimage command), the deletion fails unless you use the -force parameter. If you use the -force parameter, the migration is halted and then the volume is deleted. Before you issue this command, ensure that the volume (and any data that resides on it) is no longer required.

Deleting an image mode volume

If the volume is mirrored and one or both copies is in image mode, you must first wait for all fast-write data to be moved to the controller logical unit. This ensures that the data on the controller is consistent with the data on the image mode volume before the volume is deleted. This process can take several minutes to complete, and is indicated by the fast_write_state state of the volume being empty. If the -force parameter is specified, the fast-write data is discarded and the volume is deleted immediately; the data on the controller logical unit is left inconsistent and unusable. If the copies are not synchronized, you must use the -force parameter.

If you run the command while data is in the cache, the system attempts to move the data out of the cache; this process can time out, however.

If there are any virtual medium errors on the volume, the command fails. You can force the deletion by using the -force parameter; however, this can cause data integrity problems.
Note: A virtual medium error occurs when you copy data from one disk (the source) to another (the target). Reading the source indicates that there is a medium error. At that moment, you must have two identical copies of data and you must then simulate a medium error on the target disk. You can simulate a medium error on the target disk by creating a virtual medium error on the target disk.

If FlashCopy mappings or host mappings exist for the volume, the deletion fails unless you use the -force parameter. If you use the -force parameter, mappings are deleted and the volume is deleted. If there is any data that is not staged in the fast write cache for this volume, the deletion of the volume fails. When the -force parameter is specified, any data that is not staged in the fast write cache is deleted. Deleting an image mode volume causes the managed disk that is associated with the volume to be removed from the storage pool. The mode of the managed disk is returned to unmanaged.

If the relationship is in consistent_copying or consistent_stopped state, and the change volume is being used by a Global Mirror relationship using multicycling mode, the relationship moves to inconsistent_copying or inconsistent_stopped state.
Note: If the relationship is part of a consistency group entire group is affected by this state transition.
The secondary volume becomes corrupt, and inaccessible for host input/output I/O data if:
  • A changed volume is part of an idling relationship
  • The changed volume is being used for secondary protection
  • The background copy process is still migrating the change volume data to the secondary volume
You must issue recovervdisk to gain access to the volume contents once more. If a change volume was part of an idling relationship and being used for Global Mirror relationship using multicycling mode, and the relationship was deleted but the background copy process continued and is still migrating data to the secondary volume then the secondary volume also becomes corrupt. In any of these cases, this recovervdisk fails without -force being specified.
Note:
  • The -force parameter must be used if rmvdisk is specified and rejected if the volume is a change volume for a relationship.
  • If the volume is a change volume for a relationship, specifying rmvdisk with -force removes the change volume from the relationship.

An invocation example

rmvdisk -force vdisk5

The resulting output:

No feedback

An invocation example

rmvdisk -keepaux mastervdisk

The resulting output:

No feedback

An invocation example

rmvdisk -removehostmappings vdisk3

The resulting output:

No feedback