diff --git a/docs/kb/perftune-modes-sync.rst b/docs/kb/perftune-modes-sync.rst index 9023e1fbda..ff1f78d2e1 100644 --- a/docs/kb/perftune-modes-sync.rst +++ b/docs/kb/perftune-modes-sync.rst @@ -2,7 +2,7 @@ Updating the Mode in perftune.yaml After a ScyllaDB Upgrade ============================================================== -In version 2022.1, we improved ScyllaDB's performance by `removing the rx_queues_count from the mode +In versions 5.1 (ScyllaDB Open Source) and 2022.2 (ScyllaDB Enterprise), we improved ScyllaDB's performance by `removing the rx_queues_count from the mode condition `_. As a result, ScyllaDB operates in the ``sq_split`` mode instead of the ``mq`` mode (see :doc:`Seastar Perftune ` for information about the modes). If you upgrade from an earlier version of ScyllaDB, your cluster's existing nodes may use the ``mq`` mode, diff --git a/docs/upgrade/upgrade-opensource/upgrade-guide-from-5.0-to-5.1/upgrade-guide-from-5.0-to-5.1-generic.rst b/docs/upgrade/upgrade-opensource/upgrade-guide-from-5.0-to-5.1/upgrade-guide-from-5.0-to-5.1-generic.rst index fca26ff469..cd90341b41 100644 --- a/docs/upgrade/upgrade-opensource/upgrade-guide-from-5.0-to-5.1/upgrade-guide-from-5.0-to-5.1-generic.rst +++ b/docs/upgrade/upgrade-opensource/upgrade-guide-from-5.0-to-5.1/upgrade-guide-from-5.0-to-5.1-generic.rst @@ -28,8 +28,8 @@ .. |ROLLBACK| replace:: rollback .. _ROLLBACK: ./#rollback-procedure -.. |SCYLLA_METRICS| replace:: Scylla Metrics Update - Scylla 5.0 to 5.1 -.. _SCYLLA_METRICS: ../metric-update-5.0-to-5.1 +.. |SCYLLA_METRICS| replace:: ScyllaDB Metrics Update - ScyllaDB 5.0 to 5.1 +.. _SCYLLA_METRICS: /upgrade/upgrade-opensource/upgrade-guide-from-5.0-to-5.1/metric-update-5.0-to-5.1 ============================================================================= Upgrade Guide - |SCYLLA_NAME| |SRC_VERSION| to |NEW_VERSION| @@ -223,7 +223,15 @@ Validate Once you are sure the node upgrade was successful, move to the next node in the cluster. -See |Scylla_METRICS|_ for more information.. +See |Scylla_METRICS|_ for more information. + +Update the Mode in perftune.yaml +------------------------------------ +Due to performance improvements in version 5.1, your cluster's existing nodes may use a different mode than +the nodes created after the upgrade. Using different modes across one cluster is not recommended, so you +should ensure that the same mode is used on all nodes. See +:doc:`Updating the Mode in perftune.yaml After a ScyllaDB Upgrade` for instructions. + Rollback Procedure ==================