Adding a node and then decommissioning the old node

Two methods for replacing a node with a new node, such as when updating to newer hardware or performing proactive maintenance.

You must prepare and start the replacement node, integrate it into the cluster, and then decommission the old node.


Be sure to use the same version of DataStax Enterprise on all nodes in the cluster, as described in the installation instructions.
  1. Prepare and start the replacement node, as described in Adding nodes to an existing cluster.
    Note: If not using vnodes, see Adding single-token nodes to a cluster.
  2. Confirm that the replacement node is alive:
    Tarball path:
    The status should show:
    • nodetool ring: Up
    • nodetool status: UN
  3. Note the Host ID of the original node; it is used in the next step.
  4. Using the Host ID of the original node, decommission the original node from the cluster using the nodetool decommission command.
  5. Run nodetool cleanup on all the other nodes in the same datacenter.
    Important: Failure to run nodetool cleanup after adding a node may result in data inconsistencies including resurrection of previously deleted data.