LUDOC-249 migrate: Improve lfs_migrate documentation

[doc/manual.git] / UpgradingLustre.xml

diff --git a/UpgradingLustre.xml b/UpgradingLustre.xml
index 4c7b524..d009f88 100644 (file)
--- a/UpgradingLustre.xml
+++ b/UpgradingLustre.xml
@@ -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,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>
@@ -240,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>
@@ -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
@@ -417,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>
@@ -464,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>