Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

We have released a new tool on O2 , called quota-v2, to check O2 filesystem usage and quotas. As of In August 82023, 2023 we have decommissioned the previous quota tool as it that ran on older code and did not report all of the quota information that is relevant to the O2 user community.

Checking usage (quota-v2)

The quota-v2 command works similarly to the older quota tool.

In its default usage, quota-v2 will report your usage and the usage of groups that you are a member of that have O2-accessible directories and that have quotas imposed.

...

Each of the fields in the above output from quota-v2 are explained below:

Column

Meaning

path

The path of the associated storage usage and/or limit

type

Type of storage limit, either “user” quota or “group” quota

username

The O2 username which corresponds to the usage and/or storage limit

usage

The amount of data being stored in this path

storage limit

The total maximum amount of data that could be stored at this path. If the usage reaches the storage limit, you may be unable add more data or modify data.

last update

The timestamp representing when this quota information was last refreshed. The information from quota-v2 is not representing real time usage/storage limit information; it is only refreshed once per hour.

In the previous example, user mfk8 's usage was below the storage limit for each path they have access to. The quota-v2 report will show an additional “exceeded” table if you (or groups you are a member of) have reached or surpassed a storage limit. Here is an example:

...

Note that the “exceeded” table has many of the same columns as in the standard “usage” table. One additional piece of information is reported: the “grace remaining”.

Column

Meaning

grace remaining

The amount of time you have to clean up and reduce your usage to below the storage limit. You can delete files or move files to another storage location, as you see fit.

If you (or members of your group) do not reduce the usage within the remaining grace period, the directory will “lock” and you will be unable to add/modify data under that path.

Not all O2 directories have an associated grace period. If you hit/exceed a storage limit and you do not have a grace period, your directory will immediately be unable to hold additional data.

Info

In some cases, you may find that if you do not see directories that you are a member of but have no usage in in your individual quota report. When this occurs, please use the quota-v2 path option with the relevant directory to see usage and limit information instead.

Checking usage by path (quota-v2 path)

The quota-v2 tool also allows users to check information for a group directory that they are a member of. The previous quota tool had this functionality, but it required manually granting permission to individual cluster users.

Here is an example for user mfk8's group directory:

...

In the above output, there are a few additional fields when using the path subcommand:

Column

Meaning

id

Numeric user ID or group ID

name

The real first name and last name corresponding to an O2 cluster user

Taking action on exceeded quotas

...