LUDOC-193 ea_inode: Added index entries and info on ea_inode

In order to turn on or off the wide striping option, you can
specify large_xattr or ea_inode. Both parameters will enable
the wide striping feature. Using either parameter in tune2fs
or mkfs.lustre will result in "ea_inode" listed in the file
system features using dumpe2fs. Since there is some potential
confusion around these feature parameters, this patch hopes
to address this.

Added index entries to Section 5.3.3 "Setting up Lustre File System"
and Section 16.2 "Upgrading Lustre" to make information about the
wide striping (ea_inode) option to tune2fs and mkfs.lustre easier
to find.

Signed-off-by: James Nunez <james.a.nunez@intel.com>
Change-Id: Ice054cd1720ac3174889bd27eb22f19472597041
Reviewed-on: http://review.whamcloud.com/8297
Tested-by: Jenkins
Reviewed-by: Richard Henwood <richard.henwood@intel.com>

diff --git a/SettingUpLustreSystem.xml b/SettingUpLustreSystem.xml
index 3b815e5..83de2ee 100644 (file)
--- a/SettingUpLustreSystem.xml
+++ b/SettingUpLustreSystem.xml
@@ -344,9 +344,11 @@
           <secondary><emphasis role="italic">See</emphasis> wide striping</secondary>
         </indexterm><indexterm>
           <primary>large_xattr</primary>
+          <secondary>ea_inode</secondary>
         </indexterm><indexterm>
           <primary>wide striping</primary>
           <secondary>large_xattr</secondary>
+          <tertiary>ea_inode</tertiary>
         </indexterm>File and File System Limits</title>
       <para><xref linkend="settinguplustresystem.tab2"/> describes file and file system size limits.
         These limits are imposed by either the Lustre architecture or the Linux virtual file system
@@ -576,9 +578,10 @@
           count for a single file was limited to 160 OSTs. In Lustre software release 2.2, the large
             <literal>xattr</literal> feature ("wide striping") was added to support up to 2000 OSTs.
           This feature is disabled by default at <literal>mkfs.lustre</literal> time. In order to
-          enable this feature, set the "<literal>-O large_xattr</literal>" option on the MDT either
-          by using <literal>--mkfsoptions</literal> at format time or by using
-            <literal>tune2fs</literal>.</para>
+          enable this feature, set the "<literal>-O large_xattr</literal>" or "<literal>-O ea_inode</literal>"
+          option on the MDT either by using <literal>--mkfsoptions</literal> at format time or by using
+            <literal>tune2fs</literal>. Using either "<literal>large_xattr</literal>" or "<literal>ea_inode</literal>"
+          results in "<literal>ea_inode</literal>" in the file system feature list.</para>
       </note>
     </section>
   </section>

diff --git a/UpgradingLustre.xml b/UpgradingLustre.xml
index 2578e60..1409d3d 100644 (file)
--- a/UpgradingLustre.xml
+++ b/UpgradingLustre.xml
@@ -63,12 +63,14 @@
         <primary>wide striping</primary>
       </indexterm><indexterm>
         <primary>MDT</primary>
-        <secondary>multiple MDSx</secondary>
+        <secondary>multiple MDSs</secondary>
       </indexterm><indexterm>
         <primary>large_xattr</primary>
+        <secondary>ea_inode</secondary>
       </indexterm><indexterm>
         <primary>wide striping</primary>
         <secondary>large_xattr</secondary>
+        <tertiary>ea_inode</tertiary>
       </indexterm>Upgrading to Lustre Software Release 2.x (Major Release)</title>
     <para> The procedure for upgrading from a Lustre software release 2.x to a more recent 2.x
       release of the Lustre software is described in this section. </para>
@@ -80,7 +82,8 @@
     <note>
       <para condition="l22">In Lustre software release 2.2, a feature has been added that allows
         striping across up to 2000 OSTs. By default, this "wide striping" feature is disabled. It is
-        activated by setting the <literal>large_xattr</literal> option on the MDT using either
+        activated by setting the <literal>large_xattr</literal> or <literal>ea_inode</literal>
+        option on the MDT using either
           <literal>mkfs.lustre</literal> or <literal>tune2fs</literal>. For example after upgrading
         an existing file system to Lustre software release 2.2 or later, wide striping can be
         enabled by running the following command on the MDT device before mounting
@@ -102,6 +105,9 @@
               option:<screen>tune2fs -O ^large_xattr</screen></para>
           </listitem>
         </orderedlist>
+        Using either <literal>mkfs.lustre</literal> or <literal>tune2fs</literal> with 
+          <literal>large_xattr</literal> or <literal>ea_inode</literal> option reseults in 
+          <literal>ea_inode</literal> in the file system feature list.
       </para></note>
     <note condition="l23">
       <para>To generate a list of all files with more than 160 stripes use <literal>lfs