LUDOC-394 manual: Add meaningful ref names under InstallingLustre.xml

[doc/manual.git] / UserUtilities.xml

diff --git a/UserUtilities.xml b/UserUtilities.xml
index 238b216..44fd0c6 100644 (file)
--- a/UserUtilities.xml
+++ b/UserUtilities.xml
@@ -4,7 +4,7 @@
  xmlns:xi="http://www.w3.org/2001/XInclude" xml:id="userutilities">
   <title xml:id="userutilities.title">User Utilities</title>
   <para>This chapter describes user utilities.</para>
-  <section xml:id="dbdoclet.50438206_94597">
+  <section xml:id="userutilities.lfs">
     <title>
       <indexterm>
         <primary>lfs</primary>
@@ -84,10 +84,11 @@ lfs help
         <literal>-v</literal> option with 
         <literal>lfs quota</literal>.</para>
       </note>
-      <para condition="l24">
-       The <literal>quotacheck</literal>, <literal>quotaon</literal> and <literal>quotaoff</literal>
-       sub-commands were deprecated in the Lustre 2.4 release, and removed completely in
-       the Lustre 2.8 release.  See <xref linkend="enabling_disk_quotas"/> for details on
+      <para condition="l28">
+       The <literal>quotacheck</literal>, <literal>quotaon</literal> and
+       <literal>quotaoff</literal> sub-commands were deprecated in the
+       Lustre 2.4 release, and removed completely in the Lustre 2.8 release.
+       See <xref linkend="enabling_disk_quotas"/> for details on
        configuring and checking quotas.
       </para>
     </section>
@@ -271,17 +272,25 @@ lfs help
                 guarantee that 
                 <literal>atime</literal> is kept coherent across the
                 cluster.)</para>
-                <para>OSTs store a transient 
+                <para>OSTs by default only hold a transient 
                 <literal>atime</literal> that is updated when clients do read
                 requests. Permanent 
-                <literal>atime</literal> is written to the MDS when the file is
+                <literal>atime</literal> is written to the MDT when the file is
                 closed. However, on-disk atime is only updated if it is more
                 than 60 seconds old (
-                <literal>/proc/fs/lustre/mds/*/max_atime_diff</literal>). The
-                Lustre software considers the latest 
-                <literal>atime</literal> from all OSTs. If a 
+                <literal>mdd.*.atime_diff</literal>).
+                </para>
+                <para condition='l2D'>In Lustre 2.14, it is possible to set
+                the OSTs to persistently store atime with each object, in
+                order to get more accurate persistent atime updates for files
+                that are open for a long time via the similarly-named
+                <literal>obdfilter.*.atime_diff</literal> parameter.
+                </para>
+                <para>
+                The client considers the latest <literal>atime</literal> from
+                all OSTs and MDTs. If a 
                 <literal>setattr</literal> is set by user, then it is updated on
-                both the MDS and OST, allowing the 
+                both the MDT and OST, allowing the 
                 <literal>atime</literal> to go backward.</para>
               </entry>
             </row>
@@ -1245,7 +1254,7 @@ $ lfs find /test -obd test-OST0004 -size +4G -mtime +1 | lfs_migrate -y
     <section remap="h5">
       <title>See Also</title>
       <para>
-        <xref linkend="dbdoclet.50438206_94597" />
+        <xref linkend="userutilities.lfs" />
       </para>
     </section>
   </section>
@@ -1594,4 +1603,6 @@ RPC:/0/0 rc 0
 </screen>
   </section>
 </chapter>
-<!--vim:expandtab:shiftwidth=2:tabstop=8:-->
+<!--
+  vim:expandtab:shiftwidth=2:tabstop=8:
+  -->