Whamcloud - gitweb
LUDOC-460 quota: statfs functionality for project quota
[doc/manual.git] / InstallingLustre.xml
index 44f44b0..c253767 100644 (file)
@@ -1,14 +1,14 @@
 <?xml version='1.0' encoding='utf-8'?>
 <chapter xmlns="http://docbook.org/ns/docbook"
-xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en-US"
-xml:id="installinglustre">
+ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en-US"
+ xml:id="installinglustre">
   <title xml:id="installinglustre.title">Installing the Lustre Software</title>
   <para>This chapter describes how to install the Lustre software from RPM
   packages. It includes:</para>
   <itemizedlist>
     <listitem>
       <para>
-        <xref linkend="dbdoclet.50438261_99193" />
+        <xref linkend="preparing_installation" />
       </para>
     </listitem>
     <listitem>
@@ -20,7 +20,7 @@ xml:id="installinglustre">
   <para>For hardware and system requirements and hardware configuration
   information, see
   <xref linkend="settinguplustresystem" />.</para>
-  <section xml:id="dbdoclet.50438261_99193">
+  <section xml:id="preparing_installation">
     <title>
     <indexterm>
       <primary>installing</primary>
@@ -43,16 +43,16 @@ xml:id="installinglustre">
           <emphasis role="bold">
             <emphasis role="italic">Lustre server packages</emphasis>
           </emphasis>. The required packages for Lustre 2.9 EL7 servers are
-         listed in the table below, where
+          listed in the table below, where
           <replaceable>ver</replaceable> refers to the Lustre release and
-         kernel version (e.g., 2.9.0-1.el7) and
+          kernel version (e.g., 2.9.0-1.el7) and
           <replaceable>arch</replaceable> refers to the processor architecture
           (e.g., x86_64). These packages are available in the
           <link xl:href="https://wiki.whamcloud.com/display/PUB/Lustre+Releases">
           Lustre Releases</link> repository, and may differ depending on
-         your distro and version.</para>
+          your distro and version.</para>
           <para>
-            <table frame="all" xml:id="table_cnh_5m3_gk">
+            <table frame="all" xml:id="table.installed_server_pkg">
               <title>Packages Installed on Lustre Servers</title>
               <tgroup cols="2">
                 <colspec colname="c1" colnum="1" colwidth="1.18*" />
@@ -129,9 +129,10 @@ xml:id="installinglustre">
                     <entry>
                       <code>lustre-tests-<replaceable>ver</replaceable>_lustre.<replaceable>arch</replaceable></code>
                     </entry>
-                    <entry>Lustre I/O Kit benchmarking tools
-                    <emphasis role="italic">(Included in Lustre software as of
-                    release 2.2)</emphasis></entry>
+                    <entry>Scripts and programs used for running regression
+                   tests for Lustre, but likely only of interest to
+                   Lustre developers or testers.
+                    </entry>
                   </row>
                 </tbody>
               </tgroup>
@@ -149,7 +150,7 @@ xml:id="installinglustre">
           <link xl:href="https://wiki.whamcloud.com/display/PUB/Lustre+Releases">
           Lustre Releases</link> repository.</para>
           <para>
-            <table frame="all" xml:id="table_j3r_ym3_gk">
+            <table frame="all" xml:id="table.installed_client_pkg">
               <title>Packages Installed on Lustre Clients</title>
               <tgroup cols="2">
                 <colspec colname="c1" colnum="1" colwidth="1*" />
@@ -205,7 +206,7 @@ xml:id="installinglustre">
           see 
           <xref xmlns:xlink="http://www.w3.org/1999/xlink"
           linkend="understandinglustrenetworking" />.</para>
-          <table frame="all" xml:id="table_bkx_dn3_gk">
+          <table frame="all" xml:id="supported_network_types">
             <title>Network Types Supported by Lustre LNDs</title>
             <tgroup cols="2">
               <colspec colname="c1" colnum="1" colwidth="1*" />
@@ -248,7 +249,7 @@ xml:id="installinglustre">
               <emphasis role="italic">High availability software</emphasis>
             </emphasis>. If needed, install third party high-availability
             software. For more information, see 
-            <xref linkend="dbdoclet.50438188_92688" />.</para>
+            <xref linkend="failover_setup" />.</para>
           </listitem>
           <listitem>
             <para>
@@ -313,21 +314,6 @@ xml:id="installinglustre">
           <para>
           <emphasis role="italic">(Required)</emphasis>
           <emphasis role="italic">
-            <emphasis role="bold">Disable Security-Enhanced Linux
-            <superscript>*</superscript>(SELinux) on all Lustre servers 
-            </emphasis>
-          </emphasis>The Lustre software does not support SELinux. Therefore,
-          the SELinux system extension must be disabled on all Lustre nodes.
-          Also, make sure other security extensions (such as the Novell
-          AppArmor
-          <superscript>*</superscript>security system) and network packet
-          filtering tools (such as iptables) do not interfere with the Lustre
-          software.</para>
-        </listitem>
-        <listitem>
-          <para>
-          <emphasis role="italic">(Required)</emphasis>
-          <emphasis role="italic">
             <emphasis role="bold">Use the same user IDs (UID) and group IDs
             (GID) on all clients.</emphasis>
           </emphasis>If use of supplemental groups is required, see 
@@ -359,7 +345,20 @@ xml:id="installinglustre">
           timestamps. We recommend that you use Network Time Protocol (NTP) to
           keep client and server clocks in sync with each other. For more
           information about NTP, see: 
-          <link xl:href="http://www.ntp.org/">http://www.ntp.org</link>.</para>
+          <link xl:href="https://www.ntp.org/">https://www.ntp.org</link>.</para>
+        </listitem>
+        <listitem>
+          <para>
+          <emphasis role="italic">(Recommended)</emphasis>
+          <emphasis role="italic">
+            <emphasis role="bold">Make sure security extensions</emphasis>
+           </emphasis>
+           (such as the Novell AppArmor <superscript>*</superscript>security
+           system) and
+         <emphasis role="italic">
+            <emphasis role="bold">network packet filtering tools</emphasis>
+         </emphasis>
+           (such as iptables) do not interfere with the Lustre software.</para>
         </listitem>
       </itemizedlist></para>
     </section>
@@ -386,7 +385,7 @@ xml:id="installinglustre">
           <listitem>
             <para>For software and environmental requirements, see the section 
             <xref xmlns:xlink="http://www.w3.org/1999/xlink"
-            linkend="dbdoclet.50438261_99193" />above.</para>
+             linkend="preparing_installation" />above.</para>
           </listitem>
         </itemizedlist>
       </listitem>
@@ -401,7 +400,8 @@ xml:id="installinglustre">
         <link xl:href="https://wiki.whamcloud.com/display/PUB/Lustre+Releases">
         Lustre Releases</link> repository. See 
         <xref xmlns:xlink="http://www.w3.org/1999/xlink"
-        linkend="table_cnh_5m3_gk" />for a list of required packages.</para>
+         linkend="table.installed_server_pkg" />for a list of required packages.
+        </para>
       </listitem>
       <listitem xml:id="dbdoclet.50438261_88296">
         <para>Install the Lustre server and 
@@ -442,7 +442,8 @@ rpm -qa|egrep "lustre|wc"|sort
         <link xl:href="https://wiki.whamcloud.com/display/PUB/Lustre+Releases">
         Lustre Releases</link> repository. See 
         <xref xmlns:xlink="http://www.w3.org/1999/xlink"
-        linkend="table_j3r_ym3_gk" />for a list of required packages.</para>
+         linkend="table.installed_client_pkg" />for a list of required packages.
+        </para>
       </listitem>
       <listitem>
         <para>Install the Lustre client packages on all Lustre clients.
@@ -490,3 +491,6 @@ rpm -qa|egrep "lustre|wc"|sort
     <xref linkend="configuringlustre" />.</para>
   </section>
 </chapter>
+<!--
+  vim:expandtab:shiftwidth=2:tabstop=8:
+  -->