Whamcloud - gitweb
LUDOC-249 migrate: Improve lfs_migrate documentation
[doc/manual.git] / UpgradingLustre.xml
index 646df00..d009f88 100644 (file)
@@ -111,16 +111,14 @@ xml:id="upgradinglustre">
       provider.</para>
     </note>
     <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> 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 it:
+      <para>In Lustre software release 2.2, a feature has been added for
+      ldiskfs-based MDTs that allows striping a single file across up to 2000
+      OSTs. By default, this "wide striping" feature is disabled. It is
+      activated by setting the <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 it:
       <screen>tune2fs -O large_xattr</screen>
       Once the wide striping feature is enabled and in use on the MDT, it is
       not possible to directly downgrade the MDT file system to an earlier 
@@ -128,14 +126,10 @@ xml:id="upgradinglustre">
       disable wide striping:
       <orderedlist>
         <listitem>
-          <para>Delete all wide-striped files.</para>
-          <para>OR</para>
-          <para>Use 
-          <literal>lfs_migrate</literal> with the option 
-          <literal>-c</literal>
-          <replaceable>stripe_count</replaceable>(set 
-          <replaceable>stripe_count</replaceable>to 160) to move the files to
-          another location.</para>
+          <para>Delete all wide-striped files, <emphasis>OR</emphasis>
+          use <literal>lfs_migrate -c 160</literal> (or fewer stripes)
+          to migrate the files to use fewer OSTs. This does not affect the
+          total number of OSTs that the whole filesystem can access.</para>
         </listitem>
         <listitem>
           <para>Unmount the MDT.</para>
@@ -184,23 +178,8 @@ xml:id="upgradinglustre">
         </caution>
       </listitem>
       <listitem>
-        <para>Shut down the file system by unmounting all clients and servers
-        in the order shown below (unmounting a block device causes the Lustre
-        software to be shut down on that node):</para>
-        <orderedlist numeration="loweralpha">
-          <listitem>
-            <para>Unmount the clients. On each client node, run:</para>
-            <screen>umount -a -t lustre</screen>
-          </listitem>
-          <listitem>
-            <para>Unmount the MDT. On the MDS node, run:</para>
-            <screen>umount -a -t lustre</screen>
-          </listitem>
-          <listitem>
-            <para>Unmount all the OSTs. On each OSS node, run:</para>
-            <screen>umount -a -t lustre</screen>
-          </listitem>
-        </orderedlist>
+        <para>Shut down the entire filesystem by following
+        <xref linkend="dbdoclet.shutdownLustre"/></para>
       </listitem>
       <listitem>
         <para>Upgrade the Linux operating system on all servers to a compatible
@@ -213,7 +192,7 @@ xml:id="upgradinglustre">
       </listitem>
       <listitem>
         <para>Download the Lustre server RPMs for your platform from the 
-        <link xl:href="https://wiki.hpdd.intel.com/display/PUB/Lustre+Releases">
+        <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>
@@ -246,7 +225,7 @@ xml:id="upgradinglustre">
       </listitem>
       <listitem>
         <para>Download the Lustre client RPMs for your platform from the 
-        <link xl:href="https://wiki.hpdd.intel.com/display/PUB/Lustre+Releases">
+        <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>
@@ -288,11 +267,11 @@ xml:id="upgradinglustre">
       <listitem>
         <para>(Optional) For upgrades to Lustre software release 2.2 or higher,
         to enable wide striping on an existing MDT, run the following command
-        on the MDT :
-        <screen>mdt# tune2fs -O large_xattr <replaceable>device</replaceable></screen></para>
+        on the MDT:
+        <screen>tune2fs -O ea_inode /dev/<replaceable>mdtdev</replaceable></screen>
+        </para>
         <para>For more information about wide striping, see 
-        <xref xmlns:xlink="http://www.w3.org/1999/xlink"
-        linkend="section_syy_gcl_qk" />.</para>
+        <xref xmlns:xlink="http://www.w3.org/1999/xlink" linkend="wide_striping" />.</para>
       </listitem>
       <listitem>
         <para>(Optional) For upgrades to Lustre software release 2.4 or higher,
@@ -325,6 +304,18 @@ xml:id="upgradinglustre">
             OSTs:
             <screen>tunefs.lustre --quota</screen></para>
           </listitem>
+      <listitem>
+        <para>(Optional) If you are upgrading before Lustre software release
+        2.10, to enable the project quota feature enter the following on every
+        ldiskfs backend target:
+        <screen>tune2fs –O project /dev/<replaceable>dev</replaceable></screen>
+        </para>
+        <note><para>Enabling the <literal>project</literal> feature will prevent
+            the filesystem from being used by older versions of ldiskfs, so it
+            should only be enabled if the project quota feature is required and/or
+            after it is known that the upgraded release does not need to be
+            downgraded.</para></note>
+      </listitem>
           <listitem>
             <para>When setting up the file system, enter:
             <screen>conf_param $FSNAME.quota.mdt=$QUOTA_TYPE
@@ -423,7 +414,7 @@ conf_param $FSNAME.quota.ost=$QUOTA_TYPE</screen></para>
       </listitem>
       <listitem>
         <para>Download the Lustre server RPMs for your platform from the 
-        <link xl:href="https://wiki.hpdd.intel.com/display/PUB/Lustre+Releases">
+        <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>
@@ -470,7 +461,7 @@ conf_param $FSNAME.quota.ost=$QUOTA_TYPE</screen></para>
       </listitem>
       <listitem>
         <para>Download the Lustre client RPMs for your platform from the 
-        <link xl:href="https://wiki.hpdd.intel.com/display/PUB/Lustre+Releases">
+        <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>