Nodetool repair

Repair - A process that runs in the background and synchronizes the data between nodes. It only repairs keyspaces with tablets disabled (vnode-based). To repair keyspaces with tablets, see :doc:nodetool cluster repair </operating-scylla/nodetool-commands/cluster/repair/>.

When running nodetool repair on a single node, it acts as the repair master. Only the data contained in the master node and its replications will be repaired. Typically, this subset of data is replicated on many nodes in the cluster, often all, and the repair process syncs between all the replicas until the master data subset is in-sync.

To repair all of the data in the cluster, you need to run a repair on all of the nodes in the cluster, or let ScyllaDB Manager <https://manager.docs.scylladb.com/>_ do it for you.

To synchronize all data in clusters that have both tablets- and vnodes-based keyspaces, run :doc:nodetool repair -pr </operating-scylla/nodetool-commands/repair/> on all of the nodes in the cluster, and :doc:nodetool cluster repair </operating-scylla/nodetool-commands/cluster/repair/> on any of the nodes in the cluster.

To check if a keyspace enables tablets, use:

.. code-block:: cql

DESCRIBE KEYSPACE keyspace_name

.. note:: Run the :doc:nodetool repair </operating-scylla/nodetool-commands/repair/> command regularly. If you delete data frequently, it should be more often than the value of gc_grace_seconds (by default: 10 days), for example, every week. Use the nodetool repair -pr on each node in the cluster, sequentially.

.. warning::

It is strongly recommended to not do any maintenance operations (add/remove/decommission/replace/rebuild) or schema changes (CREATE/DROP/TRUNCATE/ALTER CQL commands) while repairs are running. Repairs running during any of these operations are likely ro result in an error.

ScyllaDB nodetool repair command supports the following options:

-dc --in-dc syncs the repair master data subset between all nodes in one Data Center (DC).

The DC must be the repair master DC.

.. warning:: This command leaves part of the data subset (all remaining DCs) out of sync.

For example:

::
```
  nodetool repair -dc US_DC
  nodetool repair --in-dc US_DC
```
-et --end-token executes a repair on the specified node/s starting with the first token and ending with the specified UUID token.

For example:

::

nodetool repair -et 90874935784 nodetool repair --end-token 90874935784
-hosts --in-hosts syncs the repair master data subset only between a list of nodes, using host ID or Address. The list must include the repair master.

.. warning:: this command leaves part of the data subset (on nodes that are not listed) out of sync.

For example:

::

nodetool repair -hosts 172.17.0.2,172.17.0.3,172.17.0.4 nodetool repair --in-hosts 172.17.0.2,172.17.0.3,172.17.0.4 nodetool repair --in-hosts cdc295d7-c076-4b07-af69-1385fefdb40b,2dbdf288-9e73-11ea-bb37-0242ac130002,3a5993f8-9e73-11ea-bb37-0242ac130002
-local --in-local-dc executes a repair on the nodes in the local datacenter only.

For example:

::

nodetool repair -local nodetool repair --in-local-dc
-pr --partitioner-range executes a repair only on the primary replica returned by the partitioner.

For example:

::

nodetool repair -pr nodetool repair --partitioner-range
-st --start-token executes a repair on a range of node/s starting with the start token (the token specified).

For example:

::

nodetool repair -st 10474535988 nodetool repair --start-token
keyspace executes a repair on a specific keyspace. The default is all keyspaces.

For example:

::

nodetool repair <my_keyspace>
table executes a repair on a specific table or a list of space-delimited table names. The default is all tables.

For example:

::

nodetool repair <my_keyspace> <my_table>

See also ScyllaDB Manager <https://manager.docs.scylladb.com/>_.

.. include:: nodetool-index.rst