LUDOC-495 dne: add filesystem-wide default directory striping

[doc/manual.git] / ConfiguringQuotas.xml

diff --git a/ConfiguringQuotas.xml b/ConfiguringQuotas.xml
index 46c744c..346ad60 100644 (file)
--- a/ConfiguringQuotas.xml
+++ b/ConfiguringQuotas.xml
@@ -200,7 +200,7 @@
       usage database.</para>
       <para condition="l2A">Lustre filesystems formatted with a Lustre release
       prior to 2.10 can be still safely upgraded to release 2.10, but will not
-      have project quota usage reporting functional until
+      have project quota usage reporting functional until 2.15.0 or
       <literal>tune2fs -O project</literal> is run against all ldiskfs backend
       targets. This command sets the PROJECT feature flag in the superblock and
       runs e2fsck (as a result, the target must be offline). See
@@ -213,7 +213,7 @@
         (e2fsprogs is not needed with ZFS backend). In general, we recommend
         to use the latest e2fsprogs version available on
         <link xl:href="https://downloads.whamcloud.com/public/e2fsprogs/">
-        http://downloads.whamcloud.com/public/e2fsprogs/</link>.</para>
+        https://downloads.whamcloud.com/public/e2fsprogs/</link>.</para>
         <para>The ldiskfs OSD relies on the standard Linux quota to maintain
         accounting information on disk. As a consequence, the Linux kernel
         running on the Lustre servers using ldiskfs backend must have
@@ -409,10 +409,14 @@ $ lfs quota -g eng /mnt/testfs
     <para>To limit quota usage for a specific project ID on a specific
     directory ("<literal>/mnt/testfs/dir</literal>" in this example), run:</para>
     <screen>
-$ chattr +P /mnt/testfs/dir
-$ chattr -p 1 /mnt/testfs/dir
+$ lfs project -s -p 1 -r /mnt/testfs/dir
 $ lfs setquota -p 1 -b 307200 -B 309200 -i 10000 -I 11000 /mnt/testfs
 </screen>
+    <para>  Recursively list all descendants'(of the directory) project attribute on
+    directory ("<literal>/mnt/testfs/dir</literal>" in this example), run:</para>
+    <screen>
+$ lfs project -r /mnt/testfs/dir
+</screen>
     <para>Please note that if it is desired to have
     <literal>lfs quota -p</literal> show the space/inode usage under the
     directory properly (much faster than <literal>du</literal>), then the
@@ -595,7 +599,7 @@ $ cp: writing `/mnt/testfs/foo`: Disk quota exceeded.
     <literal>lctl get_param *.*.filestotal</literal>). For more information on
     using the
     <literal>lfs df -i</literal> command and the command output, see
-    <xref linkend="dbdoclet.checking_free_space" />.</para>
+    <xref linkend="file_striping.checking_free_space" />.</para>
     <para>Unfortunately, the
     <literal>statfs</literal> interface does not report the free inode count
     directly, but instead reports the total inode and used inode counts. The
@@ -620,6 +624,11 @@ $ cp: writing `/mnt/testfs/foo`: Disk quota exceeded.
     <emphasis role="bold">servers may be required to use a patched kernel,
     </emphasis> for more information see
     <xref linkend="enabling_disk_quotas"/>.</para>
+    <para condition="l2E"><literal>df</literal> and <literal>lfs df</literal>
+    will return the amount of space available to that project rather than the
+    total filesystem space, if the project quota limit is smaller.
+    <emphasis role="bold"> Only client need be upgraded to Lustre
+    release 2.14 or later to apply this new behavior</emphasis>.</para>
   </section>
   <section xml:id="granted_cache_and_quota_limits">
     <title>