volume quota report
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 (
treeoruserorgroup). -
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
-instanceparameter, 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-usedandsoft-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-usedandthreshold. [-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-usedanddisk-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-usedandsoft-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-usedandfile-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: -