LUDOC-394 manual: Add meaningful ref names under UnderstandingLustre.xml

[doc/manual.git] / InstallingLustre.xml

diff --git a/InstallingLustre.xml b/InstallingLustre.xml
index 6852bda..bae0684 100644 (file)
--- a/InstallingLustre.xml
+++ b/InstallingLustre.xml
@@ -1,26 +1,26 @@
 <?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>
       <para>
-        <xref linkend="dbdoclet.50438261_41900" />
+        <xref linkend="dbdoclet.lustre_installation" />
       </para>
     </listitem>
   </itemizedlist>
   <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*" />
@@ -150,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*" />
@@ -206,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*" />
@@ -249,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>
@@ -345,7 +345,7 @@ 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>
@@ -363,7 +363,7 @@ xml:id="installinglustre">
       </itemizedlist></para>
     </section>
   </section>
-  <section xml:id="dbdoclet.50438261_41900">
+  <section xml:id="dbdoclet.lustre_installation">
     <title>Lustre Software Installation Procedure</title>
     <caution>
       <para>Before installing the Lustre software, back up ALL data. The Lustre
@@ -385,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>
@@ -400,9 +400,10 @@ 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">
+      <listitem xml:id="dbdoclet.lustre_server_e2fsprogs_install">
         <para>Install the Lustre server and 
         <literal>e2fsprogs</literal> packages on all Lustre servers (MGS, MDSs,
         and OSSs).
@@ -441,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.
@@ -489,3 +491,6 @@ rpm -qa|egrep "lustre|wc"|sort
     <xref linkend="configuringlustre" />.</para>
   </section>
 </chapter>
+<!--
+  vim:expandtab:shiftwidth=2:tabstop=8:
+  -->