IN THIS ARTICLE
Outlines how to initiate server-side deletes of entire file system trees in Qumulo Core
REQUIREMENTS
- Cluster running Qumulo Core 2.6.7 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.4 and Above for the appropriate commands for your version. - Command line (CLI) tools installed via API & Tools tab
- Admin privileges on the Qumulo cluster
IMPORTANT: Deployments running Qumulo Core 4.2.3 and below have no mechanism to stop, pause, or cancel a server-side tree delete once it's started. Double-check the directory path before starting a tree delete to ensure it's accurate or take a snapshot if unsure.
DETAILS
Initiate a Tree Delete
Use the following command to start a tree delete of a directory using the path:
qq fs_delete_tree --path /dir/to/delete
Use the following command to start a tree delete of a directory using the ID of the tree root:
qq fs_delete_tree --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 one of the prompts below to proceed with the tree delete.
- Qumulo Core 2.10.3 and above: I HAVE VALIDATED THE PATH
- Qumulo Core 2.10.2 and below: yes
Check the Tree Delete Status
You can check the current status of the tree delete using the ID or directory path with the following qq command:
qq fs_delete_tree_status --path /dir/to/delete
qq fs_delete_tree_status --id 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.
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
Server-Side Tree Delete in Qumulo Core 4.2.4 and Above
Like what you see? Share this article with your network!
Comments
1 comment