diff --git a/docs/operating-scylla/procedures/cluster-management/_common/prereq.rst b/docs/operating-scylla/procedures/cluster-management/_common/prereq.rst index 0eff6d4ac7..516b2e1ec6 100644 --- a/docs/operating-scylla/procedures/cluster-management/_common/prereq.rst +++ b/docs/operating-scylla/procedures/cluster-management/_common/prereq.rst @@ -3,6 +3,7 @@ * endpoint_snitch - ``grep endpoint_snitch /etc/scylla/scylla.yaml`` * Scylla version - ``scylla --version`` * Authenticator - ``grep authenticator /etc/scylla/scylla.yaml`` +* consistent_cluster_management - ``grep consistent_cluster_management /etc/scylla/scylla.yaml`` .. Note:: diff --git a/docs/operating-scylla/procedures/cluster-management/add-dc-to-existing-dc.rst b/docs/operating-scylla/procedures/cluster-management/add-dc-to-existing-dc.rst index 850d1c6fb3..273f94a52f 100644 --- a/docs/operating-scylla/procedures/cluster-management/add-dc-to-existing-dc.rst +++ b/docs/operating-scylla/procedures/cluster-management/add-dc-to-existing-dc.rst @@ -119,6 +119,7 @@ Add New DC * **listen_address** - IP address that Scylla used to connect to the other Scylla nodes in the cluster. * **endpoint_snitch** - Set the selected snitch. * **rpc_address** - Address for client connections (Thrift, CQL). + * **consistent_cluster_management** - set to the same value as used by your existing nodes. The parameters ``seeds``, ``cluster_name`` and ``endpoint_snitch`` need to match the existing cluster. diff --git a/docs/operating-scylla/procedures/cluster-management/add-node-to-cluster.rst b/docs/operating-scylla/procedures/cluster-management/add-node-to-cluster.rst index d939fb6518..1f5c1db9e1 100644 --- a/docs/operating-scylla/procedures/cluster-management/add-node-to-cluster.rst +++ b/docs/operating-scylla/procedures/cluster-management/add-node-to-cluster.rst @@ -54,6 +54,8 @@ Procedure * **seeds** - Specifies the IP address of an existing node in the cluster. The new node will use this IP to connect to the cluster and learn the cluster topology and state. + * **consistent_cluster_management** - set to the same value as used by your existing nodes. + .. note:: In earlier versions of ScyllaDB, seed nodes assisted in gossip. Starting with Scylla Open Source 4.3 and Scylla Enterprise 2021.1, the seed concept in gossip has been removed. If you are using an earlier version of ScyllaDB, you need to configure the seeds parameter in the following way: diff --git a/docs/operating-scylla/procedures/cluster-management/create-cluster-multidc.rst b/docs/operating-scylla/procedures/cluster-management/create-cluster-multidc.rst index da34487704..2d5b8f492c 100644 --- a/docs/operating-scylla/procedures/cluster-management/create-cluster-multidc.rst +++ b/docs/operating-scylla/procedures/cluster-management/create-cluster-multidc.rst @@ -70,6 +70,7 @@ the file can be found under ``/etc/scylla/`` - **listen_address** - IP address that the Scylla use to connect to other Scylla nodes in the cluster - **endpoint_snitch** - Set the selected snitch - **rpc_address** - Address for client connection (Thrift, CQLSH) +- **consistent_cluster_management** - ``true`` by default, can be set to ``false`` if you don't want to use Raft for consistent schema management in this cluster (will be mandatory in later versions). Check the :doc:`Raft in ScyllaDB document` to learn more. 3. In the ``cassandra-rackdc.properties`` file, edit the rack and data center information. The file can be found under ``/etc/scylla/``. diff --git a/docs/operating-scylla/procedures/cluster-management/create-cluster.rst b/docs/operating-scylla/procedures/cluster-management/create-cluster.rst index 1f82e69ed1..5028df6e7c 100644 --- a/docs/operating-scylla/procedures/cluster-management/create-cluster.rst +++ b/docs/operating-scylla/procedures/cluster-management/create-cluster.rst @@ -26,6 +26,7 @@ The file can be found under ``/etc/scylla/`` - **listen_address** - IP address that Scylla used to connect to other Scylla nodes in the cluster - **endpoint_snitch** - Set the selected snitch - **rpc_address** - Address for client connection (Thrift, CQL) +- **consistent_cluster_management** - ``true`` by default, can be set to ``false`` if you don't want to use Raft for consistent schema management in this cluster (will be mandatory in later versions). Check the :doc:`Raft in ScyllaDB document` to learn more. 3. This step needs to be done **only** if you are using the **GossipingPropertyFileSnitch**. If not, skip this step. In the ``cassandra-rackdc.properties`` file, edit the parameters listed below. diff --git a/docs/operating-scylla/procedures/cluster-management/ec2-dc.rst b/docs/operating-scylla/procedures/cluster-management/ec2-dc.rst index f1a93a75e5..7866b68725 100644 --- a/docs/operating-scylla/procedures/cluster-management/ec2-dc.rst +++ b/docs/operating-scylla/procedures/cluster-management/ec2-dc.rst @@ -63,6 +63,7 @@ Perform the following steps for each node in the new cluster: * **rpc_address** - Address for client connection (Thrift, CQL). * **broadcast_address** - The IP address a node tells other nodes in the cluster to contact it by. * **broadcast_rpc_address** - Default: unset. The RPC address to broadcast to drivers and other Scylla nodes. It cannot be set to 0.0.0.0. If left blank, it will be set to the value of ``rpc_address``. If ``rpc_address`` is set to 0.0.0.0, ``broadcast_rpc_address`` must be explicitly configured. + * **consistent_cluster_management** - ``true`` by default, can be set to ``false`` if you don't want to use Raft for consistent schema management in this cluster (will be mandatory in later versions). Check the :doc:`Raft in ScyllaDB document` to learn more. #. After you have installed and configured Scylla and edited ``scylla.yaml`` file on all the nodes, start the node specified with the ``seeds`` parameter. Then start the rest of the nodes in your cluster, one at a time, using ``sudo systemctl start scylla-server``. diff --git a/docs/operating-scylla/procedures/cluster-management/replace-dead-node-or-more.rst b/docs/operating-scylla/procedures/cluster-management/replace-dead-node-or-more.rst index 5e52121539..0988737dd1 100644 --- a/docs/operating-scylla/procedures/cluster-management/replace-dead-node-or-more.rst +++ b/docs/operating-scylla/procedures/cluster-management/replace-dead-node-or-more.rst @@ -25,6 +25,7 @@ Login to one of the nodes in the cluster with (UN) status, collect the following * seeds - ``cat /etc/scylla/scylla.yaml | grep seeds:`` * endpoint_snitch - ``cat /etc/scylla/scylla.yaml | grep endpoint_snitch`` * Scylla version - ``scylla --version`` +* consistent_cluster_management - ``grep consistent_cluster_management /etc/scylla/scylla.yaml`` Procedure --------- diff --git a/docs/operating-scylla/procedures/cluster-management/replace-dead-node.rst b/docs/operating-scylla/procedures/cluster-management/replace-dead-node.rst index 71eff69fd1..77063d6e21 100644 --- a/docs/operating-scylla/procedures/cluster-management/replace-dead-node.rst +++ b/docs/operating-scylla/procedures/cluster-management/replace-dead-node.rst @@ -66,6 +66,8 @@ Procedure - **rpc_address** - Address for client connection (Thrift, CQL) + - **consistent_cluster_management** - set to the same value as used by your existing nodes. + #. Add the ``replace_node_first_boot`` parameter to the ``scylla.yaml`` config file on the new node. This line can be added to any place in the config file. After a successful node replacement, there is no need to remove it from the ``scylla.yaml`` file. (Note: The obsolete parameters "replace_address" and "replace_address_first_boot" are not supported and should not be used). The value of the ``replace_node_first_boot`` parameter should be the Host ID of the node to be replaced. For example (using the Host ID of the failed node from above):