Whamcloud - gitweb
LUDOC-263 wrap: wrap lines for review convenience.
[doc/manual.git] / Preface.xml
index d92129f..85eaf91 100644 (file)
@@ -1,24 +1,35 @@
 <?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>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>The <emphasis role="italic">Lustre<superscript>*</superscript>Software Release 2.x
+      Operations Manual</emphasis> provides detailed information and procedures to install,
+    configure and tune a Lustre file system. The manual covers topics such as failover, quotas,
+    striping, and bonding. This manual also contains troubleshooting information and tips to improve
+    the operation and performance of a Lustre file system.</para>
   <section remap="h2">
-    <title>
-      
-    </title>
+    <title>About this Document</title>
+    <para>This document is maintained by Intel in Docbook format. The
+    canonical version is available at
+    <link xl:href="http://wiki.hpdd.intel.com/display/PUB/Documentation">http://wiki.hpdd.intel.com/display/PUB/Documentation</link>. </para>
+
     <section remap="h2">
-      <title>UNIX Commands</title>
-      <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>
+      <title>UNIX<superscript>*</superscript> Commands</title>
+      <para>This document may not contain information about basic UNIX<superscript>*</superscript>
+        operating system 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> Software documentation that you received with your system</para>
         </listitem>
         <listitem>
-          <para> Oracle Solaris Operating System documentation, which is at:</para>
+          <para> Red Hat<superscript>*</superscript> Enterprise Linux<superscript>*</superscript>
+            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<superscript>*</superscript>
+              versions and distributions. The Red Hat Enterprise Linux distribution is the best
+              supported and tested platform for Lustre servers. </para></note>
         </listitem>
       </itemizedlist>
-      <para><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>
       </informaltable>
     </section>
     <section remap="h2">
-      <title><anchor xml:id="dbdoclet.50438247_43930" xreflabel=""/>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>
+      <title>Related Documentation</title>
       <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*"/>
+          <colspec colname="c3" colwidth="15*"/>
+          <colspec colname="c4" colwidth="35*"/>
           <thead>
             <row>
               <entry>
                 <para> Latest information</para>
               </entry>
               <entry>
-                <para> <emphasis>Lustre 2.0 Release Notes</emphasis></para>
+                <para>
+                  <emphasis>Lustre Software Release 2.x Change Logs</emphasis></para>
               </entry>
               <entry>
-                <para> PDF</para>
+                <para> Wiki page</para>
               </entry>
               <entry>
-                <para> Online</para>
+                <para> Online at <link
+                    xl:href="http://wiki.hpdd.intel.com/display/PUB/Documentation"
+                    >http://wiki.hpdd.intel.com/display/PUB/Documentation</link></para>
               </entry>
             </row>
             <row>
                 <para> Service</para>
               </entry>
               <entry>
-                <para> <emphasis>Lustre 2.0 Operations Manual</emphasis></para>
+                <para>
+                  <emphasis>Lustre Software Release 2.x Operations Manual</emphasis></para>
               </entry>
               <entry>
                 <para> PDF</para>
                 <para>HTML</para>
               </entry>
               <entry>
-                <para> Online</para>
+                <para> Online at <link
+                    xl:href="http://wiki.hpdd.intel.com/display/PUB/Documentation"
+                    >http://wiki.hpdd.intel.com/display/PUB/Documentation</link></para>
               </entry>
             </row>
           </tbody>
       <para>These web sites provide additional resources:</para>
       <itemizedlist>
         <listitem>
-          <para> 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.hpdd.intel.com/display/PUB/Documentation">http://wiki.hpdd.intel.com/display/PUB/Documentation</link></para>
         </listitem>
         <listitem>
-          <para> Support <link xl:href="http://www.whamcloud.com/">http://www.whamcloud.com/</link></para>
+          <para> Support <link xl:href="http://www.hpdd.intel.com/">http://www.hpdd.intel.com/</link></para>
         </listitem>
         <listitem>
-          <para> 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.hpdd.intel.com/">http://www.hpdd.intel.com/</link></para>
         </listitem>
       </itemizedlist>
-      <para>&#160;</para>
     </section>
   </section>
+    <xi:include href="Revision.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
 </preface>