Skip to main content

volume quota report

Contributors
Suggest changes
PDFs

Display the quota report for volumes

Availability: This command is available to cluster and Vserver administrators at the admin privilege level.

Description

This command displays the quota report for all volumes in each Vserver that are online and for which quotas are activated. Quota report includes the quota rules (default, explicit, and derived) in effect and the associated resource usage (disk space and files). If quotas are still initializing for a specific volume, that volume is not included.

This command displays the following information:

  • Vserver name

  • Volume name

  • Index - This is a unique number within a volume assigned to each quota rule displayed in the quota report.

  • Tree name - This field gives the name of the qtree if the quota rule is at the qtree level. It is empty if the quota rule is at the volume level.

  • Quota type - Type of quota rule (tree or user or group ).

  • Quota target - This field gives the name of the target of the quota rule. For tree quota rules, it will be the qtree ID of the qtree. For user quota rules, it will be the UNIX user name or the Windows user name. For group quota rules, it will be the UNIX group name. For default rules (tree or user or group), this will display "*" . If the UNIX user identifier, UNIX group identifier, or Windows security identifier no longer exists or if the identifier-to-name conversion fails, the target appears in numeric form.

  • Quota target ID - This field gives the target of the quota rule in numeric form. For tree quota rules, it will be the qtree ID of the qtree. For group quota rules, it will be the UNIX group identifier. For UNIX user quota rules, it will be the UNIX user identifier. For Windows user quota rules, it will be the Windows security identifier in its native format. For default rules (tree or user or group), "*" will be displayed.

  • Disk space used - For a default quota, the value is 0.

  • Disk space limit

  • Soft disk space limit

  • Threshold for disk space limit

  • Files used - For a default quota, the value is 0.

  • File limit

  • Soft file limit

  • Quota specifier - For an explicit quota, this field shows how the quota target was configured by the administrator using the volume quota policy rule command. For a default quota, the field shows "" . For a derived tree quota, this field shows the qtree path. For a derived user and group quota, the field is either blank or "" .

The following parameters: -soft , -soft-limit-thresholds , -target-id , -thresholds , -fields and -instance display different set of fields listed above. For example, -soft will display the soft disk space limit and soft file limit apart from other information. Similarly -target-id will display the target in the numeric form.

A quota report is a resource intensive operation. If you run it on many volumes in the cluster, it might take a long time to complete. A more efficient way would be to view the quota report for a particular volume in a Vserver.

Depending upon the quota rules configured for a volume, the quota report for a single volume can be large. If you want to monitor the quota report entry for a particular tree/user/group repeatedly, find the index of that quota report entry and use the -index field to view only that quota report entry. See the examples section for an illustration.

Parameters

{ [-fields <fieldname>,…​]

If you specify the -fields <fieldname>, …​ parameter, the command output also includes the specified field or fields. You can use '-fields ?' to display the fields to specify.

| [-soft ]

If this parameter is specified, the command display will include the soft disk space limit and the soft file limit.

| [-soft-limit-thresholds ]

If this parameter is specified, the command display will include the soft disk space limit, threshold for disk space limit and soft file limit.

| [-target-id ]

If this parameter is specified, the command will display the target of a user or group quota rule in numeric form.

| [-thresholds ]

If this parameter is specified, the command display will include the threshold for disk space limit.

| [-instance ] }

If you specify the -instance parameter, the command displays detailed information about all fields.

[-vserver <vserver name>] - Vserver Name

If this parameter is specified, the command displays the quota report for volumes in the specified Vserver.

[-volume <volume name>] - Volume Name

If this parameter is specified, the command displays the quota report for the specified volume.

[-index <integer>] - Index

If this parameter is specified, the command displays the quota report for the quota rules that have the specified index.

[-tree <qtree name>] - Qtree Name

If this parameter is specified, the command displays the quota report for the quota rules that have the specified qtree name.

[-quota-type {tree|user|group}] - Quota Type

If this parameter is specified, the command displays the quota report for the quota rules of the given type.

[-quota-target <text>,…​] - Quota Target

If this parameter is specified, the command displays the quota report for the quota rules that have the specified quota target.

[-quota-target-id <text>,…​] - Quota Target ID

If this parameter is specified, the command displays the quota report for the quota rules that have the specified quota target identifier.

[-disk-used {<integer>[KB|MB|GB|TB|PB]}] - Disk Space Used

If this parameter is specified, the command displays the quota report for the quota rules that have the specified disk space used value.

[-disk-limit {<integer>[KB|MB|GB|TB|PB]}] - Disk Space Limit

If this parameter is specified, the command displays the quota report for the quota rules that have the specified disk space limit.

[-files-used <integer>] - Files Used

If this parameter is specified, the command displays the quota report for the quota rules that have the specified files used value.

[-file-limit <integer>] - Files Limit

If this parameter is specified, the command displays the quota report for the quota rules that have the specified file limit.

[-threshold {<integer>[KB|MB|GB|TB|PB]}] - Disk Space Threshold

If this parameter is specified, the command displays the quota report for the quota rules that have the specified threshold for disk space limit.

[-soft-disk-limit {<integer>[KB|MB|GB|TB|PB]}] - Soft Disk Space Limit

If this parameter is specified, the command displays the quota report for the quota rules that have the specified soft disk space limit.

[-soft-file-limit <integer>] - Soft Files Limit

If this parameter is specified, the command displays the quota report for the quota rules that have the specified soft file limit.

[-quota-specifier <text>] - Quota Specifier

If this parameter is specified, the command displays the quota report for the quota rules that have the specified quota specifier.

[-path <text>] - Path

If this parameter is specified, the command will display the quota report for the quota rules that are applicable for the file in the specified path. The format of the path to the file should begin with /vol/<volume name>/. The quota rules that are applicable typically consists of the tree quota rule corresponding to the qtree in which the file resides within the volume, user quota rule at the volume and qtree level corresponding to the UNIX user identifier or the Windows security identifier associated with the file and the group quota rule at the volume and qtree level corresponding to the UNIX group identifier associated with the file.

[-disk-used-pct-soft-disk-limit <percent_no_limit>] - Disk Space Used % Soft Disk Space Limit

If this parameter is specified, the command displays the quota report for entries that have the specified percent utilization. The attribute value is computed from disk-used and soft-disk-limit .

[-disk-used-pct-threshold <percent_no_limit>] - Disk Space Used % Disk Space Threshold

If this parameter is specified, the command displays the quota report for entries that have the specified percent utilization. The attribute value is computed from disk-used and threshold .

[-disk-used-pct-disk-limit <percent_no_limit>] - Disk Space Used % Disk Space Limit

If this parameter is specified, the command displays the quota report for entries that have the specified percent utilization. The attribute value is computed from disk-used and disk-limit .

[-files-used-pct-soft-file-limit <percent_no_limit>] - Files Used % Soft File Limit

If this parameter is specified, the command displays the quota report for entries that have the specified percent utilization. The attribute value is computed from files-used and soft-file-limit .

[-files-used-pct-file-limit <percent_no_limit>] - Files Used % File Limit

If this parameter is specified, the command displays the quota report for entries that have the specified percent utilization. The attribute value is computed from files-used and file-limit .

Examples

The following example displays the quota report for all the volumes.

cluster1::> volume quota report
Vserver: vs0
----Disk----  ----Files-----   Quota
Volume   Tree      Type    ID        Used  Limit    Used   Limit   Specifier
-------  --------  ------  -------  -----  -----  ------  ------   ---------
vol2               tree    *        0.00B  100MB       0   10000   *
vol2     vxw02     tree    3        0.00B  200MB       1   20000   vxw02
vol2               user    *        0.00B   50MB       0       -   *
vol2     vxw02     user    sam,Engr\Sammy
                                    0.00B  100MB       0       -   sam
vol2               group   *        0.00B  500MB       0       -   *
vol2     q1        tree    1          1MB  100MB       2   10000   q1
vol2     q1        user    *        0.00B   50MB       0       -
vol2     q1        group   *        0.00B  500MB       0       -
vol2     q1        group   root       1MB      -       2       -
vol2     vxw01     tree    2        0.00B  100MB       1   10000   vxw01
vol2     vxw01     user    *        0.00B   50MB       0       -
vol2     vxw01     group   *        0.00B  500MB       0       -
vol2     vxw01     group   root     0.00B      -       1       -
vol2     vxw02     user    *        0.00B   50MB       0       -
vol2     vxw02     group   *        0.00B  500MB       0       -
vol2     vxw02     group   root     0.00B      -       1       -
vol2     vxw03     tree    4        0.00B  100MB       1   10000   vxw03
vol2     vxw03     user    *        0.00B   50MB       0       -
vol2     vxw03     group   *        0.00B  500MB       0       -
vol2     vxw03     group   root     0.00B      -       1       -
vol2               group   root       1MB      -       6       -
vol2     q1        user    root,Engr\root
                                    0.00B      -       1       -
vol2     vxw01     user    root,Engr\root
                                    0.00B      -       1       -
vol2     vxw02     user    root,Engr\root
                                    0.00B      -       1       -
vol2     vxw03     user    root,Engr\root
                                    0.00B      -       1       -
vol2               user    root,Engr\root
                                    0.00B      -       5       -
vol2               user    john,Engr\John
                                      1MB   50MB       1       -   *
vol2     q1        user    john,Engr\John
                                      1MB   50MB       1       -
28 entries were displayed.

The following example displays the quota report for the quota rules that are applicable for the given path to a file.

cluster1::> volume quota report -path /vol/vol2/q1/file1
Vserver: vs0
----Disk----  ----Files-----   Quota
Volume   Tree      Type    ID        Used  Limit    Used   Limit   Specifier
-------  --------  ------  -------  -----  -----  ------  ------   ---------
vol2     q1        tree    1          1MB  100MB       2   10000   q1
vol2     q1        group   root       1MB      -       2       -
vol2               group   root       1MB      -       6       -
vol2               user    john,Engr\John
                                      1MB   50MB       1       -   *
vol2     q1        user    john,Engr\John
                                      1MB   50MB       1       -
5 entries were displayed.

The following example displays the quota report with the target in the numeric form for the given path to a file.

cluster1::> volume quota report -path /vol/vol2/q1/file1 -target-id
Vserver: vs0
----Disk----  ----Files-----   Quota
Volume   Tree      Type    ID        Used  Limit    Used   Limit   Specifier
-------  --------  ------  -------  -----  -----  ------  ------   ---------
vol2     q1        tree    1          1MB  100MB       2   10000   q1
vol2     q1        group   0          1MB      -       2       -
vol2               group   0          1MB      -       6       -
vol2               user    8017,S-1-5-21-3567637-1906459281-1427260136-60871
                                      1MB   50MB       1       -   *
vol2     q1        user    8017,S-1-5-21-3567637-1906459281-1427260136-60871
                                      1MB   50MB       1       -
5 entries were displayed.

The following example shows how to monitor the quota report for a particular user/tree/group. First, the quota report command is issued with -instance to see the index field for the quota report entry we are interested in. Next, the quota report is issued with the -index field specified to fetch only that particular quota report entry repeatedly to view the usage over time.

cluster1::> volume quota report -vserver vs0 -volume vol1 -quota-type user -quota-target john -tree q1 -instance
Vserver Name: vs0
                            Volume Name: vol1
                                  Index: 10
                             Qtree Name: q1
                             Quota Type: user
                           Quota Target: john
                        Quota Target ID: 5433
                        Disk Space Used: 50.5MB
                       Disk Space Limit: 100MB
                             Files Used: 205
                            Files Limit: -
                   Disk Space Threshold: 95MB
                  Soft Disk Space Limit: 80MB
                       Soft Files Limit: -
                        Quota Specifier: john
Disk Space Used % Soft Disk Space Limit: 63%
 Disk Space Used % Disk Space Threshold: 53%
     Disk Space Used % Disk Space Limit: 51%
           Files Used % Soft File Limit: -
                Files Used % File Limit: -

cluster1::> volume quota report -vserver vs0 -volume vol1 -index 10
Vserver Name: vs0
                            Volume Name: vol1
                                  Index: 10
                             Qtree Name: q1
                             Quota Type: user
                           Quota Target: john
                        Quota Target ID: 5433
                        Disk Space Used: 55MB
                       Disk Space Limit: 100MB
                             Files Used: 410
                            Files Limit: -
                   Disk Space Threshold: 95MB
                  Soft Disk Space Limit: 80MB
                       Soft Files Limit: -
                        Quota Specifier: john
Disk Space Used % Soft Disk Space Limit: 69%
 Disk Space Used % Disk Space Threshold: 58%
     Disk Space Used % Disk Space Limit: 55%
           Files Used % Soft File Limit: -
                Files Used % File Limit: -

cluster1::> volume quota report -vserver vs0 -volume vol1 -index 10
Vserver Name: vs0
                            Volume Name: vol1
                                  Index: 10
                             Qtree Name: q1
                             Quota Type: user
                           Quota Target: john
                        Quota Target ID: 5433
                        Disk Space Used: 60.7MB
                       Disk Space Limit: 100MB
                             Files Used: 500
                            Files Limit: -
                   Disk Space Threshold: 95MB
                  Soft Disk Space Limit: 80MB
                       Soft Files Limit: -
                        Quota Specifier: john
Disk Space Used % Soft Disk Space Limit: 76%
 Disk Space Used % Disk Space Threshold: 64%
     Disk Space Used % Disk Space Limit: 61%
           Files Used % Soft File Limit: -
                Files Used % File Limit: -