This procedure describes the steps that need to be done when switching from one type of snitch to another. Such a scenario can be when increasing the cluster and adding more data-centers in different locations. Snitches are responsible for specifying how Scylla distributes the replicas. The procedure is dependent on any changes in the cluster topology.
Note - Switching a snitch requires a full cluster shutdown, so It is highly recommended to choose the right snitch for your needs at the cluster setup phase.
No change in network topology
Set the new snitch
Network topology was changed
Set the new snitch and run repair
Changes in network topology mean that there are changes in the racks or data-centers where the nodes are located.
No topology changes
Stop all the nodes in the cluster.
sudo systemctl stop scylla-server
sudo service scylla-server stop
docker exec -it some-scylla supervisorctl stop scylla
(without stopping some-scylla container)
scylla.yaml file edit the endpoint_snitch. The file can be found under
/etc/scylla/. Change the endpoint_snitch to all the nodes in the cluster.
cassandra-rackdc.properties file edit the rack and data-center information.
A node in the
us-east-1 region, us-east is the data center name, and 1 is the rack location.
Start the nodes in the cluster one by one.
sudo systemctl start scylla-server
sudo service scylla-server start
docker exec -it some-scylla supervisorctl start scylla
(with some-scylla container already running)
Run full repair (consult with the table above if this action is needed).