diff options
Diffstat (limited to 'doc/admin-guide/en-US/admin_directory_Quota.xml')
| -rw-r--r-- | doc/admin-guide/en-US/admin_directory_Quota.xml | 19 |
1 files changed, 10 insertions, 9 deletions
diff --git a/doc/admin-guide/en-US/admin_directory_Quota.xml b/doc/admin-guide/en-US/admin_directory_Quota.xml index 8a1012a6a..83c4ff451 100644 --- a/doc/admin-guide/en-US/admin_directory_Quota.xml +++ b/doc/admin-guide/en-US/admin_directory_Quota.xml @@ -2,14 +2,14 @@ <!-- This document was created with Syntext Serna Free. --><!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "docbookV4.5/docbookx.dtd" []> <chapter id="chap-Administration_Guide-Dir_Quota"> <title>Managing Directory Quota </title> - <para>Directory quotas in GlusterFS allow you to set limits on usage of disk space by directories or volumes. -The storage administrators can control the disk space utilization at the directory and/or volume -levels in GlusterFS by setting limits to allocatable disk space at any level in the volume and directory -hierarchy. This is particularly useful in cloud deployments to facilitate utility billing model. + <para>Directory quotas in GlusterFS allow you to set limits on usage of disk space of a given directory. +The storage administrators can control the disk space utilization at the directory level in GlusterFS by setting quota limits on the given directory. If +admin sets the quota limit on the '/' of the volume, it can be treated as 'volume level quota'. GlusterFS's quota implementation can have different quota +limit set on any directory and it can be nested. This is particularly useful in cloud deployments to facilitate utility billing model. </para> <para> <note> <para>For now, only Hard limit is supported. Here, the limit cannot be exceeded and attempts to use -more disk space or inodes beyond the set limit will be denied. +more disk space beyond the set limit will be denied. </para> </note></para> <para>System administrators can also monitor the resource utilization to limit the storage for the users @@ -46,7 +46,7 @@ immediately after creating that directory. For more information on setting disk <para>For example, to enable quota on test-volume: </para> <programlisting># gluster volume quota test-volume enable -Quota is enabled on /test-volume</programlisting> +Quota is enabled on /test-volume</programlisting> <!-- why '/' here before test-volume? its volume name, not directory --> </listitem> </itemizedlist> </section> @@ -61,10 +61,10 @@ Quota is enabled on /test-volume</programlisting> <para>Disable the quota using the following command: </para> <para><command># gluster volume quota <replaceable>VOLNAME</replaceable> disable </command></para> - <para>For example, to disable quota translator on test-volume: + <para>For example, to disable quota on test-volume: </para> <programlisting># gluster volume quota test-volume disable -Quota translator is disabled on /test-volume</programlisting> +Quota translator is disabled on /test-volume</programlisting> <!-- why '/' here before test-volume? its volume name, not directory --> </listitem> </itemizedlist> </section> @@ -87,7 +87,7 @@ export directory: <programlisting># gluster volume quota test-volume limit-usage /data 10GB Usage limit has been set on /data</programlisting> <para><note> - <para>In a multi-level directory hierarchy, the strictest disk limit will be considered for enforcement. + <para>In a multi-level directory hierarchy, the minimum of disk limit in entire hierarchy will be considered for enforcement. </para> </note></para> </listitem> @@ -115,6 +115,7 @@ command: </emphasis> /Test/data 10 GB 6 GB /Test/data1 10 GB 4 GB</programlisting> +<para> NOTE that, the directory listed here is not absolute directory name, but relative path to the volume's root ('/'). For example, if 'test-volume' is mounted on '/mnt/glusterfs', then for the above example, '/Test/data' means, '/mnt/glusterfs/Test/data' </para> </listitem> <listitem> <para>Display disk limit information on a particular directory on which limit is set, using the following |