Files
scylladb/docs/troubleshooting/failed-schema-sync.rst
Anna Stuchlik 4898a20ae9 doc: add troubleshooting for failed schema sync
Fixes https://github.com/scylladb/scylladb/issues/12133

This commit adds a Troubleshooting article to support
users when schema sync failed on their cluster.

Closes #13709
2023-05-10 14:01:36 +03:00

16 lines
943 B
ReStructuredText

Failed Schema Sync
===================
The total binary footprint of all ScyllaDB columns, tables, etc., must fit a single commit log segment size
divided by two. If this requirement is not met, schema sync may fail. The error message may resemble the following:
.. code:: console
Oct 06 22:12:47 ip-172-21-1-122 scylla[1213356]: [shard 0] storage_service - Fail to pull schema from 172.21.2.210: std::invalid_argument (Mutation of 27837439 bytes is too large for the maximum size of 16777216)
Oct 06 22:12:47 ip-172-21-1-122 scylla[1213356]: [shard 0] migration_manager - Pulling schema from 172.21.2.210:0
In such a case, you may need to increase the commitlog segment size limit. To do this,
go to ``/etc/scylla/scylla.yaml`` and set the ``commitlog_segment_size_in_mb`` parameter to a higher value.
.. note::
The ``commitlog_segment_size_in_mb`` parameter must be set to the same value on **all nodes** in a cluster.