Removing Volumes
Explains how to remove a volume using either the Control System or the CLI.
About this task
NOTE
When you remove a volume enabled for:- Cold tiering, the directory/folder for the volume in the metadata volume associated with the tier is also removed asynchronously.
- Warm tiering, the directory/folder for the volume in the metadata volume associated with the tier and the erasure-coded volume are also removed asynchronously.
Removing Volumes Using the Control System
About this task
To remove one or more volumes, in the Summary tab under :
NOTE
The Volumes page is under the
Volumes menu in the Kubernetes version of the
Control System.Procedure
-
Select the volumes to remove from the list of volumes in the
Volumes pane.
NOTEAlternatively, you can click the name of the volume to traverse to the volume details page.
-
Click Remove Volume(s) from the
Actions drop-down menu.
The Remove Volume(s) confirmation dialog displays.
-
Choose one of the following:
- Remove only if there are no dependent
artifacts — Specifies whether to check for dependencies
before removing the volume. If the volume has dependencies, such as
associated snapshots, the volume will not be deleted, but an alarm will
be raised.NOTEVolume will not be deleted if mirroring is in progress as the mirror volume is synchronized from a hidden internal snapshot of the source volume.
- Force remove even if there are dependent artifacts — Indicates that volume must be removed forcefully, even if the volume has dependencies.
- Remove only if there are no dependent
artifacts — Specifies whether to check for dependencies
before removing the volume. If the volume has dependencies, such as
associated snapshots, the volume will not be deleted, but an alarm will
be raised.
-
Click Remove Volume.
The selected volumes are removed.
Removing Volumes Using the CLI or REST API
About this task
The basic command to remove a volume is:
maprcli volume remove -name <volume name>
For complete reference information, see
volume remove
.
NOTE
When a volume is removed, the data present in that volume is not purged from
the filesystem immediately. The following parameters control when the deleted
volumes are purged.cldb.purge.delay.hours
— Time to wait (in hours) to trigger purge of any volume after CLDB becomes primary. The default value is 1 hour.cldb.volumes.purge.frequency
— The frequency (in minutes) for purging the data of deleted volumes. The default value is 60 minutes.Use themaprcli
command to set these parameters. For example:maprcli config save -values {"cldb.purge.delay.hours":"2"} maprcli config save -values {"cldb.volumes.purge.frequency":"120"}