Skip to content

DOCS-13868 chunk errors in sharded transactions #5951

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 10 additions & 0 deletions source/includes/transactionLifetimeLimitSeconds-parameter.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
Starting in MongoDB 5.0, if you change the
:parameter:`transactionLifetimeLimitSeconds` parameter, you must also
change :parameter:`transactionLifetimeLimitSeconds` to the same value on
all config server replica set members. Keeping this value consistent:

- Ensures the routing table history is retained for at least as long as
the transaction lifetime limit on the shard replica set members.

- Reduces the transaction retry frequency and therefore improves
performance.
8 changes: 5 additions & 3 deletions source/reference/parameters.txt
Original file line number Diff line number Diff line change
Expand Up @@ -4110,11 +4110,11 @@ Transaction Parameters
*Default*: 60

Specifies the lifetime of :doc:`multi-document transactions
</core/transactions>`. Transactions that exceeds this limit are
</core/transactions>`. Transactions that exceed this limit are
considered expired and will be aborted by a periodic cleanup
process. The cleanup process runs every
:parameter:`transactionLifetimeLimitSeconds`/2 seconds or at least
once per every 60 seconds.
once every 60 seconds.

The cleanup process helps relieve storage cache pressure.

Expand All @@ -4138,7 +4138,9 @@ Transaction Parameters

To set the parameter for a sharded cluster, the parameter must be
modified for all shard replica set members.


.. include:: /includes/transactionLifetimeLimitSeconds-parameter.rst

.. parameter:: maxTransactionLockRequestTimeoutMillis

.. versionadded:: 4.0
Expand Down
5 changes: 5 additions & 0 deletions source/release-notes/5.0-compatibility.txt
Original file line number Diff line number Diff line change
Expand Up @@ -337,6 +337,11 @@ If ``auditLog.runtimeConfiguration`` is set to ``false`` and an audit
filter config document is present, then a startup warning will be
issued but the server will not abort.

Reduce Risk of Stale Chunks in Sharded Transactions
---------------------------------------------------

.. include:: /includes/transactionLifetimeLimitSeconds-parameter.rst

General Changes
---------------

Expand Down