Rolling Replaces

Riak KV functions as a multi-node system, so cluster-level version upgrades and restarts can be performed on a node-by-node or rolling basis.

The following steps should be undertaken on each Riak KV node that you wish to replace:

1. Create a free node:

a. Create an additional node with similar specifications to the other nodes in the cluster.

b. Or leave a node that is currently in the cluster:

  riak admin cluster leave »nodename«

After creating a node or leaving a node, wait for all transfers to complete:

  riak admin transfers

2. Join the free node to your cluster:

riak admin cluster join »free_node«

3. Next, replace the free node with an existing node:

riak admin cluster replace »free_node« »nodename«

4. Then review the cluster transition plan:

riak admin cluster plan

5. And commit the changes:

riak admin cluster commit

6. Wait for all transfers to complete:

riak admin transfers

7. Repeat steps 2-6 above until each node has been replaced.

8. Join the replaced node back into the cluster or decommission the additional node that was created.