WARNING: This is the _old_ Lustre wiki, and it is in the process of being retired. The information found here is all likely to be out of date. Please search the new wiki for more up to date information.

Difference between revisions of "Upgrading to a New Version of Lustre"

From Obsolete Lustre Wiki
Jump to navigationJump to search
Line 1: Line 1:
 
This section provides information about supported upgrades, upgrade paths, and interoperability of nodes with different versions of Lustre installed. It also describes procedures for upgrading your Lustre file system to a new version of Lustre. For information about available releases, see [[Lustre Release Information]].
 
This section provides information about supported upgrades, upgrade paths, and interoperability of nodes with different versions of Lustre installed. It also describes procedures for upgrading your Lustre file system to a new version of Lustre. For information about available releases, see [[Lustre Release Information]].
  
 +
=== Interoperability between Nodes with Different Versions of Lustre Installed ===
  
== Supported Upgrades ==
+
Lustre interoperability enables 1.8.x servers ("new" servers) to work with 1.6.x clients ("old" clients), 1.6.x servers ("old" servers) to work with 1.8.x clients ("new" clients), and "mixed" environments with both 1.6.x and 1.8.x servers. For
 
+
example, half of each OSS failover pair could be upgraded to enable a quick reversion to 1.6 by powering down the 1.8 servers.
For Lustre 1.8.x, the following upgrades are supported:
 
* Lustre 1.6.x (latest version) to Lustre 1.8.x (latest version).
 
* Lustre 1.8.x (any minor version) to Lustre 1.8.x (latest version).
 
 
 
=== Supported Upgrade Paths ===
 
Two Lustre upgrade paths are supported. Either can be applied to the entire file system or a combination of the two can be used to upgrade individual servers and clients.
 
 
 
* ''Rolling upgrade'' - Individual servers (or their failover partners) and clients are upgraded one at a time and restarted, so that the file system never goes down. This type of upgrade limits the ability to change certain parameters.
 
* ''Entire file system upgrade'' - All servers and clients are shut down and upgraded at the same time.
 
  
=== Interoperability between Nodes with Different Versions of Lustre Installed ===
+
Interoperability between clients, OSTs, and MDTs with different versions of Lustre installed is described in the table below.
 
 
Interoperability between clients, OSTs, and MDTs with different versions of Lustre installed is described below.
 
  
 
{| border="1" cellspacing=0 cellpadding="10"
 
{| border="1" cellspacing=0 cellpadding="10"
 
! Lustre Component !! Interoperability with Other Lustre Components
 
! Lustre Component !! Interoperability with Other Lustre Components
 
|-
 
|-
| rowspan="3" valign="top" | Clients
+
| rowspan="4" valign="top" | Clients
| Old live clients can continue to communicate with [[old/new/mixed]] servers.
+
| Old live clients can continue to communicate with old, new, or a mix of servers.
 
|-  
 
|-  
| Old clients can start up using old/new/mixed servers.
+
| Old clients can start up using old, new, or a mix of servers.
 
|-
 
|-
| New clients can start up using old/new/mixed servers (use old mount format for
+
| New clients can start up using old, new, or a mix of servers (use [[old mount format]] for old MDT).
old MDT).
+
|-
 +
| '''''Note:''''' Old clients cannot mount a file system that was created by a new MDT.
 
|-
 
|-
 
| rowspan="2" valign="top" | OSTs
 
| rowspan="2" valign="top" | OSTs
Line 43: Line 34:
 
|}
 
|}
  
Interoperability limitations:
 
  
* Old clients cannot mount a file system which was created by a new MDT.
 
  
* If your file system was originally created using Lustre 1.8.x, you will not be able to mount '''the''' '''[[(a?)]]''' file system created using an earlier Lustre version. However, if your system has been upgraded from 1.6.x to 1.8.x, you can mount Lustre clients on both Lustre versions. Lustre 1.8.x clients are interoperable with 1.6.x servers.
+
== Supported Upgrades ==
  
== Prerequisites to Upgrading Lustre==
+
For Lustre 1.8.x, the following upgrades are supported:
 +
* Lustre 1.6.x (latest version) to Lustre 1.8.x (latest version).
 +
* Lustre 1.8.x (any minor version) to Lustre 1.8.x (latest version).
  
This content was in the OM section "Upgrading from Lustre 1.6.x to Lustre 1.8.0"
+
=== Supported Upgrade Paths ===
 +
Two Lustre upgrade paths are supported. Either can be applied to the entire file system or a combination of the two can be used to upgrade individual servers and clients.
  
[[What are these procedures? Do they need to be completed before the upgrade is started?]]
+
* ''Rolling upgrade'' - Individual servers (or their failover partners) and clients are upgraded one at a time and restarted, so that the file system never goes down. This type of upgrade limits the ability to change certain parameters.
 
+
* ''Entire file system upgrade'' - All servers and clients are shut down and upgraded at the same time.
Remember the following points before upgrading Lustre.
 
 
 
''The MDT must be upgraded before the OSTs are upgraded.'' [[summarize steps in a sentence]]
 
 
 
1. Shut down lconf failover.
 
 
 
2. Install the new modules.
 
 
 
3. Run tunefs.lustre.
 
 
 
4. Mount startup.
 
 
 
''A Lustre upgrade can be done across a failover pair.'' - [[In a failover pair, do the backup server first]]
 
 
 
1. On the backup server, install the new modules.
 
 
 
2. Shut down lconf failover.
 
 
 
3. On the new server, run tunefs.lustre.
 
 
 
4. On the new server, mount startup.
 
 
 
5. On the primary server, install the new modules.
 
  
 
== Upgrade procedures ==
 
== Upgrade procedures ==

Revision as of 11:40, 30 September 2009

This section provides information about supported upgrades, upgrade paths, and interoperability of nodes with different versions of Lustre installed. It also describes procedures for upgrading your Lustre file system to a new version of Lustre. For information about available releases, see Lustre Release Information.

Interoperability between Nodes with Different Versions of Lustre Installed

Lustre interoperability enables 1.8.x servers ("new" servers) to work with 1.6.x clients ("old" clients), 1.6.x servers ("old" servers) to work with 1.8.x clients ("new" clients), and "mixed" environments with both 1.6.x and 1.8.x servers. For example, half of each OSS failover pair could be upgraded to enable a quick reversion to 1.6 by powering down the 1.8 servers.

Interoperability between clients, OSTs, and MDTs with different versions of Lustre installed is described in the table below.

Lustre Component Interoperability with Other Lustre Components
Clients Old live clients can continue to communicate with old, new, or a mix of servers.
Old clients can start up using old, new, or a mix of servers.
New clients can start up using old, new, or a mix of servers (use old mount format for old MDT).
Note: Old clients cannot mount a file system that was created by a new MDT.
OSTs New clients/MDTs can continue to communicate with old OSTs.
New OSTs can only be started after the MGS has been started (typically this

means "after the MDT has been upgraded.")

MDTs New clients can communicate with old MDTs.
New co-located MGS/MDTs can be started at any point.
New non-MGS MDTs can be started after the MGS starts.


Supported Upgrades

For Lustre 1.8.x, the following upgrades are supported:

  • Lustre 1.6.x (latest version) to Lustre 1.8.x (latest version).
  • Lustre 1.8.x (any minor version) to Lustre 1.8.x (latest version).

Supported Upgrade Paths

Two Lustre upgrade paths are supported. Either can be applied to the entire file system or a combination of the two can be used to upgrade individual servers and clients.

  • Rolling upgrade - Individual servers (or their failover partners) and clients are upgraded one at a time and restarted, so that the file system never goes down. This type of upgrade limits the ability to change certain parameters.
  • Entire file system upgrade - All servers and clients are shut down and upgraded at the same time.

Upgrade procedures

Performing a Complete File System Upgrade

Performing a Rolling Upgrade

Upgrading Lustre 1.8.x to the Next Minor Version

To upgrade Lustre 1.8.x to the next minor version, for example, Lustre 1.8.0.1 > 1.8.x, follow these procedures:

Downgrading from Lustre 1.8.x

For Lustre 1.8.x, the following downgrades are supported:

  • If you upgraded from Lustre 1.6.x > 1.8.x, you can downgrade to version 1.6.x.
  • If you upgraded from one minor version to the next (for example, Lustre 1.8.0 > 1.8.x), you can downgrade to the earlier minor version.

Caution: A new installation of Lustre 1.8.x is not guaranteed to be downgradable to an earlier Lustre version.

For a procedure to downgrade from Lustre 1.8.x to Lustre 1.6.x, see Chapter 13 in the Lustre Operations Manual