Whamcloud - gitweb
Merge "LUDOC-16 fix stale links."
[doc/manual.git] / Preface.xml
index 3d22462..50575bd 100644 (file)
@@ -1,24 +1,26 @@
 <?xml version='1.0' encoding='UTF-8'?>
-<!-- This document was created with Syntext Serna Free. -->
 <preface xmlns="http://docbook.org/ns/docbook" xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en-US">
   <title>Preface</title>
-  <para><anchor xml:id="dbdoclet.50438247_pgfId-7593" xreflabel=""/>This operations manual provides detailed information and procedures to install, configure and tune the Lustre file system. The manual covers topics such as failover, quotas, striping and bonding. The Lustre manual also contains troubleshooting information and tips to improve Lustre operation and performance.</para>
+  <para>This operations manual provides detailed information and procedures to install, configure and tune the Lustre file system. The manual covers topics such as failover, quotas, striping and bonding. The Lustre manual also contains troubleshooting information and tips to improve Lustre operation and performance.</para>
   <section remap="h2">
-    <title>
-      <anchor xml:id="dbdoclet.50438247_pgfId-4908" xreflabel=""/>
-    </title>
+    <title>About this Document</title>
+    <para>This document is maintained by Whamcloud, Inc in Docbook format. The canonical version is available at <link xl:href="http://wiki.whamcloud.com">http://wiki.whamcloud.com/</link>. </para>
+
     <section remap="h2">
       <title>UNIX Commands</title>
-      <para><anchor xml:id="dbdoclet.50438247_pgfId-4910" xreflabel=""/>This document might not contain information about basic UNIX commands and procedures such as shutting down the system, booting the system, and configuring devices. Refer to the following for this information:</para>
+      <para>This document might not contain information about basic UNIX commands and procedures such as shutting down the system, booting the system, and configuring devices. Refer to the following for this information:</para>
       <itemizedlist>
         <listitem>
-          <para><anchor xml:id="dbdoclet.50438247_pgfId-4417" xreflabel=""/> Software documentation that you received with your system</para>
+          <para> Software documentation that you received with your system</para>
         </listitem>
         <listitem>
-          <para><anchor xml:id="dbdoclet.50438247_pgfId-4418" xreflabel=""/> Oracle Solaris Operating System documentation, which is at:</para>
+          <para> Red Hat Enterprise Linux documentation, which is at:
+      <link xl:href="http://docs.redhat.com/docs/en-US/index.html">http://docs.redhat.com/docs/en-US/index.html</link></para>
+  <note><para>
+          The Lustre client module is available for many different Linux versions and distributions. Red Hat Enterprise is the best supported and tested platform for Lustre Servers.
+  </para></note>
         </listitem>
       </itemizedlist>
-      <para><anchor xml:id="dbdoclet.50438247_pgfId-4419" xreflabel=""/><link xl:href="http://www.oracle.com/technetwork/indexes/documentation/index.html">http://www.oracle.com/technetwork/indexes/documentation/index.html</link></para>
     </section>
     <section remap="h2">
       <title>Shell Prompts</title>
           <thead>
             <row>
               <entry>
-                <para><emphasis role="bold"><anchor xml:id="dbdoclet.50438247_pgfId-5160" xreflabel=""/>Shell</emphasis></para>
+                <para><emphasis role="bold">Shell</emphasis></para>
               </entry>
               <entry>
-                <para><emphasis role="bold"><anchor xml:id="dbdoclet.50438247_pgfId-5162" xreflabel=""/>Prompt</emphasis></para>
+                <para><emphasis role="bold">Prompt</emphasis></para>
               </entry>
             </row>
           </thead>
           <tbody>
             <row>
               <entry>
-                <para> <anchor xml:id="dbdoclet.50438247_pgfId-5164" xreflabel=""/>C shell</para>
+                <para> C shell</para>
               </entry>
               <entry>
-                <para> <anchor xml:id="dbdoclet.50438247_pgfId-5166" xreflabel=""/><emphasis>machine-name</emphasis>%</para>
+                <para> <emphasis>machine-name</emphasis>%</para>
               </entry>
             </row>
             <row>
               <entry>
-                <para> <anchor xml:id="dbdoclet.50438247_pgfId-5168" xreflabel=""/>C shell superuser</para>
+                <para> C shell superuser</para>
               </entry>
               <entry>
-                <para> <anchor xml:id="dbdoclet.50438247_pgfId-5170" xreflabel=""/><emphasis>machine-name</emphasis>#</para>
+                <para> <emphasis>machine-name</emphasis>#</para>
               </entry>
             </row>
             <row>
               <entry>
-                <para> <anchor xml:id="dbdoclet.50438247_pgfId-5172" xreflabel=""/>Bourne shell and Korn shell</para>
+                <para> Bourne shell and Korn shell</para>
               </entry>
               <entry>
-                <para> <anchor xml:id="dbdoclet.50438247_pgfId-5174" xreflabel=""/><prompt>$</prompt></para>
+                <para> <prompt>$</prompt></para>
               </entry>
             </row>
             <row>
               <entry>
-                <para> <anchor xml:id="dbdoclet.50438247_pgfId-5176" xreflabel=""/>Bourne shell and Korn shell superuser</para>
+                <para> Bourne shell and Korn shell superuser</para>
               </entry>
               <entry>
-                <para> <anchor xml:id="dbdoclet.50438247_pgfId-5178" xreflabel=""/><prompt>#</prompt></para>
+                <para> <prompt>#</prompt></para>
               </entry>
             </row>
           </tbody>
@@ -74,9 +76,9 @@
       </informaltable>
     </section>
     <section remap="h2">
-      <title><anchor xml:id="dbdoclet.50438247_43930" xreflabel=""/>Related Documentation</title>
-      <para><anchor xml:id="dbdoclet.50438247_pgfId-8643" xreflabel=""/>The documents listed as online are available at:</para>
-      <para><anchor xml:id="dbdoclet.50438247_pgfId-8695" xreflabel=""/><link xl:href="http://wiki.whamcloud.com/display/PUB/Documentation">http://wiki.whamcloud.com/display/PUB/Documentation</link></para>
+      <title>Related Documentation</title>
+      <para>The documents listed as online are available at:</para>
+      <para><link xl:href="http://wiki.whamcloud.com/display/PUB/Documentation">http://wiki.whamcloud.com/display/PUB/Documentation</link></para>
       <informaltable frame="all">
         <tgroup cols="4">
           <colspec colname="c1" colwidth="25*"/>
           <thead>
             <row>
               <entry>
-                <para><emphasis role="bold"><anchor xml:id="dbdoclet.50438247_pgfId-8647" xreflabel=""/>Application</emphasis></para>
+                <para><emphasis role="bold">Application</emphasis></para>
               </entry>
               <entry>
-                <para><emphasis role="bold"><anchor xml:id="dbdoclet.50438247_pgfId-8649" xreflabel=""/>Title</emphasis></para>
+                <para><emphasis role="bold">Title</emphasis></para>
               </entry>
               <entry>
-                <para><emphasis role="bold"><anchor xml:id="dbdoclet.50438247_pgfId-8651" xreflabel=""/>Format</emphasis></para>
+                <para><emphasis role="bold">Format</emphasis></para>
               </entry>
               <entry>
-                <para><emphasis role="bold"><anchor xml:id="dbdoclet.50438247_pgfId-8653" xreflabel=""/>Location</emphasis></para>
+                <para><emphasis role="bold">Location</emphasis></para>
               </entry>
             </row>
           </thead>
           <tbody>
             <row>
               <entry>
-                <para> <anchor xml:id="dbdoclet.50438247_pgfId-8655" xreflabel=""/>Latest information</para>
+                <para> Latest information</para>
               </entry>
               <entry>
-                <para> <anchor xml:id="dbdoclet.50438247_pgfId-8657" xreflabel=""/><emphasis>Lustre 2.0 Release Notes</emphasis></para>
+                <para> <emphasis>Lustre 2.0 Release Notes</emphasis></para>
               </entry>
               <entry>
-                <para> <anchor xml:id="dbdoclet.50438247_pgfId-8659" xreflabel=""/>PDF</para>
+                <para> PDF</para>
               </entry>
               <entry>
-                <para> <anchor xml:id="dbdoclet.50438247_pgfId-8663" xreflabel=""/>Online</para>
+                <para> Online</para>
               </entry>
             </row>
             <row>
               <entry>
-                <para> <anchor xml:id="dbdoclet.50438247_pgfId-8665" xreflabel=""/>Service</para>
+                <para> Service</para>
               </entry>
               <entry>
-                <para> <anchor xml:id="dbdoclet.50438247_pgfId-8667" xreflabel=""/><emphasis>Lustre 2.0 Operations Manual</emphasis></para>
+                <para> <emphasis>Lustre 2.0 Operations Manual</emphasis></para>
               </entry>
               <entry>
-                <para> <anchor xml:id="dbdoclet.50438247_pgfId-8669" xreflabel=""/>PDF</para>
-                <para><anchor xml:id="dbdoclet.50438247_pgfId-8670" xreflabel=""/>HTML</para>
+                <para> PDF</para>
+                <para>HTML</para>
               </entry>
               <entry>
-                <para> <anchor xml:id="dbdoclet.50438247_pgfId-8673" xreflabel=""/>Online</para>
+                <para> Online</para>
               </entry>
             </row>
           </tbody>
     </section>
     <section remap="h2">
       <title>Documentation, Support, and Training</title>
-      <para><anchor xml:id="dbdoclet.50438247_pgfId-8597" xreflabel=""/>These web sites provide additional resources:</para>
+      <para>These web sites provide additional resources:</para>
       <itemizedlist>
         <listitem>
-          <para><anchor xml:id="dbdoclet.50438247_pgfId-8598" xreflabel=""/> Documentation <link xl:href="http://wiki.whamcloud.com/display/PUB/Documentation">http://wiki.whamcloud.com/display/PUB/Documentation</link></para>
+          <para> Documentation <link xl:href="http://wiki.whamcloud.com/display/PUB/Documentation">http://wiki.whamcloud.com/display/PUB/Documentation</link></para>
         </listitem>
         <listitem>
-          <para><anchor xml:id="dbdoclet.50438247_pgfId-8599" xreflabel=""/> Support <link xl:href="http://www.whamcloud.com/">http://www.whamcloud.com/</link></para>
+          <para> Support <link xl:href="http://www.whamcloud.com/">http://www.whamcloud.com/</link></para>
         </listitem>
         <listitem>
-          <para><anchor xml:id="dbdoclet.50438247_pgfId-8602" xreflabel=""/> Training <link xl:href="http://www.whamcloud.com/">http://www.whamcloud.com/</link><anchor xml:id="dbdoclet.50438247_88598" xreflabel=""/><anchor xml:id="dbdoclet.50438247_83191" xreflabel=""/></para>
+          <para> Training <link xl:href="http://www.whamcloud.com/">http://www.whamcloud.com/</link></para>
         </listitem>
       </itemizedlist>
-      <para><anchor xml:id="dbdoclet.50438247_pgfId-4545" xreflabel=""/>&#160;</para>
     </section>
   </section>
+    <xi:include href="Revision.xml"  xmlns:xi="http://www.w3.org/2001/XInclude"/>
 </preface>