QQ CLI: File System

REQUIREMENTS

Cluster running Qumulo Core
- Cluster is in quorum and qfsd process is running on the selected node
- The list below reflects the file system and capacity qq commands currently available and can differ between versions of Qumulo Core. Certain commands may require upgrading to a later release to utilize a specific API action.
Command line (CLI) tools installed via API & Tools in the Web UI
Admin privileges on the Qumulo cluster

FILE ANALYTICS OPERATIONS COMMANDS

COMMAND	ACTION
qq capacity_history_files_get	Get historical largest file data
qq capacity_history_get	Get capacity history data
qq current_activity_get	Get current sampled IOP and throughput rates
qq fs_file_samples	Get a number of sample files from the file system
qq fs_get_stats	Get file system statistics
qq time_series_get	Get specified time series data

FILE HANDLING COMMANDS

COMMAND	ACTION
qq fs_acl_explain_chmod	Explain how setting a POSIX mode would affect a file's acl
qq fs_acl_explain_posix_mode	Explain the derivation of POSIX mode from a file's ACL
qq fs_acl_explain_rights	Explain how rights are granted to a user for a file. *Note that this command does not discover the user's groups and related identities when computing rights. To provide this information, use the -g argument.
qq fs_copy	Server-side copy files
qq fs_create_dir	Create a new directory
qq fs_create_file	Create a new file
qq fs_create_link	Create a new link
qq fs_create_symlink	Create a new symbolic link
qq fs_create_unix_file	Create a new pipe, character device, block device or socket
qq fs_delete	Delete a file system object
qq tree_delete_cancel	Cancels a tree-delete job
qq tree_delete_create	Delete a file system tree recursively
qq tree_delete_get	Status of a tree-delete job
qq tree_delete_list	Lists all tree-delete jobs
qq fs_file_get_attr	Get file attributes
qq fs_file_samples	Get a number of sample files from the file system
qq fs_file_set_attr	Set file attributes
qq fs_file_set_smb_attrs	Change SMB extended attributes on the file
qq fs_get_acl	Get file ACL
qq fs_get_permissions_settings	Get permissions settings
qq fs_list_named_streams	List all named streams on a file or directory
qq fs_modify_acl	Modify file ACL
qq fs_punch_hole	Create a hole in a region of a file. Destroys all data within the hole.
qq fs_read	Read a file
qq fs_read_dir	Read a directory
qq fs_read_dir_aggregates	Read directory aggregation entries
qq fs_remove_stream	Remove stream from a file or directory
qq fs_rename	Rename a file system object
qq fs_resolve_paths	Resolve file IDs to paths
qq fs_set_acl	Set file ACL
qq fs_set_permissions_settings	Set permissions settings
qq fs_walk_tree	Walk file system tree
qq fs_write	Write data to a file

FILE LOCK OPERATIONS COMMANDS

qq fs_list_locks	List file locks held by clients
qq fs_list_lock_waiters_by_client	List waiting lock requests for a particular client machine
qq fs_list_lock_waiters_by_file	List waiting lock requests for a particular files
qq fs_release_nlm_lock	Release an arbitrary NLM byte-range lock range *Only use as a last resort after confirming that the owning process has leaked the lock
qq fs_release_nlm_locks_by_client	Release NLM byte range locks (ALL) held by client *Only use after confirming that the client is dead as a last resort