summaryrefslogtreecommitdiffstats
path: root/doc/admin-guide/en-US/admin_directory_Quota.xml
diff options
context:
space:
mode:
Diffstat (limited to 'doc/admin-guide/en-US/admin_directory_Quota.xml')
-rw-r--r--doc/admin-guide/en-US/admin_directory_Quota.xml19
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