Whamcloud - gitweb
LUDOC-488 fallocate: Add fallocate tuning information
[doc/manual.git] / Revision.xml
index 3cb1225..33886a7 100644 (file)
 <?xml version="1.0" encoding="UTF-8"?>
-<article version="5.0" xml:lang="en-US" xmlns="http://docbook.org/ns/docbook" xmlns:xl="http://www.w3.org/1999/xlink">
-  <info>
-    <title>Revision History</title>
-  </info>
-  <informaltable frame="none">
-    <tgroup cols="2">
-      <colspec colname="c1" colwidth="50*"/>
-      <colspec colname="c2" colwidth="50*"/>
-      
-      
-      <tbody>
-        <row>
-          <entry align="left"><para>Lustre 2.0 Operations Manual</para></entry>
-          <entry align="right" valign="top"><para><link xl:href="index.html"><inlinemediaobject><imageobject role="html">
-                    <imagedata contentdepth="26" contentwidth="30" fileref="./shared/toc01.gif" scalefit="1"/>
-                  </imageobject>
-<imageobject role="fo">
-                    <imagedata contentdepth="100%" contentwidth="" depth="" fileref="./shared/toc01.gif" scalefit="1" width="100%"/>
-                  </imageobject>
-</inlinemediaobject></link><link xl:href="Preface.html"><inlinemediaobject><imageobject role="html">
-                    <imagedata contentdepth="26" contentwidth="30" fileref="./shared/prev01.gif" scalefit="1"/>
-                  </imageobject>
-<imageobject role="fo">
-                    <imagedata contentdepth="100%" contentwidth="" depth="" fileref="./shared/prev01.gif" scalefit="1" width="100%"/>
-                  </imageobject>
-</inlinemediaobject></link><link xl:href="I_LustreIntro.html"><inlinemediaobject><imageobject role="html">
-                    <imagedata contentdepth="26" contentwidth="30" fileref="./shared/next01.gif" scalefit="1"/>
-                  </imageobject>
-<imageobject role="fo">
-                    <imagedata contentdepth="100%" contentwidth="" depth="" fileref="./shared/next01.gif" scalefit="1" width="100%"/>
-                  </imageobject>
-</inlinemediaobject></link><link xl:href="ix.html"><inlinemediaobject><imageobject role="html">
-                    <imagedata contentdepth="26" contentwidth="30" fileref="./shared/index01.gif" scalefit="1"/>
-                  </imageobject>
-<imageobject role="fo">
-                    <imagedata contentdepth="100%" contentwidth="" depth="" fileref="./shared/index01.gif" scalefit="1" width="100%"/>
-                  </imageobject>
-</inlinemediaobject></link></para></entry>
-        </row>
-      </tbody>
-    </tgroup>
-  </informaltable>
-  <para><link xl:href=""/></para>
-  <informaltable frame="none">
-    <tgroup cols="1">
-      <colspec colname="c1" colwidth="100*"/>
-      
-      <tbody>
-        <row>
-          <entry align="right"><para><anchor xml:id="dbdoclet.50438248_pgfId-5717" xreflabel=""/>Revision History</para></entry>
-        </row>
-      </tbody>
-    </tgroup>
-  </informaltable>
-  <para><anchor xml:id="dbdoclet.50438248_pgfId-5752" xreflabel=""/> </para>
-   <informaltable frame="all">
-    <tgroup cols="4">
-      <colspec colname="c1" colwidth="25*"/>
-      <colspec colname="c2" colwidth="25*"/>
-      <colspec colname="c3" colwidth="25*"/>
-      <colspec colname="c4" colwidth="25*"/>
-      <thead>
-        <row>
-          <entry><para><emphasis role="bold"><anchor xml:id="dbdoclet.50438248_pgfId-997745" xreflabel=""/>BookTitle</emphasis></para></entry>
-          <entry><para><emphasis role="bold"><anchor xml:id="dbdoclet.50438248_pgfId-997747" xreflabel=""/>Part Number</emphasis></para></entry>
-          <entry><para><emphasis role="bold"><anchor xml:id="dbdoclet.50438248_pgfId-997749" xreflabel=""/>Date</emphasis></para></entry>
-          <entry><para><emphasis role="bold"><anchor xml:id="dbdoclet.50438248_pgfId-997751" xreflabel=""/>Comments</emphasis></para></entry>
-        </row>
-      </thead>
-      <tbody>
-        <row>
-          <entry><para> <anchor xml:id="dbdoclet.50438248_pgfId-997756" xreflabel=""/>Lustre 2.0 Operations Manual</para></entry>
-          <entry><para> <anchor xml:id="dbdoclet.50438248_pgfId-997758" xreflabel=""/>821-2076-10</para></entry>
-          <entry><para> <anchor xml:id="dbdoclet.50438248_pgfId-997763" xreflabel=""/>July 2010</para></entry>
-          <entry><para> <anchor xml:id="dbdoclet.50438248_pgfId-997765" xreflabel=""/>First release of Lustre 2.0 manual</para></entry>
-        </row>
-        <row>
-          <entry><para> <anchor xml:id="dbdoclet.50438248_pgfId-997955" xreflabel=""/>Lustre 2.0 Operations Manual</para></entry>
-          <entry><para> <anchor xml:id="dbdoclet.50438248_pgfId-997957" xreflabel=""/>821-2076-10</para></entry>
-          <entry><para> <anchor xml:id="dbdoclet.50438248_pgfId-997962" xreflabel=""/>January 2011</para></entry>
-          <entry><para> <anchor xml:id="dbdoclet.50438248_pgfId-997964" xreflabel=""/>Second release of Lustre 2.0 manual</para></entry>
-        </row>
-      </tbody>
-    </tgroup>
-  </informaltable>
-   <!--
-Begin SiteCatalyst code version: G.5.
--->
-  <!--
-End SiteCatalyst code version: G.5.
--->
-    <informaltable frame="none">
-    <tgroup cols="3">
-      <colspec colname="c1" colwidth="33*"/>
-      <colspec colname="c2" colwidth="33*"/>
-      <colspec colname="c3" colwidth="33*"/>
-      
-      
-      
-      <tbody>
-        <row>
-          <entry align="left"><para>Lustre 2.0 Operations Manual</para></entry>
-          <entry align="right"><para>821-2076-10</para></entry>
-          <entry align="right" valign="top"><para><link xl:href="index.html"><inlinemediaobject><imageobject role="html">
-                    <imagedata contentdepth="26" contentwidth="30" fileref="./shared/toc01.gif" scalefit="1"/>
-                  </imageobject>
-<imageobject role="fo">
-                    <imagedata contentdepth="100%" contentwidth="" depth="" fileref="./shared/toc01.gif" scalefit="1" width="100%"/>
-                  </imageobject>
-</inlinemediaobject></link><link xl:href="Preface.html"><inlinemediaobject><imageobject role="html">
-                    <imagedata contentdepth="26" contentwidth="30" fileref="./shared/prev01.gif" scalefit="1"/>
-                  </imageobject>
-<imageobject role="fo">
-                    <imagedata contentdepth="100%" contentwidth="" depth="" fileref="./shared/prev01.gif" scalefit="1" width="100%"/>
-                  </imageobject>
-</inlinemediaobject></link><link xl:href="I_LustreIntro.html"><inlinemediaobject><imageobject role="html">
-                    <imagedata contentdepth="26" contentwidth="30" fileref="./shared/next01.gif" scalefit="1"/>
-                  </imageobject>
-<imageobject role="fo">
-                    <imagedata contentdepth="100%" contentwidth="" depth="" fileref="./shared/next01.gif" scalefit="1" width="100%"/>
-                  </imageobject>
-</inlinemediaobject></link><link xl:href="ix.html"><inlinemediaobject><imageobject role="html">
-                    <imagedata contentdepth="26" contentwidth="30" fileref="./shared/index01.gif" scalefit="1"/>
-                  </imageobject>
-<imageobject role="fo">
-                    <imagedata contentdepth="100%" contentwidth="" depth="" fileref="./shared/index01.gif" scalefit="1" width="100%"/>
-                  </imageobject>
-</inlinemediaobject></link></para></entry>
-        </row>
-      </tbody>
-    </tgroup>
-  </informaltable>
-  <para><link xl:href=""/></para>
-  <para><link xl:href="copyright.html">Copyright</link> © 2011, Oracle and/or its affiliates. All rights reserved.</para>
-</article>
+<section xmlns="http://docbook.org/ns/docbook"
+ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en-US">
+  <title>Revisions</title>
+    <para>The Lustre* File System Release 2.x Operations Manual is a
+    community maintained work. Versions of the manual are continually
+    built as suggestions for changes and improvements arrive. Suggestions
+    for improvements can be submitted through the ticketing system
+    maintained at <link xl:href="https://jira.whamcloud.com/browse/LUDOC">
+    https://jira.whamcloud.com/browse/LUDOC</link>.  Instructions for
+    providing a patch to the existing manual are available at:
+    <link xl:href="http://wiki.lustre.org/Lustre_Manual_Changes">
+    http://wiki.lustre.org/Lustre_Manual_Changes</link>.</para>
+
+    <para condition="l25">This manual covers a range of Lustre 2.x software
+      releases, currently starting with the 2.5 release.  Features specific
+      to individual releases are identified within the table of contents
+      using a shorthand notation (e.g. this paragraph is tagged as a Lustre
+      2.5 specific feature so that it will be updated when the 2.5-specific
+      tagging is removed), and within the text using a distinct box.
+    </para>
+
+    <note xml:id="whichversion"><title>Which version amd I running?</title>
+    <indexterm><primary>version</primary>
+    <secondary>which version of Lustre am I running?</secondary></indexterm>
+
+    <para>The current version of Lustre that is in use on the node can be found
+    using the command <literal>lctl get_param version</literal> on any Lustre
+    client or server, for example:
+    <screen>$ lctl get_param version
+version=2.10.5
+</screen>
+    </para></note>
+
+    <para>Only the latest revision of this document is made readily available
+      because changes are continually arriving. The current and latest revision
+      of this manual is available from links maintained at:
+      <link xl:href="http://lustre.opensfs.org/documentation/">
+       http://lustre.opensfs.org/documentation/</link>.
+
+        <revhistory>
+            <revision>
+                <revnumber>0</revnumber>
+                <date>Built on <?dbtimestamp format="d B Y X"?></date>
+                <author>
+                    <orgname>Intel Corporation</orgname>
+                </author>
+                <revremark>Continuous build of Manual.</revremark>
+            </revision>
+        </revhistory>
+    </para>
+</section>
+<!--
+  vim:expandtab:shiftwidth=2:tabstop=8:
+  -->