DOCS-15397 autosplit-update (#1842)

jason-price-mongodb · jason-price-mongodb · web-flow · commit 14ec01199fe0 · 2022-09-22T14:26:47.000-07:00
* DOCS-15397-autosplit-update

* DOCS-15397-autosplit-update

* DOCS-15397-autosplit-update

* DOCS-15397-autosplit-update

* DOCS-15397-autosplit-update

* DOCS-15397-autosplit-update

* DOCS-15397-autosplit-update

* DOCS-15397-autosplit-update

* DOCS-15397-autosplit-update

* DOCS-15397-autosplit-update

* DOCS-15397-autosplit-update

* DOCS-15397-autosplit-update

* DOCS-15397-autosplit-update

* DOCS-15397-autosplit-update

* DOCS-15397-autosplit-update

* DOCS-15397-autosplit-update

* DOCS-15397-autosplit-update

* DOCS-15397-autosplit-update

* DOCS-15397-autosplit-update

* DOCS-15397-autosplit-update

* DOCS-15397-autosplit-update

* DOCS-15397-autosplit-update

* DOCS-15397-autosplit-update

* DOCS-15397-autosplit-update

Co-authored-by: jason-price-mongodb &lt;jshfjghsdfgjsdjh@aolsdjfhkjsdhfkjsdf.com&gt;
diff --git a/source/core/sharding-data-partitioning.txt b/source/core/sharding-data-partitioning.txt
@@ -128,13 +128,13 @@ Limitations
 Changing the chunk size affects when chunks split but there are some
 limitations to its effects.
 
-- Automatic splitting only occurs during inserts or updates. If you
-  lower the chunk size, it may take time for all chunks to split to the
-  new size.
+- .. include:: /includes/autosplit-no-operation.rst
 
-- Splits cannot be "undone". If you increase the chunk size, existing
-  chunks must grow through inserts or updates until they reach the new
-  size.
+  .. include:: /includes/autosplit-commands.rst
+
+- In MongoDB versions earlier than 6.1, automatic splitting only occurs
+  during inserts or updates. If you lower the chunk size, it may take
+  time for all chunks to split to the new size.
 
 .. _sharding-chunk-splits:
 .. _sharding-chunk-split:
diff --git a/source/includes/autosplit-commands.rst b/source/includes/autosplit-commands.rst
@@ -0,0 +1,5 @@
+Starting in MongoDB 6.1, the following auto-splitting commands do not
+perform an operation:
+
+- :method:`sh.enableAutoSplit()`
+- :method:`sh.disableAutoSplit()`
diff --git a/source/includes/autosplit-no-operation.rst b/source/includes/autosplit-no-operation.rst
@@ -0,0 +1,5 @@
+Starting in MongoDB 6.1, automatic :ref:`chunk splitting
+<sharding-chunk-splits>` is not performed. This is because of balancing
+policy improvements. Auto-splitting commands still exist, but do not
+perform an operation. For details, see
+:ref:`release-notes-6.1-balancing-policy-changes`.
diff --git a/source/includes/extracts-4.2-changes.yaml b/source/includes/extracts-4.2-changes.yaml
@@ -532,7 +532,10 @@ content: |
 ---
 ref: 4.2-changes-balancer-autosplit
 content: |
-   Starting in MongoDB 4.2:
+
+   .. include:: /includes/autosplit-no-operation.rst
+   
+   In MongoDB versions earlier than 6.1:
 
    - The :dbcommand:`balancerStart` command and the
      ``mongo`` shell helper methods
@@ -558,13 +561,19 @@ content: |
 ---
 ref: 4.2-changes-start-balancer-autosplit
 content: |
-   Starting in MongoDB 4.2, :method:`sh.startBalancer()` also enables
-   auto-splitting for the sharded cluster.
+
+   .. include:: /includes/autosplit-no-operation.rst
+
+   In MongoDB versions earlier than 6.1, :method:`sh.startBalancer()`
+   also enables auto-splitting for the sharded cluster.
 ---
 ref: 4.2-changes-stop-balancer-autosplit
 content: |
-   Starting in MongoDB 4.2, :method:`sh.stopBalancer()` also disables
-   auto-splitting for the sharded cluster.
+
+   .. include:: /includes/autosplit-no-operation.rst
+
+   In MongoDB versions earlier than 6.1, :method:`sh.stopBalancer()`
+   also disables auto-splitting for the sharded cluster.
 ---
 ref: 4.2-changes-global-lock-reporting
 content: |
diff --git a/source/reference/command/balancerStart.txt b/source/reference/command/balancerStart.txt
@@ -18,10 +18,13 @@ Definition
    Starts the balancer thread.  The command does not wait for a
    balancing round to start.
    
-   Starting in MongoDB 4.2, the command enables auto-splitting for the
-   sharded cluster. To disable auto-splitting when the balancer is
-   enabled, you can use :method:`sh.disableAutoSplit()`.
-   
+   .. include:: /includes/autosplit-no-operation.rst
+
+   In MongoDB versions earlier than 6.1, the command enables
+   auto-splitting for the sharded cluster. To disable auto-splitting
+   when the balancer is enabled, you can use
+   :method:`sh.disableAutoSplit()`.
+
 Syntax
 ------
 
diff --git a/source/reference/command/balancerStop.txt b/source/reference/command/balancerStop.txt
@@ -18,13 +18,15 @@ Definition
    Disables the balancer in a sharded cluster. If a balancing round is
    in progress, the operation waits for balancing to complete.
 
-   Starting in MongoDB 4.2, the command disables auto-splitting for the 
-   sharded cluster. To enable auto-splitting when the balancer is 
-   disabled, you can use :method:`sh.enableAutoSplit()`.
-
    You can only issue the :dbcommand:`balancerStop` against the
    ``admin`` database on a :binary:`~bin.mongos` instance.
 
+   .. include:: /includes/autosplit-no-operation.rst
+
+   In MongoDB versions earlier than 6.1, the command disables
+   auto-splitting for the sharded cluster. To enable auto-splitting when
+   the balancer is disabled, you can use :method:`sh.enableAutoSplit()`.
+
 Syntax
 ------
 
diff --git a/source/reference/config-database.txt b/source/reference/config-database.txt
@@ -383,32 +383,28 @@ to support sharding:
      balancer status, see
      :doc:`/tutorial/manage-sharded-cluster-balancer`.
 
-     Starting in MongoDB 4.2:
-
-     - :dbcommand:`balancerStart` also enables auto-splitting for the sharded cluster.
-
-     - :dbcommand:`balancerStop` also disables auto-splitting for the sharded cluster.
-
-   - Autosplit. To enable or disable the autosplit flag, use the
-     corresponding :method:`sh.enableAutoSplit()` method or
-     :method:`sh.disableAutoSplit()` method.
+   - Autosplit:
+     
+     .. include:: /includes/autosplit-no-operation.rst
      
-     Starting in MongoDB 4.2:
+     In MongoDB versions earlier than 6.1:
 
      - :dbcommand:`balancerStart` also enables auto-splitting for the
        sharded cluster.
 
      - :dbcommand:`balancerStop` also disables auto-splitting for the
        sharded cluster.
+      
+     - To enable or disable the autosplit flag, use the corresponding
+       :method:`sh.enableAutoSplit()` method or
+       :method:`sh.disableAutoSplit()` method.
 
-   The following are some example documents in the ``settings``
-   collection:
+   Example documents in the ``settings`` collection:
 
    .. code-block:: javascript
 
       { "_id" : "chunksize", "value" : 64 }
       { "_id" : "balancer", "mode" : "full", "stopped" : false }
-      { "_id" : "autosplit", "enabled" : true }
 
 .. data:: config.shards
 
diff --git a/source/reference/method.txt b/source/reference/method.txt
@@ -975,10 +975,14 @@ Sharding
 
      - Disables auto-splitting for the sharded cluster.
 
+       .. include:: /includes/autosplit-no-operation.rst
+
    * - :method:`sh.enableAutoSplit()`
 
      - Enables auto-splitting for the sharded cluster.
 
+       .. include:: /includes/autosplit-no-operation.rst
+
    * - :method:`sh.enableSharding()`
 
      - Creates a database.
diff --git a/source/reference/method/js-sharding.txt b/source/reference/method/js-sharding.txt
@@ -68,10 +68,14 @@ Sharding Methods
 
      - Disables auto-splitting for the sharded cluster.
 
+       .. include:: /includes/autosplit-no-operation.rst
+
    * - :method:`sh.enableAutoSplit()`
 
      - Enables auto-splitting for the sharded cluster.
 
+       .. include:: /includes/autosplit-no-operation.rst
+
    * - :method:`sh.enableSharding()`
 
      - Creates a database.
diff --git a/source/reference/method/sh.disableAutoSplit.txt b/source/reference/method/sh.disableAutoSplit.txt
@@ -10,6 +10,10 @@ sh.disableAutoSplit
    :depth: 1
    :class: singlecol
 
+.. note::
+
+   .. include:: /includes/autosplit-no-operation.rst
+
 Description
 -----------
 
@@ -20,9 +24,6 @@ Description
    MongoDB automatically splits chunks based on the shard key values
    the chunk represents to keep the chunks from growing too large.
    
-   Auto-splitting is enabled by default. For more
-   information on chunk splits, see :ref:`sharding-chunk-splits`.
-
    You can only run :method:`sh.disableAutoSplit()` from a
    :binary:`~bin.mongosh` session that is connected to a
    :binary:`~bin.mongos` instance. :method:`sh.disableAutoSplit()`
@@ -34,5 +35,6 @@ Description
 
    .. seealso::
 
+      - :ref:`sharding-chunk-splits`
       - :doc:`/tutorial/manage-sharded-cluster-balancer`
       - :ref:`sharding-balancing`
diff --git a/source/reference/method/sh.enableAutoSplit.txt b/source/reference/method/sh.enableAutoSplit.txt
@@ -10,28 +10,31 @@ sh.enableAutoSplit
    :depth: 1
    :class: singlecol
 
+.. note::
+
+   .. include:: /includes/autosplit-no-operation.rst
+
 Description
 -----------
 
 .. method:: sh.enableAutoSplit()
 
-   Enables auto-splitting for the sharded cluster. Auto-splitting is
-   enabled by default.
-
-   :method:`sh.enableAutoSplit()` enables the autosplit flag in the
-   :data:`config.settings` collection.
-
+   Enables the autosplit flag in the :data:`config.settings`
+   collection. When auto-splitting is enabled for a sharded cluster,
+   MongoDB automatically splits chunks based on the shard key values
+   the chunk represents to keep the chunks from growing too large.
+   
    You can only run :method:`sh.enableAutoSplit()` from a
    :binary:`~bin.mongosh` session that is connected to a
-   :binary:`~bin.mongos` instance. :method:`sh.enableAutoSplit()` errors
-   if run on a :binary:`~bin.mongod` instance.
+   :binary:`~bin.mongos` instance. :method:`sh.enableAutoSplit()`
+   errors if run on a :binary:`~bin.mongod` instance.
 
    .. note::
-   
+
       .. include:: /includes/extracts/4.2-changes-start-balancer-autosplit.rst
-   
-   For more information on chunk splits, see
-   :ref:`sharding-chunk-splits`. For more information about how MongoDB
-   balances chunks among shards, see:
-   :doc:`/tutorial/manage-sharded-cluster-balancer` and
-   :ref:`sharding-balancing`.
+
+   .. seealso::
+
+      - :ref:`sharding-chunk-splits`
+      - :doc:`/tutorial/manage-sharded-cluster-balancer`
+      - :ref:`sharding-balancing`
diff --git a/source/reference/method/sh.setBalancerState.txt b/source/reference/method/sh.setBalancerState.txt
@@ -15,10 +15,14 @@ Description
 
 .. method:: sh.setBalancerState(state)
 
-   Enables or disables the :term:`balancer`. Starting in MongoDB 4.2,
-   the method also enables auto-splitting if enabling the balancer and
-   disables auto-splitting if disabling the balancer.
-   
+   Enables or disables the :term:`balancer`.
+
+   .. include:: /includes/autosplit-no-operation.rst
+
+   In MongoDB versions earlier than 6.1, :method:`sh.setBalancerState()`
+   also enables auto-splitting if enabling the balancer and disables
+   auto-splitting if disabling the balancer.
+
    Use :method:`sh.getBalancerState()` to determine if the balancer is
    currently enabled or disabled and :method:`sh.isBalancerRunning()`
    to check its current state.
diff --git a/source/reference/method/sh.startBalancer.txt b/source/reference/method/sh.startBalancer.txt
@@ -15,14 +15,16 @@ Definition
 
 .. method:: sh.startBalancer(timeout, interval)
 
-   .. versionchanged:: 4.2
+   .. versionchanged:: 6.1
       
-   Starts the balancer in a sharded cluster. Starting in MongoDB 4.2,
-   :method:`sh.startBalancer()` also enables auto-splitting for the
-   sharded cluster.
+   Starts the balancer in a sharded cluster.
    
-   The method can take the following options:
+   .. include:: /includes/autosplit-no-operation.rst
+
+   In MongoDB versions earlier than 6.1, :method:`sh.startBalancer()`
+   also enables auto-splitting for the sharded cluster.
 
+   The method can take the following options:
 
    .. list-table::
       :header-rows: 1
diff --git a/source/reference/method/sh.stopBalancer.txt b/source/reference/method/sh.stopBalancer.txt
@@ -15,14 +15,16 @@ Definition
 
 .. method:: sh.stopBalancer(timeout, interval)
 
-   .. versionchanged:: 4.2
+   .. versionchanged:: 6.1
 
-   Disables the balancer in a sharded cluster. Starting in MongoDB 4.2,
-   :method:`sh.stopBalancer()` also disables auto-splitting for the
-   sharded cluster.
+   Disables the balancer in a sharded cluster.
 
-   The method can take the following options:
+   .. include:: /includes/autosplit-no-operation.rst
+
+   In MongoDB versions earlier than 6.1, :method:`sh.stopBalancer()`
+   also disables auto-splitting for the sharded cluster.
 
+   The method can take the following options:
 
    .. list-table::
       :header-rows: 1
diff --git a/source/reference/sharding.txt b/source/reference/sharding.txt
@@ -69,10 +69,14 @@ Sharding Methods in ``mongosh``
 
      - Disables auto-splitting for the sharded cluster.
 
+       .. include:: /includes/autosplit-no-operation.rst
+
    * - :method:`sh.enableAutoSplit()`
 
      - Enables auto-splitting for the sharded cluster.
 
+       .. include:: /includes/autosplit-no-operation.rst
+
    * - :method:`sh.enableSharding()`
 
      - Creates a database.
diff --git a/source/release-notes/6.0-upgrade-sharded-cluster.txt b/source/release-notes/6.0-upgrade-sharded-cluster.txt
@@ -427,6 +427,8 @@ Upgrade Procedure
       If you do not wish to enable auto-splitting while the balancer is
       enabled, you must also run :method:`sh.disableAutoSplit()`.
    
+      .. include:: /includes/autosplit-no-operation.rst
+
       For more information about re-enabling the balancer, see
       :ref:`sharding-balancing-enable`.
 
diff --git a/source/release-notes/6.1-compatibility.txt b/source/release-notes/6.1-compatibility.txt
@@ -34,3 +34,10 @@ series <manual-timeseries-collection>` bucket collection namespace
 
 If you are upgrading to MongoDB 6.1 from a prior version, you must drop
 all views which are created on ``system.buckets`` collections.
+
+No Automatic Chunk Splitting
+----------------------------
+
+.. include:: /includes/autosplit-no-operation.rst
+
+.. include:: /includes/autosplit-commands.rst
diff --git a/source/release-notes/6.1.txt b/source/release-notes/6.1.txt
@@ -51,6 +51,8 @@ For an example that uses the ``*UCP`` option, see
 General Changes
 ---------------
 
+.. _release-notes-6.1-balancing-policy-changes:
+
 Balancing Policy Changes
 ~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/source/tutorial/manage-sharded-cluster-balancer.txt b/source/tutorial/manage-sharded-cluster-balancer.txt
@@ -1,6 +1,3 @@
-
-
-
 ===============================
 Manage Sharded Cluster Balancer
 ===============================
@@ -13,16 +10,16 @@ Manage Sharded Cluster Balancer
    :depth: 1
    :class: singlecol
 
-.. versionchanged:: 3.4
-
-   The balancer process has moved from the :binary:`~bin.mongos` instances
-   to the primary member of the config server replica set.
+.. versionchanged:: 6.1
 
 This page describes common administrative procedures related
 to balancing. For an introduction to balancing, see
 :ref:`sharding-balancing`. For lower level information on balancing, see
 :ref:`sharding-balancing-internals`.
 
+The balancer process has moved from the :binary:`~bin.mongos` instances
+to the primary member of the config server replica set.
+
 Check the Balancer State
 ------------------------
 
@@ -73,6 +70,8 @@ details, see :ref:`sharding-chunk-size`.
 Changing the default chunk size affects chunks that are processes during
 migrations and auto-splits but does not retroactively affect all chunks.
 
+.. include:: /includes/autosplit-no-operation.rst
+
 To configure default chunk size, see
 :doc:`modify-chunk-size-in-sharded-cluster`.
 
diff --git a/source/tutorial/modify-chunk-size-in-sharded-cluster.txt b/source/tutorial/modify-chunk-size-in-sharded-cluster.txt
