Skip to content

Commit b260429

Browse files
authored
Explain how to remove failed cluster node (redis#2427) (redis#2434)
`redis-cli --cluster del-node` doesn't work since it tries to connect to all nodes. `--cluster call CLUSTER FORGET` works though.
1 parent 706b8c1 commit b260429

File tree

1 file changed

+8
-0
lines changed

1 file changed

+8
-0
lines changed

docs/management/scaling.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -875,6 +875,14 @@ over one of its replicas and remove the node after it turned into a replica of t
875875
new master. Obviously this does not help when you want to reduce the actual
876876
number of masters in your cluster, in that case, a resharding is needed.
877877

878+
There is a special scenario where you want to remove a failed node.
879+
You should not use the `del-node` command because it tries to connect to all nodes and you will encounter a "connection refused" error.
880+
Instead, you can use the `call` command:
881+
882+
redis-cli --cluster call 127.0.0.1:7000 cluster forget `<node-id>`
883+
884+
This command will execute `CLUSTER FORGET` command on every node.
885+
878886
#### Replica migration
879887

880888
In Redis Cluster, you can reconfigure a replica to replicate with a

0 commit comments

Comments
 (0)