Server-Side Tree Delete in Qumulo Core 4.2.4 and Above

REQUIREMENTS

Cluster running Qumulo Core 4.2.4 and above
NOTE: If your cluster is running an earlier version of Qumulo Core, refer to Server-Side Tree Delete in Qumulo Core 4.2.3 and Below for the appropriate commands for your version.
Command line (CLI) tools installed via API & Tools tab
Admin privileges on the Qumulo cluster

DETAILS

Qumulo Core supports initiating server-side deletes of entire file system trees, aka tree deletes. Tree deletes ensure that you can start a delete job easily with a single qq command and know that it will successfully finish. Even if your cluster goes down or experiences transient errors running the process, the delete job will still complete.

NOTE: Your cluster can have up to 10 active tree delete operations per node; any additional operations will be queued.

Initiate a Tree Delete

Use the following command to start a tree delete of a directory using the path:

qq tree_delete_create /dir/to/delete

Use the following command to start a tree delete of a directory using the ID of the tree root:

qq tree_delete_create --id ID

Once a tree delete is initiated using one of the commands above, you will need to confirm the directory to ensure the tree delete is correct. Enter I HAVE VALIDATED THE PATH to proceed with the tree delete.

Check the Tree Delete Status

You can check the current status of all active tree delete operations using the following command:

qq tree_delete_list

You can check the current status of the tree delete using the ID with the following qq command:

qq tree_delete_get ID

NOTE: If the job has finished or if there was never a job assigned to the specified directory, the status will return a 404 error.

Cancel an Existing Tree Delete

You can cancel any active tree delete operation using the following command:

qq tree_delete_cancel ID

Additional Considerations

You will not receive failure by permissions
Tree deletes can delete up to a depth of 1000 directories
If you use tree delete to delete a replication target directory, the replication job will break
No performance guidance is given for how long the delete work will take to complete

RESOLUTION

You should now be able to successfully complete a server-side tree delete in Qumulo Core

ADDITIONAL RESOURCES

QQ CLI: File System

Server-Side Tree Delete in Qumulo Core 4.2.3 and Below

Like what you see? Share this article with your network!

Was this article helpful?

1 out of 1 found this helpful

Comments

0 comments

Please sign in to leave a comment.