CLUSTER RESET
CLUSTER RESET [HARD | SOFT]
- Available since
- 3.0.0
- Time complexity
- O(N) where N is the number of known nodes. The command may execute a FLUSHALL as a side effect.
- ACL categories
- @admin, @slow, @dangerous
Reset a Redict Cluster node, in a more or less drastic way depending on the
reset type, that can be hard or soft. Note that this command
does not work for masters if they hold one or more keys, in that case
to completely reset a master node keys must be removed first, e.g. by using FLUSHALL
first,
and then CLUSTER RESET
.
Effects on the node:
- All the other nodes in the cluster are forgotten.
- All the assigned / open slots are reset, so the slots-to-nodes mapping is totally cleared.
- If the node is a replica it is turned into an (empty) master. Its dataset is flushed, so at the end the node will be an empty master.
- Hard reset only: a new Node ID is generated.
- Hard reset only:
currentEpoch
andconfigEpoch
vars are set to 0. - The new configuration is persisted on disk in the node cluster configuration file.
This command is mainly useful to re-provision a Redict Cluster node in order to be used in the context of a new, different cluster. The command is also extensively used by the Redict Cluster testing framework in order to reset the state of the cluster every time a new test unit is executed.
If no reset type is specified, the default is soft.