Scribd
Upload
65 views

Redis Cluster Tutorial-9

The document discusses adding new nodes to a Redis cluster. It describes adding a new empty node to the cluster by starting the Redis server on a new port and then using redis-cli to connect it to an existing node. It also covers adding a new node as a replica by using the --cluster-slave option when running redis-cli add-node. The process involves starting the new node, then connecting and replicating data from an existing master node.

Uploaded by

Kajaruban Surendran
Copyright
© © All Rights Reserved
Available Formats
Download as PDF, TXT or read online on Scribd
65 views

Redis Cluster Tutorial-9

The document discusses adding new nodes to a Redis cluster. It describes adding a new empty node to the cluster by starting the Redis server on a new port and then using redis-cli to connect it to an existing node. It also covers adding a new node as a replica by using the --cluster-slave option when running redis-cli add-node. The process involves starting the new node, then connecting and replicating data from an existing master node.

Uploaded by

Kajaruban Surendran
Copyright
© © All Rights Reserved
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 3

# All master replication stream processed, manual failover can start.

# Start of election delayed for 0 milliseconds (rank #0, offset 347540).

# Starting a failover election for epoch 7545.

# Failover election won: I'm the new master.

Basically clients connected to the master we are failing over are stopped. At the same
time the master sends its replication offset to the slave, that waits to reach the offset on
its side. When the replication offset is reached, the failover starts, and the old master is
informed about the configuration switch. When the clients are unblocked on the old
master, they are redirected to the new master.

Adding a new node


Adding a new node is basically the process of adding an empty node and then moving
some data into it, in case it is a new master, or telling it to setup as a replica of a known
node, in case it is a slave.
We'll show both, starting with the addition of a new master instance.
In both cases the first step to perform is adding an empty node.
This is as simple as to start a new node in port 7006 (we already used from 7000 to
7005 for our existing 6 nodes) with the same configuration used for the other nodes,
except for the port number, so what you should do in order to conform with the setup we
used for the previous nodes:

• Create a new tab in your terminal application.


• Enter the cluster-test directory.
• Create a directory named 7006.
• Create a redis.conf file inside, similar to the one used for the other nodes but using
7006 as port number.
• Finally start the server with ../redis-server ./redis.conf

At this point the server should be running.


Now we can use redis-cli as usual in order to add the node to the existing cluster.
redis-cli --cluster add-node 127.0.0.1:7006 127.0.0.1:7000

As you can see I used the add-node command specifying the address of the new node
as first argument, and the address of a random existing node in the cluster as second
argument.
In practical terms redis-cli here did very little to help us, it just sent a CLUSTER
MEET message to the node, something that is also possible to accomplish manually.
However redis-cli also checks the state of the cluster before to operate, so it is a good
idea to perform cluster operations always via redis-cli even when you know how the
internals work.
Now we can connect to the new node to see if it really joined the cluster:

redis 127.0.0.1:7006> cluster nodes

3e3a6cb0d9a9a87168e266b0a0b24026c0aae3f0 127.0.0.1:7001 master - 0

1385543178575 0 connected 5960-10921

3fc783611028b1707fd65345e763befb36454d73 127.0.0.1:7004 slave

3e3a6cb0d9a9a87168e266b0a0b24026c0aae3f0 0 1385543179583 0 connected

f093c80dde814da99c5cf72a7dd01590792b783b :0 myself,master - 0 0 0

connected

2938205e12de373867bf38f1ca29d31d0ddb3e46 127.0.0.1:7002 slave

3c3a0c74aae0b56170ccb03a76b60cfe7dc1912e 0 1385543178072 3 connected


a211e242fc6b22a9427fed61285e85892fa04e08 127.0.0.1:7003 slave

97a3a64667477371c4479320d683e4c8db5858b1 0 1385543178575 0 connected

97a3a64667477371c4479320d683e4c8db5858b1 127.0.0.1:7000 master - 0

1385543179080 0 connected 0-5959 10922-11422

3c3a0c74aae0b56170ccb03a76b60cfe7dc1912e 127.0.0.1:7005 master - 0

1385543177568 3 connected 11423-16383

Note that since this node is already connected to the cluster it is already able to redirect
client queries correctly and is generally speaking part of the cluster. However it has two
peculiarities compared to the other masters:

• It holds no data as it has no assigned hash slots.


• Because it is a master without assigned slots, it does not participate in the election
process when a slave wants to become a master.

Now it is possible to assign hash slots to this node using the resharding feature of redis-
cli.It is basically useless to show this as we already did in a previous section, there is no
difference, it is just a resharding having as a target the empty node.

Adding a new node as a replica


Adding a new Replica can be performed in two ways. The obvious one is to use redis-cli
again, but with the --cluster-slave option, like this:

redis-cli --cluster add-node 127.0.0.1:7006 127.0.0.1:7000 --cluster-slave

Note that the command line here is exactly like the one we used to add a new master,
so we are not specifying to which master we want to add the replica. In this case what

You might also like