Swap rebalance online upgrade
Online upgrade with the swap rebalance is the preferred upgrade method when there is not enough cluster capacity to service requests once an existing node is removed.
Since each upgraded node requires only one rebalance operation, this strategy is also faster than the standard online upgrade.
To perform a swap rebalance online upgrade, first add a new node to the cluster and then perform a swap rebalance to shift data from an existing node to the new one.
The suggested general procedure is to rebalance and remove a node for upgrade, proceed with a swap rebalance operation as if the removed node was an extra or "spare" node; once this is complete, add and rebalance the extra node back into the cluster.
You can perform a swap rebalance to upgrade your Couchbase Server nodes without reducing your cluster performance due to diminished capacity from missing nodes.
You need at least one extra node to perform a swap rebalance. If you are unable to perform an upgrade via swap rebalance, perform a standard online upgrade instead.
Without an extra node available
If you don’t have an extra node available and you have enough cluster capacity to service requests after removing one of the nodes, prepare for swap rebalance by first removing an existing node to serve as the initial swap node:
Back up the entire cluster.
Remove one node from the cluster by selectingfor the node you wish to remove.
Proceed with the instructions.
With an extra node available for the rebalance
Install the latest version of Couchbase Server on the extra node that is not yet a part of the cluster. For instructions see Single node upgrade.
Create a backup of your cluster data using the cbbackup tool.
Open the Couchbase Web Console on an existing cluster node.
Selectto view and manage the cluster nodes:
Click Add Server.
In the Add Server dialog, provide either a hostname or IP address for the new node to be added. Enter your Couchbase Server administrative credentials in the fields Username and Password and select the appropriate service.
Remove one of your existing old nodes from the cluster.
Under, click Remove for the node you want to remove to mark it for removal.
In the Servers panel, click Rebalance. The rebalance process moves data from the existing node to your newly added node.
Repeat these steps for all the remaining old nodes in the cluster. You can add and remove multiple nodes from a cluster. However, always add the same number of nodes from the cluster as you remove.
For example, the addition of 4 nodes and the removal of 4 nodes is classed as a swap rebalance, but the addition of 7 nodes and removal of 4 nodes is not.