diff --git a/docs/operating-scylla/procedures/config-change/switch-snitch.rst b/docs/operating-scylla/procedures/config-change/switch-snitch.rst index d29441025b..4e9599354d 100644 --- a/docs/operating-scylla/procedures/config-change/switch-snitch.rst +++ b/docs/operating-scylla/procedures/config-change/switch-snitch.rst @@ -1,15 +1,12 @@ How to Switch Snitches ********************** -.. REMOVE IN FUTURE VERSIONS - when the limitation in the note is no longer valid .. note:: - Switching from one type of snitch to another is NOT supported for clusters - where one or more keyspaces have tablets enabled. - - NOTE: If you :ref:`create a new keyspace `, - it has tablets enabled by default. + Changing the network topology by switching to another type of snitch + is no longer supported. The new snitch must specify the same DC and rack + as the previous one. 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. @@ -17,32 +14,13 @@ Snitches are responsible for specifying how ScyllaDB distributes the replicas. T **Note** - Switching a snitch requires a full cluster shutdown, so It is highly recommended to choose the :doc:`right snitch ` for your needs at the cluster setup phase. -+------------------------------------------------------------------------------------+------------------------------------------------------------------------------------+ -|Cluster Status |Needed Procedure | -+====================================================================================+====================================================================================+ -|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. - For example: -**No topology changes** - Original cluster: three nodes cluster on a single data-center with :ref:`Simplesnitch ` or :ref:`Ec2snitch `. Change to: three nodes in one data-center and one rack using a :ref:`GossipingPropertyFileSnitch ` or :ref:`Ec2multiregionsnitch `. -**Topology changes** - -Original cluster: three nodes using the :ref:`Simplesnitch ` or :ref:`Ec2snitch ` in a single data-center. - -Change to: nine nodes in two data-centers using the :ref:`GossipingPropertyFileSnitch ` or :ref:`Ec2multiregionsnitch ` (add a new data-center). - --------- Procedure ---------