Feature Availability During Upgrade
During the cluster-upgrade procedure, some features may not be available.
The process of upgrading a cluster involves upgrading each node individually, from a lower version of Couchbase Server to a higher. Node-upgrades occur sequentially. Consequently, during the overall cluster-upgrade process, the cluster runs in mixed mode; meaning that some nodes are running the lower version, and others the higher.
Since a higher version of Couchbase Server always introduces features not provided by a lower, such features should not be used during the upgrade process, unless such use is explicitly supported in mixed-mode conditions. When cluster-upgrade is complete, all the features of the higher version of Couchbase Server can be used.
The following table summarizes the new features in Couchbase Server Enterprise Edition Version 7.0 and later, and indicates whether or not they can be used in the mixed-mode conditions that exist during the cluster-upgrade process. Usable in mixed mode indicates that the feature can be used (though not necessarily across the entire cluster) as long as one node is running the higher version. Not usable in mixed mode indicates that cluster-upgrade must be fully completed, before the feature can be used in any way.
|Whether Usable in Mixed Mode
Not usable in mixed mode.
During upgrade, all documents on an upgraded node appear in the
XDCR cannot be used to specify scopes or collections as either sources or targets for replication until all nodes have been upgraded.
Usable in mixed mode for upgraded nodes. When all nodes have been upgraded, usable for entire cluster.
Note that pre-7.0 statistics are deleted from each node when the node is upgraded.
Not usable in mixed mode. Magma should not be switched on until all nodes have been upgraded.
When a Data Service node is upgraded from a version less than 6.6, the durability-level setting for all the node’s vBuckets is set to none.
Bucket durability-levels should not be modified until after the completion of cluster-upgrade.
When a Data Service node is upgraded from Version 6.6, all bucket durability-level settings remain unchanged. Applications that use durable writes can continue to access data throughout the upgrade.
On-the-wire security-features introduced in 7.0 are not usable in mixed mode. These features, including TLS 1.3 support, should be used only following the completion of cluster-upgrade. If, at that time, a TLS version is changed, existing connections are not dropped, and so continue with their previously established TLS version: the new TLS version will be established for future connections.
Not usable in mixed mode. All nodes in the cluster should first be upgraded.
No new Analytics-Service feature is usable in mixed mode. All nodes in the cluster must be upgraded, before new Analytics-Service features can be used.
Flex Indexes, though not a new feature, are usable in mixed mode only if the cluster being upgraded is at least version 6.5.
System Events can only be used when every node in the cluster is running a version of Couchbase Server that is 7.1 or later.