10 Upgrading to the Latest Product Version #
For general instructions on how to upgrade a cluster, see the Administration Guide for SUSE Linux Enterprise High Availability 12 SP4. It is available at http://www.suse.com/documentation/. The chapter Upgrading Your Cluster and Updating Software Packages also describes which preparations to take care of before starting the upgrade process.
|
Upgrade From ... To |
Upgrade Path |
For Details See |
|---|---|---|
|
SLE HA 11 SP3 to SLE HA (Geo) 12 |
Offline Migration |
|
|
SLE HA (Geo) 11 SP4 to SLE HA (Geo) 12 SP1 |
Offline Migration |
|
|
SLE HA (Geo) 12 to SLE HA (Geo) 12 SP1 |
Rolling Upgrade |
|
|
SLE HA (Geo) 12 SP1 to SLE HA (Geo) 12 SP2 |
Rolling Upgrade |
|
|
SLE HA (Geo) 12 SP2 to SLE HA (Geo) 12 SP3 |
Rolling Upgrade |
|
10.1 Offline Migration (New Booth Mechanism) #
This section applies to the following scenarios:
Upgrading from SLE HA Geo 11 SP3 to SLE HA Geo 12
The booth version (v0.1) in SUSE Linux Enterprise High Availability 11 to 11 SP3 was based on the Paxos algorithm. The booth version (v0.2) in SUSE Linux Enterprise High Availability 11 SP4 and SUSE Linux Enterprise High Availability 12 and 12 SPx is loosely based on raft and is incompatible with the one running v0.1. Therefore, a rolling upgrade from any system running the old booth version to one running the new booth version is not possible. Instead, all cluster nodes must be offline and the cluster needs to be migrated as a whole as described in Procedure 10.1, “Performing a Cluster-wide Offline Migration”.
Because of the new multi-tenancy feature, the new arbitrator init script
cannot stop or test the status of the Paxos v0.1 arbitrator. On upgrade to
v0.2, the arbitrator will be stopped, if running. The OCF resource-agent
ocf:pacemaker:booth-site is capable of stopping and
monitoring the booth v0.1 site daemon.
For an upgrade of the cluster nodes, follow the instructions in the Administration Guide for SUSE Linux Enterprise High Availability 12 SP1, chapter Upgrading Your Cluster and Updating Software Packages, section Offline Migration.
If you use arbitrators outside of the cluster sites:
Upgrade each arbitrator to the desired SUSE Linux Enterprise Server version. To find the details for the individual upgrade processes, see Table 10.1, “Supported Upgrade Paths for SLE HA and SLE HA Geo”.
Add the Geo clustering extension and install the packages as described in the Geo Clustering Quick Start, available from https://www.suse.com/documentation/.
As the syntax and the consensus algorithm for booth has changed, you need to update the booth configuration files to match the latest requirements. Previously you could optionally specify expiry time and weights by appending them to the ticket name with a semicolon (
;) as separator. The new syntax has separate tokens for all ticket options. See Chapter 4, Setting Up the Booth Services for details. If you did not specify expiry time or weights different from the defaults, and do not want to use the multi-tenancy feature, you can still use the old/etc/booth/booth.conf.Synchronize the updated booth configuration files across all cluster sites and arbitrators.
Start the booth service on the cluster sites and the arbitrators as described in Section 4.5, “Enabling and Starting the Booth Services”.
10.2 Cluster Node and Arbitrator Upgrade #
This section applies to the following scenarios:
Upgrading from SLE HA Geo 11 SP4 to SLE HA Geo 12 SP1
Upgrading from SLE HA Geo 12 to SLE HA Geo 12 SP1
Upgrading from SLE HA Geo 12 SP1 to SLE HA Geo 12 SP2
Upgrading from SLE HA Geo 12 SP2 to SLE HA Geo 12 SP3
For an upgrade of the cluster nodes, follow the instructions in the Administration Guide for SUSE Linux Enterprise High Availability 12 SP4, chapter Upgrading Your Cluster and Updating Software Packages.
If you use arbitrators outside of the cluster sites, proceed as follows for each arbitrator:
Perform an upgrade to the desired target version of SUSE Linux Enterprise Server. To find the details for the individual upgrade processes, see Table 10.1, “Supported Upgrade Paths for SLE HA and SLE HA Geo”.
Add the Geo clustering extension and install the packages as described in the Geo Clustering Quick Start, available from https://www.suse.com/documentation/.