volume qtree delete

Delete a qtree

Availability: This command is available to cluster and Vserver administrators at the admin privilege level.

Description

This command deletes a qtree. The length of time that it takes to delete a qtree depends on the number of directories and files it contains. You can monitor the progress of the delete operation by using the job show and job watch-progress commands, respectively.

The automatically created qtree in the volume - qtree0, listed in CLI output as "" - cannot be deleted.

Note: Quota rules associated with this qtree in all the quota policies will be deleted when you delete this qtree. Qtree deletion will not be allowed if Storage-level Access Guard (SLAG) is configured.

Parameters

-vserver <vserver name> - Vserver Name
This specifies the name of the Vserver on which the volume containing the qtree belongs.
{ -volume <volume name> - Volume Name
This specifies the name of the volume containing the qtree to be deleted.
-qtree <qtree name> - Qtree Name
This specifies the name of the qtree to be deleted.
| -qtree-path <qtree path>} - Actual (Non-Junction) Qtree Path
The qtree path argument in the format /vol/<volume name>/<qtree name> can be specified instead of specifying volume and qtree as separate arguments.
[-force [true]] - Force Delete (privilege: advanced)
This optionally forces the qtree delete operation to proceed when the qtree contains files. The default setting is false (that is, the qtree will not be deleted if it contains files). This parameter is available only at the advanced privilege and higher.
[-foreground [true]] - Foreground Process
This optionally specifies whether the qtree delete operation runs as a foreground process. The default setting is false (that is, the operation runs in the background).

Examples

The following example deletes a qtree named qtree4. The Vserver name is vs0 and the volume containing the qtree is named vol1.
cluster1::> volume qtree delete -vserver vs0 -volume vol1 -qtree qtree4
WARNING: Are you sure you want to delete qtree qtree4 in volume vol1 vserver vs0?  {y|n}: y
[Job 38] Job is queued: Delete qtree qtree4 in volume vol1 vserver vs0.