If you need to remove a node from the cluster due to hardware or system failure, you need to indicate the failover status for that node. This causes Couchbase Server to use replicated data from other functioning nodes in the cluster.
Before you indicate the failover for a node you should read Section 5.5, “Failing Over Nodes”. Do not use failover to remove a functioning node from the cluster for administration or upgrade. This is because initiating a failover for a node will activate replicated data at other nodes which will reduce the overall capacity of the cluster. Data from the failover node that has not yet been replicated at other nodes or persisted on disk will be lost. For information about removing and adding a node, see Performing a Rebalance, Adding a Node to a Cluster.
You can provide the failover status for a node with two different methods:
Using the Web Console
Go to the Management -> Server Nodes section of the Web Console. Find the node that you want to failover, and click the button. You can only failover nodes that the cluster has identified as being Down.
Web Console will display a warning message.
Click to indicate the node is failed over. You can also choose to .
Using the Command-line
You can failover one or more nodes using the
failover command in
couchbase-cli. To failover the node, you
must specify the IP address and port, if not the standard
port for the node you want to failover. For example:
shell> couchbase-cli failover --cluster=localhost:8091\ -ucluster-username-pcluster-password\ --server-failover=192.168.0.72:8091
If successful this indicates the node is failed over.
After you specify that a node is failed over you should handle the cause of failure and get your cluster back to a fully functional state. For more information, see Section 5.5.4, “Handling a Failover Situation”.