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.
Upgrading to a New Version of Lustre
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.
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).
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.
The table below describes the interoperability between clients, OSTs, and MDTs with different versions of Lustre installed.
| Lustre Component | Interoperability with Other Lustre Components |
|---|---|
| Clients | Old, live clients can 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 | Old OSTs can communicate with new clients/MDTs. |
| New OSTs can only be started after the MGS has been started (typically this
means "after the MDT has been upgraded.") | |
| MDTs | An old MDT can communicate with new clients. |
| A new co-located MGS/MDT can be started at any point. | |
| A new non-co-located MDT can be started after the MGS starts. |
Upgrading Lustre 1.6.x to Lustre 1.8.x
Two Lustre upgrade paths are supported to meet the upgrade requirements of different Lustre environments.
- Entire file system upgrade - All servers and clients are shut down and upgraded at the same time. See #Performing a Compete File System Upgrade.
- 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. See #Performing a Rolling Upgrade.
Note: If you upgrade some Lustre components to 1.8.x but not others (such as running 1.8 clients in a file system with 1.6 OSTs), and run a mixed environment, you may see one or more warnings similar to this:
LustreError: 3877:0:(socklnd_cb.c:2228:ksocknal_recv_hello()) Unknown protocol version (2.x expected) from 192.168.2.43
This warning is given when the 1.6 and 1.8 components use different protocols. It can be safely ignored because the Lustre components negotiate a common protocol. In this example, the 1.8 clients fall back to use the 1.6 protocol with the 1.6 OSTs.
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:
- To upgrade the complete file system or multiple file system components at the same time, requiring a file system shutdown, see Performing a Complete File System Upgrade
- To upgrade one Lustre component (server or client) at a time, while the file system is running, see Performing a Rolling Upgrade
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
