Whamcloud - gitweb
LUDOC-382 Tag lfsck_query as lustre 2.9
[doc/manual.git] / UpgradingLustre.xml
index 4c7b524..78629f8 100644 (file)
@@ -146,7 +146,7 @@ xml:id="upgradinglustre">
       <literal>ea_inode</literal> option reseults in 
       <literal>ea_inode</literal> in the file system feature list.</para>
     </note>
-    <note condition="l23">
+    <note>
       <para>To generate a list of all files with more than 160 stripes use 
       <literal>lfs find</literal> with the 
       <literal>--stripe-count</literal> option:
@@ -178,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
@@ -207,10 +192,10 @@ 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">
-        Lustre Releases</link>repository. See 
+        <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_cnh_5m3_gk" /> for a list of required packages.</para>
       </listitem>
       <listitem>
         <para>Install the Lustre server packages on all Lustre servers (MGS,
@@ -240,10 +225,10 @@ 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">
-        Lustre Releases</link>repository. See 
+        <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_j3r_ym3_gk" /> for a list of required packages.</para>
         <note>
           <para>The version of the kernel running on a Lustre client must be
           the same as the version of the 
@@ -319,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
@@ -384,8 +381,8 @@ conf_param $FSNAME.quota.ost=$QUOTA_TYPE</screen></para>
       is MGT, OSTs, MDT(s), clients.</para>
     </note>
     <para>If you have a problem upgrading a Lustre file system, see 
-    <xref xmlns:xlink="http://www.w3.org/1999/xlink"
-    linkend="dbdoclet.50438198_30989" />for some ways to get help.</para>
+      <xref xmlns:xlink="http://www.w3.org/1999/xlink"
+      linkend="dbdoclet.reporting_lustre_problem"/>for ways to get help.</para>
   </section>
   <section xml:id="Upgrading_2.x.x">
     <title>
@@ -417,10 +414,10 @@ 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">
-        Lustre Releases</link>repository. See 
+        <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_cnh_5m3_gk" /> for a list of required packages.</para>
       </listitem>
       <listitem>
         <para>For a rolling upgrade, complete any procedures required to keep
@@ -464,10 +461,10 @@ 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">
-        Lustre Releases</link>repository. See 
+        <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_j3r_ym3_gk" /> for a list of required packages.</para>
       </listitem>
       <listitem>
         <para>Install the Lustre client packages on each of the Lustre clients
@@ -503,7 +500,7 @@ conf_param $FSNAME.quota.ost=$QUOTA_TYPE</screen></para>
     </orderedlist>
     <para>If you have a problem upgrading a Lustre file system, see 
     <xref xmlns:xlink="http://www.w3.org/1999/xlink"
-    linkend="dbdoclet.50438198_30989" />for some suggestions for how to get
-    help.</para>
+    linkend="dbdoclet.reporting_lustre_problem" />for some suggestions for
+    how to get help.</para>
   </section>
 </chapter>