Manage Nodes and Clusters

A Couchbase-Server cluster consists of one or more nodes, each of which is a system running an instance of Couchbase Server.

Managing Nodes and Clusters

A Couchbase Server node is a physical or virtual machine that hosts a single instance of Couchbase Server. A conceptual overview is provided in Nodes. The current section provides step-by-step procedures for node-management. This includes:

  • Initializing and provisioning a node, thereby making it a one-node cluster.

  • Adding and removing nodes from clusters.

  • Listing nodes currently in the cluster.

  • Performing failover on nodes, when they need to be removed from the cluster.

  • Rebalancing the cluster, after a node has been removed for scheduled or otherwise planned maintenance.

  • Recovering a node, following failover.

Prerequisites

Before proceeding with the instructions provided throughout this section, you must have installed and started Couchbase Server.

For links to all per platform installation-instructions, see Install.

For information on starting and stopping Couchbase Server on different platforms, see Startup and Shutdown.

Certificate Management

The examples in this section assume that nodes are protected with the out-of-the-box, self-signed SSL/TLS certificate that is provided with Couchbase Server by default. This allows nodes to be added to the cluster with no need for explicit certificate-related management; since each node has the same certificate. However, this certificate is only intended for use in pre-production environments.

If, across the cluster, an authority-signed certificate is substituted for the default (as would be required for production deployments), no further node can subsequently be added until a certificate signed by the same authority has been installed on it. An attempt incorporate into a cluster a new node that is not appropriately certificate-protected results in an error. For more information, see Node Certificates.