volume quota show

Display quota state for volumes

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

Description

This command displays information about quotas for online volumes. The command output depends on the parameters specified with the command. Quotas can only be administered on FlexVol volumes. If no parameters are specified, the command displays the following information for all volumes:
  • Vserver name
  • Volume name
  • Quota state - quota state for this volume. The possible values are as follows:
    • off - this state indicates that quotas are deactivated for the volume.
    • on - this state indicates that quotas are activated for the volume.
    • initializing - this state indicates that quotas are being initialized for the volume.
    • resizing - this state indicates that quota limits are being resized for the volume.
    • corrupt - this state indicates that quotas are corrupt for this volume.
    • mixed - this state may only occur for FlexGroups, and indicates that the constituent volumes are not all in the same state.
  • Scan status - percentage of the files in the volume scanned by the quota scanner that runs as part of activating quotas.
  • Last error - most recently generated error message as part of the last quota operation (on or resize). Present only if an error has been generated.
To display detailed information about all volumes, run the command with the -instance parameter. The detailed view provides all of the information in the previous list and the following additional information:
  • Logging messages - whether quota exceeded syslog/EMS messages are logged or not. For volumes where the quota logging parameter is set to on, quota exceeded messages are generated when a NFS/CIFS operation or any internal Data ONTAP operation is being prevented because the quota disk usage is exceeding the disk limit or the quota file usage is exceeding the file limit. For quotas where the logging parameter is set to off, no quota exceeded messages are generated.
  • Logging interval - frequency with which quota exceeded messages are logged. This parameter only applies to volumes that have the logging parameter set to on.
  • Sub status - additional status about quotas for this volume. Following are the possible values reported:
    • upgrading - this indicates that the quota metadata format is being upgraded from an older version to a newer version for the volume.
    • setup - this indicates that the quotas are being setup on the volume.
    • transferring rules - this indicates that the quota rules are being transferred to the volume.
    • scanning - this indicates that the quota filesystem scanner is currently running on the volume.
    • finishing - this indicates that the quota on or resize operation is in the final stage of the operation.
    • done - this indicates that the quota operation is finished.
    • none - this indicates that there is no additional status.
  • All errors - collection of all the error messages generated as part of the last quota operation (on or resize) since the volume was online.
  • User quota enforced (advanced privilege only) - indicates whether there are user quota rules being enforced.
  • Group quota enforced (advanced privilege only)- indicates whether there are group quota rules being enforced.
  • Tree quota enforced (advanced privilege only) - indicates whether there are tree quota rules being enforced.

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.
| [-logmsg ]
If this parameter is specified, the command displays whether quota exceeded messages are logged and the logging interval for the quota messages.
| [-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 information for the volumes in the specified Vserver.
[-volume <volume name>] - Volume Name
If this parameter is specified, the command displays information for the specified volume.
[-state <quota_state>] - Quota State
If this parameter is specified, the command displays information for the volumes that have the specified quota state.
[-scan-status <percent>] - Scan Status
If this parameter is specified, the command displays information about the volumes whose scan-status matches the specified percentage value. The scan status is displayed in the format [0-100]%.
[-logging {on|off}] - Logging Messages
If this parameter is specified, the command displays information about the volumes that have the specified logging setting.
[-logging-interval <text>] - Logging Interval
If this parameter is specified, the command displays information about the volumes that have the specified quota logging interval.
[-sub-status <text>] - Sub Quota Status
If this parameter is specified, the command displays information about the volumes that have the specified quota sub-status.
[-last-error <text>] - Last Quota Error Message
If this parameter is specified, the command displays information about the volumes whose last error matches the specified error message.
[-errors <text>] - Collection of Quota Errors
If this parameter is specified, the command displays information about the volumes whose collection of errors match the specified error message.
[-is-user-quota-enforced {true|false}] - User Quota enforced (privilege: advanced)
If this parameter is specified, the command displays information about the volumes that have the specified value for this field.
[-is-group-quota-enforced {true|false}] - Group Quota enforced (privilege: advanced)
If this parameter is specified, the command displays information about the volumes that have the specified value for this field.
[-is-tree-quota-enforced {true|false}] - Tree Quota enforced (privilege: advanced)
If this parameter is specified, the command displays information about the volumes that have the specified value for this field.

Examples

The following example displays information about all volumes on the Vserver named vs0.
cluster1::> volume quota show -vserver vs0
                                          Scan
Vserver    Volume        State            Status
---------  ------------  ---------------  ------
vs0        root_vs0      off                   -
vs0        vol1          off                   -
        Last Error: Volume vol1 has no valid quota rules
vs0        vol2          on                    -
vs0        vol3          initializing        30%
4 entries were displayed.
    

The following example displays the logging information for all the volumes.

cluster1::> volume quota show -logmsg
                                          Logging   Logging
Vserver    Volume        State            Message   Interval
---------  ------------  ---------------  -------   --------
vs0        root_vs0      off              -                -
vs0        vol1          off              -                -
vs0        vol2          on               on              1h
vs0        vol3          on               on              1h
4 entries were displayed.
    

The following example displays detailed information in advanced privilege for a volume vol1, which exists on Vserver vs0

cluster1::> set advanced

Warning: These advanced commands are potentially dangerous; use them only when
directed to do so by NetApp personnel.
Do you want to continue? {y|n}: y

cluster1::*> volume quota show -instance -vserver vs0 -volume vol1

              Vserver Name: vs0
               Volume Name: vol1
               Quota State: on
               Scan Status: -
          Logging Messages: on
          Logging Interval: 1h
          Sub Quota Status: none
  Last Quota Error Message: -
Collection of Quota Errors: -
       User Quota enforced: true
      Group Quota enforced: false
       Tree Quota enforced: false
    

The following example displays detailed information in advanced privilege for a volume vol1, which exists on Vserver vs0

cluster1::> set advanced

Warning: These advanced commands are potentially dangerous; use them only when
directed to do so by NetApp personnel.
Do you want to continue? {y|n}: y

cluster1::*> volume quota show -instance -vserver vs0 -volume vol1

              Vserver Name: vs0
               Volume Name: vol1
               Quota State: on
               Scan Status: -
          Logging Messages: on
          Logging Interval: 1h
          Sub Quota Status: none
  Last Quota Error Message: -
Collection of Quota Errors: -
       User Quota enforced: true
      Group Quota enforced: false
       Tree Quota enforced: false
    

The following example displays the detailed information when quotas are upgrading for volume vol1, which exists on Vserver vs0.

cluster1::> volume quota show -instance -vserver vs0 -volume vol1

              Vserver Name: vs0
               Volume Name: vol1
               Quota State: initializing
               Scan Status: 3%
          Logging Messages: -
          Logging Interval: -
          Sub Quota Status: upgrading
  Last Quota Error Message: -
Collection of Quota Errors: -
    

The following example displays the "Last Quota Error Message" and the "Collection of Quota Errors" for volume vol1, which exists on Vserver vs0

cluster1::> volume quota show -instance -vserver vs0 -volume vol1
	      Vserver Name: vs0
	       Volume Name: vol1
	       Quota State: on
	       Scan Status: -
	  Logging Messages: on
	  Logging Interval: 1h
	  Sub Quota Status: none
  Last Quota Error Message: second definition for user2 (type:user target:user2,user4 qtree:"").
Collection of Quota Errors: second definition for user1 (type:user target:user1,user3 qtree:"").
                            second definition for user2 (type:user target:user2,user4 qtree:"").