Skip to content

Commit a2ea39f

Browse files
ianf-mongodbjeff-allen-mongo
authored andcommitted
DOCS-14644-assert CWWC is set on server start | DOCS-14643 on sh.addShard
1 parent 608a462 commit a2ea39f

File tree

5 files changed

+26
-0
lines changed

5 files changed

+26
-0
lines changed
Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
Starting in MongoDB 5.1, when starting, restarting or adding a
2+
:doc:`shard server</sharding>` with :method:`sh.addShard()` the
3+
:ref:`Cluster Wide Write Concern (CWWC) <set_global_default_write_concern>`
4+
must be set.
5+
6+
If the ``CWWC`` is not set and the shard is configured
7+
such that the :ref:`default write concern <write-concern>` is
8+
``{ w : 1 }`` the shard server will fail to start or be added
9+
and returns an error.
10+
11+
See :ref:`default write concern calculations <default-wc-formula>` for
12+
details on how the default write concern is calculated.

source/reference/mongodb-defaults.txt

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -215,6 +215,8 @@ Write Concern
215215
:alt: Read/Write Concern Inheritance
216216
:figwidth: 500px
217217

218+
.. _default-wc-formula:
219+
218220
Default Write Concern
219221
~~~~~~~~~~~~~~~~~~~~~
220222

source/release-notes/5.1-compatibility.txt

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -74,6 +74,11 @@ Removed Metrics
7474
Replica Sets
7575
------------
7676

77+
Assert Cluster Wide Write Concern is Set When Starting or Adding Shard
78+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
79+
80+
.. include:: /includes/fact-5.1-fassert-shard-restart-add-CWWC.rst
81+
7782
``rs.reconfig`` Cluster Wide Write Concern Validation
7883
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
7984

source/release-notes/5.1.txt

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -191,6 +191,11 @@ For an example, see :ref:`validation-description-example`.
191191
Replica Sets
192192
------------
193193

194+
Assert Cluster Wide Write Concern is Set When Starting or Adding Shard
195+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
196+
197+
.. include:: /includes/fact-5.1-fassert-shard-restart-add-CWWC.rst
198+
194199
``rs.reconfig`` Cluster Wide Write Concern Validation
195200
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
196201

source/sharding.txt

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -237,6 +237,8 @@ a :ref:`broadcast operation <sharding-mongos-broadcast>`, querying
237237
*all* shards in the sharded cluster. These scatter/gather queries can
238238
be long running operations.
239239

240+
.. include:: /includes/fact-5.1-fassert-shard-restart-add-CWWC.rst
241+
240242
.. note::
241243

242244
If you have an active support contract with MongoDB, consider contacting

0 commit comments

Comments
 (0)