IN THIS ARTICLE
This article outlines how you can initiate server-side deletes of entire file system trees in Qumulo Core.
REQUIREMENTS
- Cluster running Qumulo Core 2.6.7 (and higher)
Note: If your cluster runs a higher version of Qumulo Core, refer to Server-Side Tree Delete in Qumulo Core 4.2.4 (and Higher) 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 higher):
I HAVE VALIDATED THE PATH
- Qumulo Core 2.10.2 (and lower):
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
Comments
1 comment