Whamcloud - gitweb
LUDOC-243 style: Improve formatting of version tags (html)
[doc/manual.git] / Preface.xml
index a838eed..85eaf91 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>Preface</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="index.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="Revision.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.50438247_pgfId-4401" xreflabel=""/>Preface</para></entry>
-        </row>
-      </tbody>
-    </tgroup>
-  </informaltable>
-  <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>
+<?xml version='1.0' encoding='UTF-8'?>
+<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>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><anchor xml:id="dbdoclet.50438247_pgfId-4908" xreflabel=""/></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><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>
-      <itemizedlist><listitem>
-          <para><anchor xml:id="dbdoclet.50438247_pgfId-4417" xreflabel=""/> Software documentation that you received with your system</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> </para>
+        <listitem>
+          <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>
-<listitem>
-          <para><anchor xml:id="dbdoclet.50438247_pgfId-4418" xreflabel=""/> Oracle Solaris Operating System documentation, which is at:</para>
-        </listitem>
-<listitem>
-          <para> </para>
-        </listitem>
-</itemizedlist>
-      <para><anchor xml:id="dbdoclet.50438247_pgfId-4419" xreflabel=""/><link xl:href="http://docs.sun.com">http://docs.sun.com</link></para>
+      </itemizedlist>
     </section>
     <section remap="h2">
       <title>Shell Prompts</title>
-       <informaltable frame="all">
+      <informaltable frame="all">
         <tgroup cols="2">
           <colspec colname="c1" colwidth="50*"/>
           <colspec colname="c2" colwidth="50*"/>
           <thead>
             <row>
-              <entry><para><emphasis role="bold"><anchor xml:id="dbdoclet.50438247_pgfId-5160" xreflabel=""/>Shell</emphasis></para></entry>
-              <entry><para><emphasis role="bold"><anchor xml:id="dbdoclet.50438247_pgfId-5162" xreflabel=""/>Prompt</emphasis></para></entry>
+              <entry>
+                <para><emphasis role="bold">Shell</emphasis></para>
+              </entry>
+              <entry>
+                <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></entry>
-              <entry><para> <anchor xml:id="dbdoclet.50438247_pgfId-5166" xreflabel=""/><emphasis>machine-name</emphasis>%</para></entry>
+              <entry>
+                <para> C shell</para>
+              </entry>
+              <entry>
+                <para> <emphasis>machine-name</emphasis>%</para>
+              </entry>
             </row>
             <row>
-              <entry><para> <anchor xml:id="dbdoclet.50438247_pgfId-5168" xreflabel=""/>C shell superuser</para></entry>
-              <entry><para> <anchor xml:id="dbdoclet.50438247_pgfId-5170" xreflabel=""/><emphasis>machine-name</emphasis>#</para></entry>
+              <entry>
+                <para> C shell superuser</para>
+              </entry>
+              <entry>
+                <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></entry>
-              <entry><para> <anchor xml:id="dbdoclet.50438247_pgfId-5174" xreflabel=""/>$</para></entry>
+              <entry>
+                <para> Bourne shell and Korn shell</para>
+              </entry>
+              <entry>
+                <para> <prompt>$</prompt></para>
+              </entry>
             </row>
             <row>
-              <entry><para> <anchor xml:id="dbdoclet.50438247_pgfId-5176" xreflabel=""/>Bourne shell and Korn shell superuser</para></entry>
-              <entry><para> <anchor xml:id="dbdoclet.50438247_pgfId-5178" xreflabel=""/>#</para></entry>
+              <entry>
+                <para> Bourne shell and Korn shell superuser</para>
+              </entry>
+              <entry>
+                <para> <prompt>#</prompt></para>
+              </entry>
             </row>
           </tbody>
         </tgroup>
       </informaltable>
-     </section>
+    </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://docs.sun.com/app/docs/prod/lustre.fs20?l=en&amp;a=view">http://docs.sun.com/app/docs/prod/lustre.fs20?l=en&amp;a=view</link></para>
-       <informaltable frame="all">
+      <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><emphasis role="bold"><anchor xml:id="dbdoclet.50438247_pgfId-8647" xreflabel=""/>Application</emphasis></para></entry>
-              <entry><para><emphasis role="bold"><anchor xml:id="dbdoclet.50438247_pgfId-8649" xreflabel=""/>Title</emphasis></para></entry>
-              <entry><para><emphasis role="bold"><anchor xml:id="dbdoclet.50438247_pgfId-8651" xreflabel=""/>Format</emphasis></para></entry>
-              <entry><para><emphasis role="bold"><anchor xml:id="dbdoclet.50438247_pgfId-8653" xreflabel=""/>Location</emphasis></para></entry>
+              <entry>
+                <para><emphasis role="bold">Application</emphasis></para>
+              </entry>
+              <entry>
+                <para><emphasis role="bold">Title</emphasis></para>
+              </entry>
+              <entry>
+                <para><emphasis role="bold">Format</emphasis></para>
+              </entry>
+              <entry>
+                <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></entry>
-              <entry><para> <anchor xml:id="dbdoclet.50438247_pgfId-8657" xreflabel=""/><emphasis>Lustre 2.0 Release Notes</emphasis></para></entry>
-              <entry><para> <anchor xml:id="dbdoclet.50438247_pgfId-8659" xreflabel=""/>PDF</para></entry>
-              <entry><para> <anchor xml:id="dbdoclet.50438247_pgfId-8663" xreflabel=""/>Online</para></entry>
+              <entry>
+                <para> Latest information</para>
+              </entry>
+              <entry>
+                <para>
+                  <emphasis>Lustre Software Release 2.x Change Logs</emphasis></para>
+              </entry>
+              <entry>
+                <para> Wiki page</para>
+              </entry>
+              <entry>
+                <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>
-              <entry><para> <anchor xml:id="dbdoclet.50438247_pgfId-8665" xreflabel=""/>Service</para></entry>
-              <entry><para> <anchor xml:id="dbdoclet.50438247_pgfId-8667" xreflabel=""/><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></entry>
-              <entry><para> <anchor xml:id="dbdoclet.50438247_pgfId-8673" xreflabel=""/>Online</para></entry>
+              <entry>
+                <para> Service</para>
+              </entry>
+              <entry>
+                <para>
+                  <emphasis>Lustre Software Release 2.x Operations Manual</emphasis></para>
+              </entry>
+              <entry>
+                <para> PDF</para>
+                <para>HTML</para>
+              </entry>
+              <entry>
+                <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>
         </tgroup>
       </informaltable>
-     </section>
+    </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>
-      <itemizedlist><listitem>
-          <para><anchor xml:id="dbdoclet.50438247_pgfId-8598" xreflabel=""/> Documentation <link xl:href="http://docs.sun.com/">http://docs.sun.com/</link></para>
-        </listitem>
-<listitem>
-          <para> </para>
-        </listitem>
-<listitem>
-          <para><anchor xml:id="dbdoclet.50438247_pgfId-8599" xreflabel=""/> Support <link xl:href="http://www.sun.com/support/">http://www.sun.com/support/</link></para>
-        </listitem>
-<listitem>
-          <para> </para>
+      <para>These web sites provide additional resources:</para>
+      <itemizedlist>
+        <listitem>
+          <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><anchor xml:id="dbdoclet.50438247_pgfId-8602" xreflabel=""/> Training <link xl:href="http://www.sun.com/training/">http://www.sun.com/training/</link><anchor xml:id="dbdoclet.50438247_88598" xreflabel=""/><anchor xml:id="dbdoclet.50438247_83191" xreflabel=""/></para>
+        <listitem>
+          <para> Support <link xl:href="http://www.hpdd.intel.com/">http://www.hpdd.intel.com/</link></para>
         </listitem>
-<listitem>
-          <para> </para>
+        <listitem>
+          <para> Training <link xl:href="http://www.hpdd.intel.com/">http://www.hpdd.intel.com/</link></para>
         </listitem>
-</itemizedlist>
-      <para><anchor xml:id="dbdoclet.50438247_pgfId-4545" xreflabel=""/> </para>
-      <!--
-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="index.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="Revision.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>
+      </itemizedlist>
     </section>
   </section>
-</article>
+    <xi:include href="Revision.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+</preface>