volume quota report

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:

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: -