PowerScale OneFS 9.3.0.0 CLI Command Reference

Syntax

isi quota quotas modify <path> <type>
  [--user <name> | --group <name> | --gid <id> | --uid <id>
    | --sid <sid> | --wellknown <name>]
  [--hard-threshold <size>]
  [--clear-hard-threshold]
  [--advisory-threshold <size>]
  [--clear-advisory-threshold]
  [--soft-threshold <size>]
  [--clear-soft-threshold]
  [--soft-grace <duration>]
  [--container {yes | no}]
  [--ignore-limit-checks] 
  [--include-snapshots {yes | no}]
  [--percent-advisory-threshold=<value>]
  [--thresholds-include-overhead {yes | no}]
  [--thresholds-on {fslogicalsize | physicalsize | applogicalsize}] 
  [--enforced {yes | no}]
  [--linked {yes | no}]
  [--zone <string>]
  [--verbose]

Options

--path <path>

Specifies an absolute path within the /ifs file system.

--type

Specifies a quota type. The following values are valid:

directory

Creates a quota for all data in the directory, regardless of owner.

user

Creates a quota for one specific user. Requires specification of the --user, --uid, or --sid option.

group

Creates a quota for one specific group. Requires specification of the --group, --gid, or --sid option.

default-directory

Creates a master quota that creates a linked quota for every immediate subdirectory created in the directory.

default-user

Creates a master quota that creates a linked quota for every user who has data in the directory.

default-group

Creates a master quota that creates a linked quota for every group that owns data in the directory.

--user <name>

Specifies a user name.

--group <name>

Specifies a group name.

--gid <id>

Specifies the numeric group identifier (GID).

--uid <id>

Specifies a numeric user identifier (UID).

--sid <sid>

Specifies a security identifier (SID) for selecting the quota that you want to modify. For example, S-1-5-21-13.

--wellknown <name>

Specifies a well-known user, group, machine, or account name.

--hard-threshold <size>

Sets an absolute limit for disk usage. Attempts to write to disk are generally denied if the request violates the quota limit. Size is a capacity value formatted as <integer>[{b | K | M | G | T | P}].

--clear-hard-threshold

Clears an absolute limit for disk usage.

--advisory-threshold <size>

Sets the advisory threshold. For notification purposes only. Does not enforce limitations on disk write requests. Size is a capacity value formatted as <integer>[{b | K | M | G | T | P}].

--clear-advisory-threshold

Clears the advisory threshold.

--soft-threshold <size>

Specifies the soft threshold, which allows writes to disk above the threshold until the soft grace period expires. Attempts to write to disk are denied thereafter. Size is a capacity value formatted as <integer>[{b | K | M | G | T | P}].

--clear-soft-threshold

Clears the soft threshold.

--soft-grace <duration>

Specifies the soft threshold grace period, which is the amount of time to wait before disk write requests are denied.

Specify <duration> in the following format:

<integer><units>

The following <units> are valid:

Y

Specifies years

M

Specifies months

W

Specifies weeks

D

Specifies days

H

Specifies hours

m

Specifies minutes

s

Specifies seconds

--container {yes | no}

Specifies whether to consider a share (container) or the entire Isilon filesystem when reporting total available space and amount of free space.

• no—Available space is relative to the entire Isilon cluster filesystem. This is the default setting.
• yes—Available space is relative to quotas set for each share. This feature is supported for protocols such as SMB, NFS, rquotas, and others. To determine the total available space in a share, OneFS considers both hard and soft quotas of all quota types (directory, groups, users). To report free space on a share, it finds the quota with the least amount of free space. This is not necessarily the smallest threshold set; it is the smallest currently available free space. For example, if a department has a 100T limit, and each user within the department has a 1T limit, it would be possible for the 100T share to run out of space before any one user runs out of their 1T.

  The yes setting requires that either a hard or soft quota is set to define a share and that the --enforced setting is specified.

--ignore-limit-checks

Creates a child quota that has a higher quota limit than the parent quota.

--include-snapshots {yes | no}

Includes snapshots in the quota size.

--percent-advisory-threshold=<value>

Specifies a soft limit or advisory threshold as a percentage of the quota hard limit.

--thresholds-include-overhead {yes | no}

Includes OneFS storage overhead in the quota threshold when set to yes.

--thresholds-on {fslogicalsize | physicalsize | applogicalsize}

Enforces the limits for this quota based on the following parameters.

fslogicalsize

Base quota enforcement on file system logical size; storage usage which does not include metadata and data protection.

physicalsize

Base quota enforcement on physical size; storage usage which includes metadata and data protection.

applogicalsize

Base quota enforcement on application logical size; storage usage which includes capacity consumption on the cluster as well as data tiered to the cloud. This storage usage is usually equal to or less than the file system logical size.

--enforced {yes | no}

Enforces this quota when set to yes. Specifying any threshold automatically sets this value to yes on create.

--linked {yes | no}

Unlinks a linked quota created automatically by a default-directory, default-user, or default-group quota. Unlinking allows the quota to be modified separately. To modify a linked quota, you must modify the original default-directory, default-user, or default-group quota it originated from, instead of the linked quota itself.

--zone <string>

The zone used by the quota. Use this parameter only to resolve personas used by the quota.

{--verbose | -v}

Displays more detailed information.