Search:

Search all manuals
Search this manual
Manual
Couchbase Server Manual 2.0
Community Wiki and Resources
Download Couchbase Server 2.0
Couchbase Developer Guide 2.0
Client Libraries
Couchbase Server Forum
Additional Resources
Community Wiki
Community Forums
Couchbase SDKs
Parent Section
2.5 Upgrading to Couchbase Server 2.0.x
Chapter Sections
Chapters

2.5.1. Online Upgrades

Within an online upgrade, the upgrade process can take place without taking down the cluster or the associated application. This means that the cluster and applications can continue to function while you upgrade the individual nodes within the cluster.

Important

For information on upgrading from Couchbase Server 1.8 to Couchbase Server 2.0, see Section 2.7, “Upgrades Notes 1.8.1 to 2.0”. Upgrades from Couchbase Server 1.8 to 2.0 Beta or earlier releases are not supported.

To perform an online upgrade of your cluster:

  1. Choose a node to remove from the cluster and upgrade. You can upgrade one node at a time, or if you have enough cluster capacity, two nodes at a time.

  2. On the Manage->Server Nodes screen, click the Remove Server . This marks the server for removal from the cluster, but does not actually remove it.

    Figure 2.5. Online Upgrade — Marking a Node for Removal from a Cluster

    Online Upgrade — Marking a Node for Removal from a Cluster

  3. The Pending Rebalance will show the number of servers that require a rebalance to remove them from the cluster. Click the Rebalance button.

    Figure 2.6. Online Upgrade — Starting the Rebalance Process

    Online Upgrade — Starting the Rebalance Process

    This will start the rebalance process. Once rebalancing has been completed, the Server Nodes display should display only the remaining (active) nodes in your cluster.

    Figure 2.7. Online Upgrade — Cluster with the Node Removed

    Online Upgrade — Cluster with the Node Removed

  4. Perform a standard node upgrade to the new version of Couchbase Server. See Section 2.7.3, “Node Upgrade Process” for details.

  5. Couchbase Server should be started automatically after the upgrade. If not, restart the Couchbase Server process, using the methods described in Section 3.2, “Startup and Shutdown of Couchbase Server” .

  6. With the node upgraded, you need to add the node back to the cluster.

    On an existing node within the running cluster, navigate to the Manage->Server Nodes page. Click the Add Server button. You will be prompted to enter the IP address and username/password of the server to add back to the cluster.

    For Couchbase 2.0.2 you can provide either a hostname or IP Address for the node you want to add. For more information, see Section 2.4, “Using Hostnames with Couchbase Server”.

    Figure 2.8. Online Upgrade — Adding the Node back to the Cluster

    Online Upgrade — Adding the Node back to the Cluster

  7. The Pending Rebalance count will indicate that servers need to be rebalanced into the cluster. Click Rebalance to rebalance the cluster, and bring the node back into production.

You will need to repeat the above sequence for each node within the cluster in order to upgrade the entire cluster to the new version.