Server-Side Tree Delete in Qumulo Core 4.2.3 and Below

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

qq fs_delete_tree --path /dir/to/delete

qq fs_delete_tree --id ID

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

QQ CLI: File System

Server-Side Tree Delete in Qumulo Core 4.2.4 and Above

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