Upgrade
To upgrade a Couchbase-Server cluster means to upgrade the version of Couchbase Server that is running on every node.
Upgrading from Versions 7.1 or 7.2 to Versions 7.6.0 or 7.6.1
If there are index service nodes running in your cluster, you must use the swap rebalance method when upgrading from Couchbase Server 7.1 or 7.2 to Server 7.6.0 or 7.6.1. See Swap Rebalance for more information about the swap rebalance method. |
Upgrading to Version 7.x with older versions of .NET SDK
If you are upgrading from Couchbase 6.5/6.6 to 7.x+ while using a version of .NET SDK prior to 3.2.9,
then make sure your cluster is not running in |
Understanding Upgrade
To upgrade a Couchbase-Server cluster means to upgrade the version of the server that is running on every node. For example, modifying a cluster where all of its nodes are running Couchbase Server Enterprise Edition Version 6.6, so that each of its nodes subsequently runs Couchbase Server Enterprise Edition Version 7.2.
An upgrade procedure, like an install procedure, involves both preparation routines and specific upgrade commands that are performed on each node. To be upgraded, a cluster must have each of its nodes individually upgraded in turn; and the upgrade procedure for the cluster must therefore be selected in regard to whether the cluster is required to continue serving data, or to cease serving data, during the cluster-upgrade. A review of the factors that determine the appropriateness of an upgrade-procedure is provided in Upgrade Procedure-Selection.
Upgrade Paths
An upgrade path declares that the upgrade of one version of Couchbase Server to another is supported. The tables in the following subsections list upgrade paths for Enterprise Edition and for Community Edition, respectively. Each instance of the `→` sign declares support for the upgrade of the server-version on the left of the sign to the server-version on the right.
All supported upgrades can be performed with the cluster either offline or online.
As far as is possible, you should aim to keep your cluster up to date with the latest version of Couchbase Server. |
How to Upgrade Your Cluster
If you are upgrading several nodes at once, then the version of the software on each node must be kept in step throughout the upgrade process.
For example, if you are upgrading three enterprise nodes (Node 1
, Node 2
and Node 3
) from version 5.1x to 7.2.4, then you would use the following sequence:
5.1x
to 7.2.4
Step | Description | Upgrades |
---|---|---|
1 |
Upgrade all nodes from 5.1x to 6.0 |
|
2 |
Upgrade all nodes from 6.6 to 7.2.3 |
|
3 |
Upgrade all nodes from 7.2.3 to 7.2.4 |
|
Upgrading between non-adjacent version numbers is usually not supported.
For example, to upgrade from 5.1.x to 7.2.4, then three upgrades must be performed (as shown in Example 1): |
Enterprise Edition Upgrade Paths
Starting Version | Path to Current Version |
---|---|
5.0.x |
5.0.x and 5.1.x → 6.6 → 7.2.3 → 7.2.4[1] |
5.5x |
5.5.0+ → 6.6 → 7.2.3 → 7.2.4[1] |
6.x |
6.0 → 6.6 → 7.2.3 → 7.2.4[1] |
7.x |
7.0 → 7.1 → 7.2.4[1] |
1The upgrade to Erlang support in Couchbase server 7.2.4 requires that you first upgrade Couchbase to version 7.1.0 or later before upgrading to version 7.2.4
Community Edition Upgrade Paths
Starting Version | Path to Current Version |
---|---|
5.x |
5.x → 6.6 → 7.2.3 → 7.2.4[1] |
6.x |
6.0 → 6.6 → 7.2.3 → 7.2.4[1] |
7.x |
7.0 → 7.1 → 7.2.4[1] |
1The upgrade to Erlang support in Couchbase server 7.2.4 requires that you first upgrade Couchbase to version 7.1.0 or later before upgrading to version 7.2.4
Upgrade from Community Edition to Enterprise
If you’re currently operating a Couchbase Server cluster on Community Edition, you can upgrade it to Enterprise Edition by way of a rolling online upgrade. This involves switching out the Community Edition nodes with fresh, net-new Enterprise Edition nodes. Both 'swap rebalance' and 'remove and reblance' methods are supported. (Delta Recovery is not supported since the new nodes must be fresh Enterprise Edition installations without any pre-existing Community Edition data remaining on them.)
Rolling upgrades from CE to EE are not supported if there are index service nodes running in the cluster. |
The Enterprise Edition nodes must be running the same version number of Couchbase Server as the Community Edition nodes that they are replacing, otherwise the upgrade may fail. This means you can’t upgrade to a newer version of Couchbase Server while also upgrading to Enterprise Edition during the same rolling upgrade.
If you want to upgrade from an older version of Community Edition to a newer version of Enterprise Edition, you need to perform two separate upgrade procedures:
-
Upgrade the entire cluster to Enterprise Edition via a rolling online upgrade
-
Upgrade to the desired version number of Couchbase Server using any supported type of upgrade
For example, if you wanted to upgrade from Couchbase Server 6.6 Community Edition to Couchbase Server 7.2.4 Enterprise Edition, the process would look like the following:
Remember that Enterprise Edition is not free to run in production. If you’re interested in upgrading to Couchbase Server Enterprise Edition, check out the editions page. |
See Upgrade Procedure-Selection, for a list of procedures that can be used when upgrading from Community Edition to Enterprise. Note, however, that Graceful Failover for Data Service nodes, with Delta Recovery, is not supported for such upgrades: instead, removal, addition, and swap rebalance should be used; for all nodes.
Node-Naming and Upgrade
In Couchbase Enterprise Server Version 7.2 or later, the node-name must be correctly identified in the node-certificate as a Subject Alternative Name. If the node-name is not correctly identified, failure may occur during upgrade. For information, see Node-Certificate Validation.
Downgrade
Once an upgrade of a Couchbase-Server cluster has started, downgrade to the earlier version of Couchbase Server can be performed, as long as one node continues to run the earlier version. To downgrade an existing node, you must first remove the existing Linux package installer, then install an earlier version. However, once all nodes are running the later version, downgrade can no longer be performed: therefore, once all nodes are running the later version, should application-support require the earlier version, an entirely new cluster must be created, running the earlier version.