X-Git-Url: https://git.whamcloud.com/?a=blobdiff_plain;ds=sidebyside;f=UpgradingLustre.xml;h=1409d3dff16be98e917b34482c440e5f05a6234a;hb=f306cef170b7e88f791c3fe9308ba2ea5abac4a5;hp=3c236f9078085127aec1a331adc29f99d6366989;hpb=d61df1724de9b8c6ae47d54e625ed4a4f78d3fcc;p=doc%2Fmanual.git diff --git a/UpgradingLustre.xml b/UpgradingLustre.xml index 3c236f9..1409d3d 100644 --- a/UpgradingLustre.xml +++ b/UpgradingLustre.xml @@ -1,9 +1,10 @@ - Upgrading a Lustre* File System - This chapter describes interoperability between Lustre* software releases. It also provides - procedures for upgrading from a Lustre 1.8 release to a Lustre 2.x release, from a Lustre 2.x - release to a more recent Lustre 2.x release (major release upgrade), and from a Lustre 2.X.y - release to 2.X.y (minor release upgrade). It includes the following sections: + Upgrading a Lustre File System + This chapter describes interoperability between Lustre software releases. It also provides + procedures for upgrading from Lustre software release 1.8 to Lustre softeware release 2.x , + from a Lustre software release 2.x to a more recent Lustre software release 2.x (major release + upgrade), and from a a Lustre software release 2.x.y to a more recent Lustre software release + 2.x.y (minor release upgrade). It includes the following sections: @@ -23,25 +24,26 @@ upgrading Release Interoperability and Upgrade Requirements - Lustre software version 2.x release (major) + Lustre software release 2.x (major) upgrade: All servers must be upgraded at the same time, while some or all clients may be upgraded. - All servers must be be upgraded to a Linux kernel supported by the Lustre software. See the Linux Test Matrix at for a - list of tested Lustre distributions. + All servers must be be upgraded to a Linux kernel supported by the Lustre software. + See the Linux Test Matrix at for a list of tested Lustre distributions. - Clients to be upgraded to the Lustre 2.4 release or higher must be running a compatible Linux distribution. See the Linux Test Matrix at Clients to be upgraded to the Lustre software release 2.4 or higher must be running + a compatible Linux distribution. See the Linux Test Matrix at for a list of tested Linux distributions. - Lustre 2.X.y release (minor) - upgrade: + Lustre software release 2.x.y release + (minor) upgrade: All servers must be upgraded at the same time, while some or all clients may be @@ -61,27 +63,30 @@ wide striping MDT - multiple MDSx + multiple MDSs large_xattr + ea_inode wide striping large_xattr - Upgrading to Lustre Release 2.x (Major Release) - The procedure for upgrading a Lustre release 2.x file system to a more recent 2.x release - of the Lustre software is described in this section. + ea_inode + Upgrading to Lustre Software Release 2.x (Major Release) + The procedure for upgrading from a Lustre software release 2.x to a more recent 2.x + release of the Lustre software is described in this section. - This procedure can also be used to upgrade Lustre release 1.8.6-wc1 or later to any - Lustre release 2.x. To upgrade other versions of 1.8.x, contact your support - provider. + This procedure can also be used to upgrade Lustre software release 1.8.6-wc1 or later to + any Lustre software release 2.x. To upgrade other versions of Lustre software release 1.8.x, + contact your support provider. - In Lustre 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 large_xattr option on the MDT using either + 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 large_xattr or ea_inode + option on the MDT using either mkfs.lustre or tune2fs. For example after upgrading - an existing file system to Lustre release 2.2 or later, wide striping can be enabled by - running the following command on the MDT device before mounting + 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:tune2fs -O large_xattrOnce 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 version of the Lustre software that does not support wide striping. To disable wide striping: @@ -100,6 +105,9 @@ option:tune2fs -O ^large_xattr + Using either mkfs.lustre or tune2fs with + large_xattr or ea_inode option reseults in + ea_inode in the file system feature list. To generate a list of all files with more than 160 stripes use lfs @@ -107,14 +115,14 @@ option:lfs find ${mountpoint} --stripe-count=+160 - In Lustre release 2.4, a new feature allows using multiple MDTs, which can each serve - one or more remote sub-directories in the file system. The root directory - is always located on MDT0. - Note that clients running a release prior to the Lustre 2.4 release can only see the - namespace hosted by MDT0 and will return an IO error if an attempt is made to access a - directory on another MDT. + In Lustre software release 2.4, a new feature allows using multiple MDTs, which can each + serve one or more remote sub-directories in the file system. The root + directory is always located on MDT0. + Note that clients running a release prior to the Lustre software release 2.4 can only + see the namespace hosted by MDT0 and will return an IO error if an attempt is made to access + a directory on another MDT. - To upgrade a Lustre release 2.x file system to a more recent major release, complete these + To upgrade a Lustre software release 2.x to a more recent major release, complete these steps: @@ -152,8 +160,8 @@ xmlns:xlink="http://www.w3.org/1999/xlink" linkend="LustreTestMatrixTable"/>. - Upgrade the Linux operating system on all clients to RHEL 6 or other compatible - (tested) distribution and reboot. See the Linux Test Matrix at Upgrade the Linux operating system on all clients to Red Hat Enterprise Linux 6 or + other compatible (tested) distribution and reboot. See the Linux Test Matrix at . @@ -222,12 +230,14 @@ - (Optional) For upgrades to Lustre release 2.2 or higher, to enable - wide striping on an existing MDT, run the following command on the MDT + (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 :mdt# tune2fs -O large_xattr device + For more information about wide striping, see . - (Optional) For upgrades to Lustre release 2.4 or higher, to format an + (Optional) For upgrades to Lustre software release 2.4 or higher, to format an additional MDT, complete these steps: Determine the index used for the first MDT (each MDT must have unique index). @@ -247,7 +257,7 @@ (Optional) If you are upgrading to Lustre software release 2.3 or higher from Lustre - software version 2.2 or earlier and want to enable the quota feature, complete these + software release 2.2 or earlier and want to enable the quota feature, complete these steps: Before setting up the file system, enter on both the MDS and @@ -261,18 +271,18 @@ conf_param $FSNAME.quota.ost=$QUOTA_TYPE - (Optional) If you are upgrading from Lustre release 1.8, you must manually enable the - FID-in-dirent feature. On the MDS, + (Optional) If you are upgrading from Lustre software release 1.8, you must manually + enable the FID-in-dirent feature. On the MDS, enter:tune2fs –O dirdata /dev/mdtdev This step is not reversible. Do not complete this step until you are sure you will not be downgrading the Lustre software. This step only enables FID-in-dirent for newly created files. If you are upgrading to - Lustre release 2.4, you can use LFSCK 1.5 to enable FID-in-dirent for existing files. For - more information about FID-in-dirent and related functionalities in LFSCK 1.5, see . + Lustre software release 2.4, you can use LFSCK 1.5 to enable FID-in-dirent for existing + files. For more information about FID-in-dirent and related functionalities in LFSCK 1.5, + see . Start the Lustre file system by starting the components in the order shown in the @@ -315,13 +325,13 @@ conf_param $FSNAME.quota.ost=$QUOTA_TYPE <indexterm> <primary>upgrading</primary> <secondary>2.X.y to 2.X.y (minor release)</secondary> - </indexterm><indexterm/>Upgrading to a Lustre Release 2.X.y (Minor Release) - Rolling upgrades are supported for upgrading from any Lustre release 2.X.y to a more - recent 2.X.y release. This allows the Lustre file system to continue to run while individual - servers (or their failover partners) and clients are upgraded one at a time. The procedure for - upgrading a Lustre release 2.X.y file system to a more recent minor release is described in - this section. - To upgrade Lustre release 2.X.y to a more recent minor release, complete these + Upgrading to Lustre Software Release 2.x.y (Minor Release) + Rolling upgrades are supported for upgrading from any Lustre software release 2.x.y to a + more recent Lustre software release 2.X.y. This allows the Lustre file system to continue to + run while individual servers (or their failover partners) and clients are upgraded one at a + time. The procedure for upgrading a Lustre software release 2.x.y to a more recent minor + release is described in this section. + To upgrade Lustre software release 2.x.y to a more recent minor release, complete these steps: