Examples of quota enforcement for FlexGroup volumes

You can use the examples to understand how to configure quotas with limits in ONTAP 9.5 and later.

Example 1: Enforcing a quota rule with disk limits

  1. You should create a quota policy rule of type user with both an achievable soft disk limit and hard disk limit.
    cluster1::> volume quota policy rule create -vserver vs0 -policy-name default -volume FG -type user -target "" -qtree "" -disk-limit 1T -soft-disk-limit 800G
  2. You can view the quota policy rule by entering the following command:
    cluster1::> volume quota policy rule show -vserver vs0 -policy-name default -volume FG
    
    Vserver: vs0               Policy: default           Volume: FG
    
                                                   Soft             Soft
                             User         Disk     Disk   Files    Files
    Type   Target    Qtree   Mapping     Limit    Limit   Limit    Limit  Threshold
    -----  --------  ------- -------  --------  -------  ------  -------  ---------
    user   ""        ""      off           1TB    800GB       -        -          -
    
  3. To activate the new quota rule, you initialize quotas on the volume by entering the following command:
    cluster1::> volume quota on -vserver vs0 -volume FG -foreground true
    [Job 49] Job succeeded: Successful
  4. You can view the disk usage and file usage information of the FlexGroup volume by using the quota report.
    cluster1::> volume quota report -vserver vs0 -volume FG
    Vserver: vs0
    
                                        ----Disk----  ----Files-----   Quota
    Volume   Tree      Type    ID        Used  Limit    Used   Limit   Specifier
    -------  --------  ------  -------  -----  -----  ------  ------   ---------
    FG                 user    root      50GB      -       1       -
    FG                 user    *         800GB    1TB      0       -   *
    2 entries were displayed.
    

After the hard disk limit is reached, the quota policy rule target (user, in this case) is blocked from writing more data to the files.

Example 2: Enforcing a quota rule for multiple users

  1. You should create a quota policy rule of type user, where multiple users are specified in the quota target (UNIX users, CIFS users, or a combination of both) and where the rule has both an achievable soft disk limit and hard disk limit.
    cluster1::> quota policy rule create -vserver vs0 -policy-name default -volume FG -type user -target "rdavis,ABCCORP\RobertDavis" -qtree "" -disk-limit 1TB -soft-disk-limit  800GB
  2. You can view the quota policy rule by entering the following command:
    cluster1::> quota policy rule show -vserver vs0 -policy-name default -volume FG
    
    Vserver: vs0               Policy: default           Volume: FG
    
                                                   Soft             Soft
                             User         Disk     Disk   Files    Files
    Type   Target    Qtree   Mapping     Limit    Limit   Limit    Limit  Threshold
    -----  --------  ------- -------  --------  -------  ------  -------  ---------
    user   "rdavis,ABCCORP\RobertDavis"  "" off  1TB  800GB  -  -  
    
  3. To activate the new quota rule, you initialize quotas on the volume by entering the following command:
    cluster1::> volume quota on -vserver vs0 -volume FG -foreground true
    [Job 49] Job succeeded: Successful
    
  4. You can verify that the quota state is active by entering the following command:
    cluster1::> volume quota show -vserver vs0 -volume FG
                  Vserver Name: vs0
                   Volume Name: FG
                   Quota State: on
                   Scan Status: -
              Logging Messages: on
              Logging Interval: 1h
              Sub Quota Status: none
      Last Quota Error Message: -
    Collection of Quota Errors: -
    
  5. You can view the disk usage and file usage information of the FlexGroup volume by using the quota report.
    cluster1::> quota report -vserver vs0 -volume FG
    Vserver: vs0
    
                                        ----Disk----  ----Files-----   Quota
    Volume   Tree      Type    ID        Used  Limit    Used   Limit   Specifier
    -------  --------  ------  -------  -----  -----  ------  ------   ---------
    FG                 user    rdavis,ABCCORP\RobertDavis  0B  1TB  0  -   rdavis,ABCCORP\RobertDavis
    

    The quota limit is shared among all users listed in the quota target.

After the hard disk limit is reached, users listed in the quota target are blocked from writing more data to the files.

Example 3: Enforcing quota with user mapping enabled

  1. You should create a quota policy rule of type user, specify a UNIX user or a Windows user as the quota target with user-mapping set to on, and create the rule with both an achievable soft disk limit and hard disk limit.

    The mapping between UNIX and Windows users must be configured earlier by using the vserver name-mapping create command.

    cluster1::> quota policy rule create -vserver vs0 -policy-name default -volume FG -type user -target rdavis -qtree "" -disk-limit 1TB -soft-disk-limit  800GB -user-mapping on
  2. You can view the quota policy rule by entering the following command:
    cluster1::> quota policy rule show -vserver vs0 -policy-name default -volume FG
    
    Vserver: vs0               Policy: default           Volume: FG
    
                                                   Soft             Soft
                             User         Disk     Disk   Files    Files
    Type   Target    Qtree   Mapping     Limit    Limit   Limit    Limit  Threshold
    -----  --------  ------- -------  --------  -------  ------  -------  ---------
    user   rdavis    ""      on           1TB    800GB       -        -          -
  3. To activate the new quota rule, you initialize quotas on the volume by entering the following command:
    cluster1::> volume quota on -vserver vs0 -volume FG -foreground true
    [Job 49] Job succeeded: Successful
    
  4. You can verify that the quota state is active by entering the following command:
    cluster1::> volume quota show -vserver vs0 -volume FG
                  Vserver Name: vs0
                   Volume Name: FG
                   Quota State: on
                   Scan Status: -
              Logging Messages: on
              Logging Interval: 1h
              Sub Quota Status: none
      Last Quota Error Message: -
    Collection of Quota Errors: -
    
  5. You can view the disk usage and file usage information of the FlexGroup volume by using the quota report.
    cluster1::> quota report -vserver vs0 -volume FG
    Vserver: vs0
    
                                        ----Disk----  ----Files-----   Quota
    Volume   Tree      Type    ID        Used  Limit    Used   Limit   Specifier
    -------  --------  ------  -------  -----  -----  ------  ------   ---------
    FG                 user    rdavis,ABCCORP\RobertDavis  0B  1TB  0  -   rdavis

    The quota limit is shared between the user listed in the quota target and its corresponding Windows or UNIX user.

After the hard disk limit is reached, both the user listed in the quota target and its corresponding Windows or UNIX user is blocked from writing more data to the files.

Example 4: Verifying the qtree size when quota is enabled

  1. You should create a quota policy rule of type tree and where the rule has both an achievable soft disk limit and hard disk limit.
    cluster1::> quota policy rule create -vserver vs0 -policy-name default -volume FG -type tree -target tree_4118314302 -qtree "" -disk-limit 48GB -soft-disk-limit 30GB
  2. You can view the quota policy rule by entering the following command:
    cluster1::> quota policy rule show -vserver vs0
    
    Vserver: vs0               Policy: default           Volume: FG
    
                                                   Soft             Soft
                             User         Disk     Disk   Files    Files
    Type   Target    Qtree   Mapping     Limit    Limit   Limit    Limit  Threshold
    -----  --------  ------- -------  --------  -------  ------  -------  ---------
    tree   tree_4118314302  "" -          48GB        -      20        -          
    
  3. To activate the new quota rule, you initialize quotas on the volume by entering the following command:
    cluster1::> volume quota on -vserver vs0 -volume FG -foreground true
    [Job 49] Job succeeded: Successful
    
    1. You can view the disk usage and file usage information of the FlexGroup volume by using the quota report.
      cluster1::> quota report -vserver vs0
      Vserver: vs0
      ----Disk---- ----Files----- Quota
      Volume Tree Type ID Used Limit Used Limit Specifier
      ------- -------- ------ ------- ----- ----- ------ ------ ---------
      FG tree_4118314302 tree 1 30.35GB 48GB 14 20 tree_4118314302

      The quota limit is shared between the user listed in the quota target and its corresponding Windows or UNIX user.

  4. From an NFS client, use the df command to view the total space usage, available space, and the used space.
    scsps0472342001# df -m /t/10.53.2.189/FG-3/tree_4118314302
    Filesystem 1M-blocks Used Available Use% Mounted on
    10.53.2.189/FG-3 49152 31078 18074 63% /t/10.53.2.189/FG-3
    

    With hard limit, the space usage is calculated from an NFS client as follows:

    • Total space usage = hard limit for tree
    • Free space = Hard limit minus qtree space usage

    Without hard limit, the space usage is calculated from an NFS client as follows:

    • Space usage = quota usage
    • Total space = Sum of quota usage and physical free space in the volume
  5. From the SMB share, use Windows Explorer to view the total space usage, available space, and the used space.

    From an SMB share, you should be aware of the following considerations for calculating the space usage:

    • The user quota hard limit for the user and group is taken into consideration for calculating the total available space.
    • The minimum value among the free space of the tree quota rule, the user quota rule, and the group quota rule is considered as the free space for the SMB share.
    • The total space usage is variable for SMB and depends on the hard limit that corresponds to the minimum free space among the tree, user, and group.