Removing a Node
Full Administrators and Cluster Administrators can mark a node for removal from the Couchbase cluster.
- Data service: reduced capacity to handle key/value workload.
- Index service: index data loss on that node. This service does not support rebalance. When a node running the index service is removed or failed over, indexes that reside on the node are not moved to another node after rebalancing. These indexes are no longer available for queries and are dropped.
- Query service: loss of query capability in that node.
Before you remove a node from the cluster, ensure that you have the capacity within the remaining nodes to handle the workload. Removing a node does not stop the node from servicing requests. Instead, it only marks the node as ready for removal from the cluster. You must perform a rebalance operation to complete the removal process. Once a node is removed, it is no longer part of the cluster and can be switched off, updated, or upgraded.
- At least one of the original nodes is maintained in the cluster, and this node is listed in the client's server configuration.
- The client's server configuration is appropriately updated to include at least one new node before the last old node is removed.
Remove Nodes via UI
Remove a node from the cluster from within the Server Nodes section of the Couchbase Web Console.
- Click Remove to mark the node for removal.
- After the node is removed, click on Rebalance.
Remove Nodes via REST API
Remove a node from a cluster with a curl command.
curl -u admin:password -d otpNodefirstname.lastname@example.org \ http://192.168.0.106:8091/controller/ejectNode
See also Removing Nodes from Clusters in the REST API reference.
Remove Nodes via CLI
You cannot mark a node for removal from the command-line without simultaneously initiating a rebalance operation.
The rebalance command accepts one or more --server-add or --server-remove options. This adds or removes the server from the cluster, and immediately initiates a rebalance operation.
To remove a node during a rebalance operation:
> couchbase-cli rebalance --cluster=127.0.0.1:8091 \ --user Administrator --password Password \ --server-remove=192.168.0.73