Creating a Quota

This section describes how to create a quota to control and collect statistics on space usage and file quantity of namespaces or dtrees.

Prerequisites

A namespace or dtree has been created.
When creating a quota for a specified user or user group, the user or user group has been created.
When creating a user or user group quota for a namespace (the Dtree parameter is left blank), the namespace is empty.
When creating a quota for a specified dtree, the dtree is empty.

Procedure

Choose Resources > Tuning > SmartQuota > Custom Quotas.
Select a desired account from the Account drop-down list in the upper left corner.
Click Create.
The Create Quota page is displayed.
Select the namespace and dtree for which you want to create a quota from the Namespace and Dtree drop-down lists, respectively.
- When creating a directory quota for a namespace, leave the Dtree parameter blank.
- If you want to create a directory quota for each dtree in a namespace (set Dtree to All dtrees), you need to create the directory quota after the namespace is created and ensure that the namespace does not contain any dtree. After the directory quota is created, it takes effect for all newly-created dtrees in the namespace, and each dtree is limited separately.
In Quota Type, select a quota type. Possible options are Directory quota, User quota, and User group quota.

Non-empty namespaces support directory quotas but not user/user group quotas. Non-empty dtrees do not support directory quotas or user/user group quotas.
- Directory quota: limits the space usage or file quantity of the namespace or dtree.
- User quota: limits the space usage or file quantity used by a single user.
  1. Click Select.
    The Select User page is displayed.
  2. Select the users for which you want to create a quota.
    - If you select All users, the quota will control the space usage or file quantity of each user, respectively.
    - If you select Specified users, the quota will control the space usage or file quantity of each specified user. Click Add. On the Add User page that is displayed, add users. Then, click OK.
      When adding users, if you set User Type to Local authentication user, select the users to be added in the list below.
      
      When adding users, if you set User Type to LDAP domain user or NIS domain user, enter the user names in the Name text box.
      
      To remove added users, click Remove on the right of a desired user, or select one or more desired users and click Remove.
    - If you select Specified user groups, the quota will control the space usage or file quantity of each user in specified user groups, respectively. Click Add. On the Add User Group page that is displayed, add user groups. Then, click OK.
      When adding user groups, if you set User Group Type to Local authentication user group, select the user groups to be added in the list below.
      
      When adding user groups, if you set User Group Type to LDAP domain user group or NIS domain user group, enter the user group names in the Name text box.
      
      To remove added user groups, click Remove on the right of a desired user group, or select one or more desired user groups and click Remove.
  3. Click OK.
- User group quota: controls the space usage or file quantity used by a single user group.
  1. Click Select.
    The Select User Group page is displayed.
  2. Select the user groups for which you want to create a quota.
    - If you select All user groups, the quota will control the space usage or file quantity of each user group, respectively.
    - Specified user groups: controls the space usage or file quantity of each specified user group. Click Add. On the Add User Group page that is displayed, add user groups. Then, click OK.
      If you set User Group Type to Local authentication user group, select the user groups to be added in the list below.
      
      If you set User Group Type to LDAP domain user group or NIS domain user group, enter the user group names in the Name text box.
      
      To remove added user groups, click Remove on the right of a desired user group, or select one or more desired user groups and click Remove.
  3. Click OK.

Set quota parameters. Table 1 describes related parameters.

**Table 1** Quota parameters
Parameter		Description
Space Quota	Hard Quota	If the used file space reaches the space hard quota, the system immediately forbids writes and reports an alarm. The file space that exceeds the hard quota cannot be used. [Value range] 1 KB to 256 PB The value must be greater than those of Soft Quota and Advisory Quota. NOTE: If the used file space reaches the hard quota, the system forbids writes. If you want the system to report an alarm before writes are forbidden, set a soft quota and an advisory quota.
	Soft Quota	If the used file space reaches the space soft quota, the system reports an alarm but still allows writes. If the soft quota grace period elapses or hard quota is reached, the system immediately forbids writes and reports an alarm. [Value range] 1 KB to 256 PB The value must be greater than that of Advisory Quota and less than that of Hard Quota.
	Advisory Quota	If the used file space reaches the space advisory quota, the system reports an alarm but still allows writes. [Value range] 1 KB to 256 PB The value must be less than those of Soft Quota and Hard Quota.
	Collect Snapshot Space Statistics	Indicates whether to collect statistics of the snapshot space included in the used file space. NOTE: This parameter is available only when Quota Type is set to Directory quota.
File Quantity Quota	Hard Quota (K)	If the number of files reaches the file quantity hard quota, the system reports an alarm and new files cannot be added. However, operations on existing files are not affected. The unit is thousands. [Value range] 1 to 100,000,000 The value must be greater than those of Soft Quota (K) and Advisory Quota (K). NOTE: If the number of files reaches the hard quota, the system forbids file adding. If you want the system to report an alarm before files cannot be added, set a soft quota and an advisory quota.
	Soft Quota (K)	If the number of files reaches the file quantity soft quota, the system reports an alarm but new files can still be added. If the soft quota grace period elapses or hard quota is reached, new files cannot be added and an alarm is reported. The unit is thousands. [Value range] 1 to 100,000,000 The value must be greater than that of Advisory Quota (K) and less than that of Hard Quota (K).
	Advisory Quota (K)	If the number of files reaches the advisory quota, the system reports an alarm but new files can still be added. [Value range] 1 to 100,000,000 The value must be less than those of Soft Quota (K) and Hard Quota (K).
Grace Period	Soft Quota Grace Period (Days)	If the used file space or number of files reaches the soft quota, the system generates an alarm but still allows writes or new files can still be added within this period. If this period elapses, the system immediately forbids writes and new files cannot be added. In addition, an alarm is reported. [Value range] 1 to 4,294,967,294. If this parameter is not specified, the grace period is unlimited. In this case, if the used file space or number of files reaches the soft quota, the system reports an alarm but does not restrict users' writing data or adding new files. NOTE: This parameter can be set only when Soft Quota or Soft Quota (K) is set.

If you do not set any quota for the space usage or file quantity, the system does not control the space usage or file quantity.

Click OK.