UpgradingLustre.xml

   1 <?xml version='1.0' encoding='UTF-8'?>
   2 <!-- This document was created with Syntext Serna Free. --><chapter xmlns="http://docbook.org/ns/docbook" xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en-US" xml:id="upgradinglustre">
   3   <info>
   4     <title xml:id="upgradinglustre.title">Upgrading Lustre</title>
   5   </info>
   6   <para>This chapter describes Lustre interoperability and how to upgrade to Lustre 2.0, and includes the following sections:</para>
   7   <itemizedlist>
   8     <listitem>
   9       <para><xref linkend="dbdoclet.50438205_82079"/>Lustre Interoperability</para>
  10     </listitem>
  11     <listitem>
  12       <para><xref linkend="dbdoclet.50438205_51369"/>Upgrading Lustre 1.8.x to 2.0</para>
  13     </listitem>
  14   </itemizedlist>
  15   <section xml:id="dbdoclet.50438205_82079">
  16     <title>16.1 Lustre Interoperability</title>
  17     <para>Lustre 2.0 is built on a new architectural code base, which is different than the one used with Lustre 1.8. These architectural changes require existing Lustre 1.8.x users to follow a slightly different procedure to upgrade to Lustre 2.0 - requiring clients to be unmounted and the file system be shut down. Once the servers are upgraded and restarted, then the clients can be remounted. After the upgrade, Lustre 2.0 servers can interoperate with compatible 1.8 clients and servers. Lustre 2.0 does <emphasis>not</emphasis> support 2.0 clients interoperating with 1.8 servers.</para>
  18     <note>
  19       <para>Lustre 1.8 clients support a mix of 1.8 and 2.0 OSTs, not all OSSs need to be upgraded at the same time.</para>
  20     </note>
  21     <note>
  22       <para>Lustre 2.0 is compatible with version 1.8.4 and above. If you are planning a heterogeneous environment (mixed 1.8 and 2.0 servers), make sure that version 1.8.4 is installed on the client and server nodes that are not upgraded to 2.0.</para>
  23     </note>
  24   </section>
  25   <section xml:id="dbdoclet.50438205_51369">
  26     <title>16.2 Upgrading Lustre 1.8.x to 2.0</title>
  27     <para>Upgrading to Lustre 2.0 involves shutting down the file system and upgrading servers, and optionally clients, all at the same time. Lustre 2.0 does not support a rolling upgrade in which the file system operates continuously while individual servers (or their failover partners) and clients are upgraded one at a time.</para>
  28     <note>
  29       <para>Although the Lustre 1.8 to 2.0 upgrade path has been tested, for best results we recommend performing a fresh Lustre 2.0 installation, rather than upgrading from 1.8 to 2.0.</para>
  30     </note>
  31     <section remap="h3">
  32       <title>16.2.1 Performing a File System Upgrade</title>
  33       <para>This procedure describes a file system upgrade in which Lustre 2.0 packages are installed on multiple 1.8.x servers and, optionally, clients, requiring a file system shut down. You can choose to upgrade the entire Lustre file system to 2.0 or just upgrade the Lustre servers to 2.0 and leave the clients at 1.8.x. Lustre 2.0 servers can interoperate with compatible 1.8 clients and servers.</para>
  34       <tip>
  35         <para>In a Lustre upgrade, the package install and file system unmount steps are reversible; you can do either step first. To minimize downtime, this procedure first performs the 2.0 package installation, and then unmounts the file system.</para>
  36       </tip>
  37       <orderedlist>
  38         <listitem>
  39           <para><emphasis role="bold">Make a complete, restorable file system backup before upgrading Lustre.</emphasis></para>
  40         </listitem>
  41         <listitem>
  42           <para><emphasis role="bold">If any Lustre nodes will not be upgraded to 2.0, make sure that these client and server nodes are at version 1.8.4.</emphasis></para>
  43           <para>Lustre 2.0 is compatible with version 1.8.4 and above. If you are planning a heterogeneous environment (mixed 1.8 and 2.0 clients and servers), make sure that version 1.8.4 is installed on nodes that are not upgraded to 2.0.</para>
  44         </listitem>
  45         <listitem>
  46           <para><emphasis role="bold">Install the 2.0 packages on the Lustre servers and, optionally, the clients.</emphasis></para>
  47           <para>Some or all servers can be upgraded. Some or all clients can be upgraded.</para>
  48           <para>For help determining where to install a specific package, see <xref linkend="installinglustre.tab.req"/>.</para>
  49           <orderedlist>
  50             <listitem>
  51               <para><emphasis role="bold">Install the kernel, modules and ldiskfs packages. For example:</emphasis></para>
  52               <screen>$ rpm -ivh
  53 kernel-lustre-smp-&lt;ver&gt; \
  54 kernel-ib-&lt;ver&gt; \
  55 lustre-modules-&lt;ver&gt; \
  56 lustre-ldiskfs-&lt;ver&gt;</screen>
  57             </listitem>
  58             <listitem>
  59               <para><emphasis role="bold">Upgrade the utilities/userspace packages. For example:</emphasis></para>
  60               <screen>$ rpm -Uvh lustre-&lt;ver&gt;</screen>
  61             </listitem>
  62             <listitem>
  63               <para><emphasis role="bold">If a new <literal>e2fsprogs</literal> package is available, upgrade it. For example:</emphasis></para>
  64               <screen>$ rpm -Uvh e2fsprogs-&lt;ver&gt;
  65 </screen>
  66               <para>Use e2fsprogs-1.41-10 or later, available at:</para>
  67               <para><link xl:href="http://downloads.lustre.org/public/tools/e2fsprogs/">http://downloads.lustre.org/public/tools/e2fsprogs/</link></para>
  68             </listitem>
  69             <listitem>
  70               <para><emphasis role="bold">(Optional) If you want to add optional packages to your Lustre system, install them now.</emphasis></para>
  71             </listitem>
  72           </orderedlist>
  73         </listitem>
  74         <listitem>
  75           <para><emphasis role="bold">Shut down the file system.</emphasis></para>
  76           <para>Shut down the components in this order: clients, then the MDT, then OSTs. Unmounting a block device causes Lustre to be shut down on that node.</para>
  77           <orderedlist>
  78             <listitem>
  79               <para><emphasis role="bold">Unmount the clients. On each client node, run:</emphasis></para>
  80               <screen>umount &lt;mount point&gt;</screen>
  81             </listitem>
  82             <listitem>
  83               <para><emphasis role="bold">Unmount the MDT. On the MDS node, run:</emphasis></para>
  84               <screen>umount &lt;mount point&gt;</screen>
  85             </listitem>
  86             <listitem>
  87               <para><emphasis role="bold">Unmount the OSTs (be sure to unmount all OSTs). On each OSS node, run:</emphasis></para>
  88               <screen>umount &lt;mount point&gt;</screen>
  89             </listitem>
  90           </orderedlist>
  91         </listitem>
  92         <listitem>
  93           <para><emphasis role="bold">Unload the old Lustre modules by rebooting the node or manually removing the Lustre modules.</emphasis></para>
  94           <para>Run <literal>lustre_rmmod</literal> several times and use <literal>lsmod</literal> to check the currently loaded modules.</para>
  95         </listitem>
  96         <listitem>
  97           <para><emphasis role="bold"><emphasis role="bold">Start the upgraded file system</emphasis>.</emphasis></para>
  98           <para>Start the components in this order: OSTs, then the MDT, then clients.</para>
  99           <orderedlist>
 100             <listitem>
 101               <para><emphasis role="bold">Mount the OSTs (be sure to mount all OSTs). On each OSS node, run:</emphasis></para>
 102               <screen>mount -t lustre &lt;block device name&gt; &lt;mount point&gt;</screen>
 103             </listitem>
 104             <listitem>
 105               <para><emphasis role="bold">Mount the MDT. On the MDS node, run:</emphasis></para>
 106               <screen>mount -t lustre &lt;block device name&gt; &lt;mount point&gt; </screen>
 107             </listitem>
 108             <listitem>
 109               <para><emphasis role="bold">Mount the file system on the clients. On each client node, run:</emphasis></para>
 110               <screen>mount -t lustre &lt;MGS node&gt;:/&lt;fsname&gt; &lt;mount point&gt; </screen>
 111             </listitem>
 112           </orderedlist>
 113         </listitem>
 114       </orderedlist>
 115       <para>If you have a problem upgrading Lustre, contact us via the <ulink xl:href="https://jira.whamcloud.com">Whamcloud Jira</ulink> bug tracker.</para>
 116     </section>
 117   </section>
 118 </chapter>