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
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>
<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:
</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
</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,
</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
<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,
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
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>
</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
</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
</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>