Whamcloud - gitweb
LU-8066 misc: replace remaining /proc access with lctl
[doc/manual.git] / ConfiguringLustre.xml
index 13e3106..7f13356 100644 (file)
@@ -1,7 +1,7 @@
 <?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="configuringlustre">
+ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en-US"
+ xml:id="configuringlustre">
   <title xml:id="configuringlustre.title">Configuring a Lustre File
   System</title>
   <para>This chapter shows how to configure a simple Lustre file system
@@ -67,18 +67,18 @@ xml:id="configuringlustre">
       </listitem>
       <listitem>
         <para>
-        <emphasis>Set</emphasis>lnet 
-        <emphasis>module parameters to specify how Lustre Networking (LNET) is
-        to be configured to work with a Lustre file system and test the LNET
-        configuration.</emphasis>LNET will, by default, use the first TCP/IP
+        <emphasis>Set</emphasis> lnet 
+        <emphasis>module parameters to specify how Lustre Networking (LNet) is
+        to be configured to work with a Lustre file system and test the LNet
+        configuration.</emphasis>LNet will, by default, use the first TCP/IP
         interface it discovers on a system. If this network configuration is
-        sufficient, you do not need to configure LNET. LNET configuration is
+        sufficient, you do not need to configure LNet. LNet configuration is
         required if you are using InfiniBand or multiple Ethernet
         interfaces.</para>
       </listitem>
     </itemizedlist>
-    <para>For information about configuring LNET, see 
-    <xref linkend="configuringlnet" />. For information about testing LNET, see
+    <para>For information about configuring LNet, see 
+    <xref linkend="configuringlnet" />. For information about testing LNet, see
     
     <xref linkend="lnetselftest" />.</para>
     <itemizedlist>
@@ -127,8 +127,7 @@ mkfs.lustre --fsname=
         </note>
       </listitem>
       <listitem xml:id="dbdoclet.addmdtindex">
-        <para>Optional for Lustre software release 2.4 and later. Add in
-        additional MDTs.</para>
+        <para>Optionally add in additional MDTs.</para>
         <screen>
 mkfs.lustre --fsname=
 <replaceable>fsname</replaceable> --mgsnode=
@@ -152,7 +151,7 @@ mount -t lustre
           devices, mount them both.</para>
         </note>
       </listitem>
-      <listitem xml:id="dbdoclet.50438267_pgfId-1290915">
+      <listitem xml:id="dbdoclet.format_ost">
         <para>Create the OST. On the OSS node, run:</para>
         <screen>
 mkfs.lustre --fsname=
@@ -191,7 +190,7 @@ mkfs.lustre --fsname=
           instead format the whole disk for the file system.</para>
         </note>
       </listitem>
-      <listitem xml:id="dbdoclet.50438267_pgfId-1293955">
+      <listitem xml:id="dbdoclet.mount_ost">
         <para>Mount the OST. On the OSS node where the OST was created,
         run:</para>
         <screen>
@@ -201,12 +200,12 @@ mount -t lustre
 </screen>
         <note>
           <para>To create additional OSTs, repeat Step 
-          <xref linkend="dbdoclet.50438267_pgfId-1290915" />and Step 
-          <xref linkend="dbdoclet.50438267_pgfId-1293955" />, specifying the
+          <xref linkend="dbdoclet.format_ost" />and Step 
+          <xref linkend="dbdoclet.mount_ost" />, specifying the
           next higher OST index number.</para>
         </note>
       </listitem>
-      <listitem xml:id="dbdoclet.50438267_pgfId-1290934">
+      <listitem xml:id="dbdoclet.mount_on_client">
         <para>Mount the Lustre file system on the client. On the client node,
         run:</para>
         <screen>
@@ -216,8 +215,8 @@ mount -t lustre
 <replaceable>/mount_point</replaceable> 
 </screen>
         <note>
-          <para>To create additional clients, repeat Step 
-          <xref linkend="dbdoclet.50438267_pgfId-1290934" />.</para>
+          <para>To mount the filesystem on additional clients, repeat Step 
+          <xref linkend="dbdoclet.mount_on_client" />.</para>
         </note>
         <note>
           <para>If you have a problem mounting the file system, check the
@@ -245,14 +244,14 @@ mount -t lustre
             <para>
             <literal>obdfilter-survey</literal>- Characterizes the storage
             performance of a Lustre file system. For details, see 
-            <xref linkend="dbdoclet.50438212_26516" />.</para>
+            <xref linkend="benchmark.ost_perf" />.</para>
           </listitem>
           <listitem>
             <para>
             <literal>ost-survey</literal>- Performs I/O against OSTs to detect
             anomalies between otherwise identical disk subsystems. For details,
             see 
-            <xref linkend="dbdoclet.50438212_85136" />.</para>
+            <xref linkend="benchmark.ost_io" />.</para>
           </listitem>
         </itemizedlist>
       </listitem>
@@ -705,7 +704,7 @@ Lustre: temp-MDT0000.mdt: set parameter identity_upcall=/usr/sbin/l_getidentity
 Lustre: Server temp-MDT0000 on device /dev/sdb has started 
 </screen>
         </listitem>
-        <listitem xml:id="dbdoclet.50438267_pgfId-1291170">
+        <listitem xml:id="dbdoclet.create_and_mount_ost">
           <para>Create and mount 
           <literal>ost0</literal>.</para>
           <para>In this example, the OSTs (
@@ -938,10 +937,10 @@ total 8.0M
       </indexterm>Scaling the Lustre File System</title>
       <para>A Lustre file system can be scaled by adding OSTs or clients. For
       instructions on creating additional OSTs repeat Step 
-      <xref linkend="dbdoclet.50438267_pgfId-1291170" />and Step 
-      <xref linkend="dbdoclet.50438267_pgfId-1293955" />above. For mounting
+      <xref linkend="dbdoclet.create_and_mount_ost" />and Step 
+      <xref linkend="dbdoclet.mount_ost" />above. For mounting
       additional clients, repeat Step 
-      <xref linkend="dbdoclet.50438267_pgfId-1290934" />for each client.</para>
+      <xref linkend="dbdoclet.mount_on_client" />for each client.</para>
     </section>
     <section remap="h3">
       <title>
@@ -1078,3 +1077,6 @@ total 8.0M
     </section>
   </section>
 </chapter>
+<!--
+  vim:expandtab:shiftwidth=2:tabstop=8:
+  -->