Chapter 22. Limiting storage space usage on XFS with quotas

Procedure

1. Enable quotas for users:

   # mount -o uquota /dev/xvdb1 /xfs

   Replace uquota with uqnoenforce to allow usage reporting without enforcing any limits.

2. Enable quotas for groups:

   # mount -o gquota /dev/xvdb1 /xfs

   Replace gquota with gqnoenforce to allow usage reporting without enforcing any limits.

3. Enable quotas for projects:

   # mount -o pquota /dev/xvdb1 /xfs

   Replace pquota with pqnoenforce to allow usage reporting without enforcing any limits.

4. Alternatively, include the quota mount options in the /etc/fstab file. The following example shows entries in the /etc/fstab file to enable quotas for users, groups, and projects, respectively, on an XFS file system. These examples also mount the file system with read/write permissions:

   # vim /etc/fstab
   /dev/xvdb1    /xfs    xfs    rw,quota       0  0
   /dev/xvdb1    /xfs    xfs    rw,gquota      0  0
   /dev/xvdb1    /xfs    xfs    rw,prjquota    0  0

Procedure

1. Start the xfs_quota shell:

   # xfs_quota

2. Show usage and limits for the given user:

   # xfs_quota> quota username

3. Show free and used counts for blocks and inodes:

   # xfs_quota> df

4. Run the help command to display the basic commands available with xfs_quota.

   # xfs_quota> help

5. Specify q to exit xfs_quota.

   # xfs_quota> q

Procedure

1. Start the xfs_quota shell with the -x option to enable expert mode:

   # xfs_quota -x

2. Report quota information for a specific file system:

   # xfs_quota> report /path

   For example, to display a sample quota report for /home (on /dev/blockdevice), use the command report -h /home. This displays output similar to the following:

   User quota on /home (/dev/blockdevice)
   Blocks
   User ID      Used   Soft   Hard Warn/Grace
   ---------- ---------------------------------
   root            0      0      0  00 [------]
   testuser   103.4G      0      0  00 [------]

3. Modify quota limits:

   # xfs_quota> limit isoft=500m ihard=700m user /path

   For example, to set a soft and hard inode count limit of 500 and 700 respectively for user john, whose home directory is /home/john, use the following command:

   # xfs_quota -x -c 'limit isoft=500 ihard=700 john' /home/

   In this case, pass mount_point which is the mounted xfs file system.

4. Run the help command to display the expert commands available with xfs_quota -x:

   # xfs_quota> help

Procedure

1. Add the project-controlled directories to /etc/projects. For example, the following adds the /var/log path with a unique ID of 11 to /etc/projects. Your project ID can be any numerical value mapped to your project.

   # echo 11:/var/log >> /etc/projects

2. Add project names to /etc/projid to map project IDs to project names. For example, the following associates a project called logfiles with the project ID of 11 as defined in the previous step.

   # echo logfiles:11 >> /etc/projid

3. Initialize the project directory. For example, the following initializes the project directory /var:

   # xfs_quota -x -c 'project -s logfiles' /var

4. Configure quotas for projects with initialized directories:

   # xfs_quota -x -c 'limit -p bhard=1g logfiles' /var