Manage quotas using the CLI

This page describes how to manage quotas using the CLI.

Using the CLI, you can:

Set directory quota/default quota

Command: weka fs quota set / weka fs quota set-default

Before using the commands, verify that a mount point to the relevant filesystem is set.

Use the following commands to set a directory quota:

weka fs quota set <path> [--soft soft] [--hard hard] [--grace grace] [--owner owner]

It is also possible to set a default quota on a directory. It does not account for this directory (or existing child directories) but will automatically set the quota on new directories created directly under it.

Use the following command to set a default quota of a directory:

weka fs quota set-default <path> [--soft soft] [--hard hard] [--grace grace] [--owner owner]

Parameters

Name Value Default

Name	Value	Default
`path`*	Path to the directory to set the quota. The relevant filesystem must be mounted when setting the quota.
`soft`	Soft quota limit. Exceeding this number is displayed as exceeded quota but it is not enforced until the `grace` period is over. The capacity can be in decimal or binary units. Format: `1GB`, `1TB`, `1GiB`, `1TiB`, `unlimited`	`unlimited`
`hard`	Hard quota limit. Exceeding this number does not allow more writes before clearing some space in the directory. The capacity can be in decimal or binary units. Format: `1GB`, `1TB`, `1GiB`, `1TiB`, `unlimited`	`unlimited`
`grace`	Specify the grace period before the soft limit is treated as a hard limit. Format: `1d`, `1w`, `unlimited`	`unlimited`
`owner`	An opaque string identifying the directory owner (can be a name, email, slack ID, etc.) This owner will be shown in the quota report and can be notified upon exceeding the quota. Supports up to 48 characters.

path*

Path to the directory to set the quota. The relevant filesystem must be mounted when setting the quota.

soft

Soft quota limit. Exceeding this number is displayed as exceeded quota but it is not enforced until the grace period is over. The capacity can be in decimal or binary units. Format: 1GB, 1TB, 1GiB, 1TiB, unlimited

unlimited

hard

Hard quota limit. Exceeding this number does not allow more writes before clearing some space in the directory. The capacity can be in decimal or binary units. Format: 1GB, 1TB, 1GiB, 1TiB, unlimited

unlimited

grace

Specify the grace period before the soft limit is treated as a hard limit. Format: 1d, 1w, unlimited

unlimited

owner

An opaque string identifying the directory owner (can be a name, email, slack ID, etc.) This owner will be shown in the quota report and can be notified upon exceeding the quota. Supports up to 48 characters.

To set advisory only quotas, use a soft quota limit without setting a grace period.
When hard and soft quotas exist, setting the value of one of them to 0 will clear this quota.

List directory quotas/default quotas

Command: weka fs quota list / weka fs quota list-default

Use the following command to list the directory quotas (by default, only exceeding quotas are listed) :

weka fs quota list [fs-name] [--snap-name snap-name] [--path path] [--under under] [--over over] [--quick] [--all]

Parameters

Name Value Default

Name	Value	Default
`fs-name`	Shows quota report only on the specified valid filesystem.	All filesystems
`snap-name`	Shows the quota report from the time of the snapshot. Must be a valid snapshot name and be given along with the corresponding `fs-name.`
`path`	Path to a directory. Shows quota report only on the specified directory. The relevant filesystem must be mounted in the server running the query.
`under`	A path to a directory under a wekafs mount. The relevant filesystem must be mounted in the server running the query.
`over`	Shows only quotas over this percentage of usage. Possible values: `0`-`100`
`quick`	Do not resolve inode to a path. Provides quicker results if the report contains many entries.	False
`all`	Shows all the quotas, not just the exceeding ones.	False

fs-name

Shows quota report only on the specified valid filesystem.

All filesystems

snap-name

Shows the quota report from the time of the snapshot. Must be a valid snapshot name and be given along with the corresponding fs-name.

path

Path to a directory. Shows quota report only on the specified directory. The relevant filesystem must be mounted in the server running the query.

under

A path to a directory under a wekafs mount. The relevant filesystem must be mounted in the server running the query.

over

Shows only quotas over this percentage of usage. Possible values: 0-100

quick

Do not resolve inode to a path. Provides quicker results if the report contains many entries.

False

all

Shows all the quotas, not just the exceeding ones.

False

Use the following command to list the directory default quotas:

weka fs quota list-default [fs-name] [--snap-name snap-name] [--path path]

Parameters

Name Value Default

Name	Value	Default
`fs-name`	Shows the default quotas only on the specified valid filesystem.	All filesystems
`snap-name`	Shows the default quotas from the time of the snapshot. Must be a valid snapshot name and be given along with the corresponding `fs-name.`
`path`	Path to a directory. Shows the default quotas report only on the specified directory. The relevant filesystem must be mounted in the server running the query.

fs-name

Shows the default quotas only on the specified valid filesystem.

All filesystems

snap-name

Shows the default quotas from the time of the snapshot. Must be a valid snapshot name and be given along with the corresponding fs-name.

path

Path to a directory. Shows the default quotas report only on the specified directory. The relevant filesystem must be mounted in the server running the query.

Unsetting directory quota/default quota

Command: weka fs quota unset / weka fs quota unset-default

Use the following commands to unset a directory quota:

weka fs quota unset <path>

Use the following command to unset a default quota of a directory:

weka fs quota unset-default <path>

Parameters

Name Value

Name	Value
`path`*	Path to the directory to set the quota. The relevant filesystem must be mounted when setting the quota.

path*

Path to the directory to set the quota. The relevant filesystem must be mounted when setting the quota.

PreviousManage quotas using the GUI NextAdditional protocol containers