Skip to content

Commit 6c85e0a

Browse files
author
Sam Kleinman
committed
DOCS-432: making public with increased warning
1 parent 001540f commit 6c85e0a

File tree

2 files changed

+35
-20
lines changed

2 files changed

+35
-20
lines changed

source/reference/configuration-options.txt

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -872,3 +872,25 @@ Sharding Cluster Options
872872
See the :ref:`replica-set-read-preference-behavior-member-selection`
873873
section of the :ref:`read preference <replica-set-read-preference>`
874874
documentation for more information.
875+
876+
.. setting:: noAutoSplit
877+
878+
:setting:`noAutoSplit` is for internal use and is only available on
879+
:program:`mongos` instances.
880+
881+
.. versionadded:: 2.0.7
882+
883+
:setting:`noAutoSplit` prevents :program:`mongos` from
884+
automatically inserting metadata splits in a :term:`sharded
885+
collection`. If set on all :program:`mongos`, this will prevent
886+
MongoDB from creating new chunks as the data in a collection
887+
grows.
888+
889+
Because any :program:`mongos` in a cluster can create a split,
890+
to totally disable splitting in a cluster you must
891+
set :setting:`noAutoSplit` on all :program:`mongos`.
892+
893+
.. warning::
894+
895+
With :setting:`noAutoSplit` enabled, the data in your sharded
896+
cluster may become imbalanced over time. Enable with caution.

source/reference/mongos.txt

Lines changed: 13 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -281,28 +281,21 @@ Options
281281
section of the :ref:`read preference <replica-set-read-preference>`
282282
documentation for more information.
283283

284-
.. COMMENT
284+
.. option:: --noAutoSplit
285285

286-
--noAutoSplit is not in the public documentation becasue it's an
287-
internal only feature.
286+
.. versionadded:: 2.0.7
288287

289-
.. option:: --noAutoSplit
288+
:option:`--noAutoSplit` prevents :program:`mongos` from
289+
automatically inserting metadata splits in a :term:`sharded
290+
collection`. If set on all :program:`mongos`, this will prevent
291+
MongoDB from creating new chunks as the data in a collection
292+
grows.
290293

291-
.. versionadded:: 2.0.7
294+
Because any :program:`mongos` in a cluster can create a split,
295+
to totally disable splitting in a cluster you must
296+
set :option:`--noAutoSplit` on all :program:`mongos`.
292297

293-
:option:`--noAutoSplit` prevents :program:`mongos` from
294-
automatically inserting metadata splits in a :term:`sharded
295-
collection`. If set on all :program:`mongos`, this will prevent
296-
MongoDB from creating new chunks as the data in a collection
297-
grows.
298-
299-
Because any :program:`mongos` in a cluster can create a split,
300-
to totally disable splitting in a cluster you must
301-
set :option:`--noAutoSplit` on all :program:`mongos`.
302-
303-
.. note::
304-
305-
With :option:`--noAutoSplit` enabled, the data in your sharded
306-
cluster may become imbalanced over time. Enable with caution.
298+
.. warning::
307299

308-
.. END-COMMENT
300+
With :option:`--noAutoSplit` enabled, the data in your sharded
301+
cluster may become imbalanced over time. Enable with caution.

0 commit comments

Comments
 (0)