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:
-
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
oruser
orgroup
). -
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
andsoft-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
andthreshold
. [-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
anddisk-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
andsoft-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
andfile-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: -