DOCS-15397 autosplit-update (#1842) (#2282)

jmd-mongo · jason-price-mongodb · jason-price-mongodb · web-flow · commit 2124d28ee19e · 2022-12-15T16:05:29.000-05: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;

Co-authored-by: jason-price-mongodb &lt;69260375+jason-price-mongodb@users.noreply.github.com&gt;
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
@@ -45,7 +45,7 @@ Populated Collection
 Empty Collection
 ~~~~~~~~~~~~~~~~
 
-- If you define :doc:`zones and zone ranges </core/zone-sharding>` defined
+- If you define :ref:`zones and zone ranges <zone-sharding>` defined
   for an empty or non-existing collection (Available starting in
   MongoDB 4.0.3):
 
@@ -59,7 +59,7 @@ Empty Collection
     distribution going forward.
 
 
-- If you do not have :doc:`zones and zone ranges </core/zone-sharding>` defined
+- If you do not have zones and zone ranges defined
   for an empty or non-existing collection:
 
   - For hashed sharding:
@@ -165,8 +165,7 @@ begins migrating data across the cluster to ensure an even distribution.
 
 You can :ref:`manage <sharded-cluster-balancer>` certain aspects of the 
 balancer. The balancer also respects any :term:`zones <zone>` created as 
-a part of configuring :ref:`zones <zone-sharding>` in a sharded 
-cluster.
+a part of configuring zones in a sharded cluster.
 
 See :ref:`sharding-balancing` for more information on the
 :term:`balancer`.
diff --git a/source/includes/autosplit-commands.rst b/source/includes/autosplit-commands.rst
@@ -0,0 +1,5 @@
+Starting in MongoDB 6.0, the following auto-splitting commands do not
+perform an operation:
+
+- :method:`sh.enableAutoSplit()`
+- :method:`sh.disableAutoSplit()`
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.0:
 
    - 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.0, :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.0, :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.0, 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.0, 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
@@ -384,32 +384,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.0:
 
      - :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
@@ -967,10 +967,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.enableAutoSplit.txt b/source/reference/method/sh.enableAutoSplit.txt
@@ -10,24 +10,27 @@ 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
 
    .. seealso::
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.0, :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.0
       
-   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.0 :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.0
 
-   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.0, :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/tutorial/manage-sharded-cluster-balancer.txt b/source/tutorial/manage-sharded-cluster-balancer.txt
@@ -12,16 +12,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.0
 
 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
 ------------------------
 
@@ -74,6 +74,9 @@ details, see :ref:`sharding-range-size`.
 Changing the default range size affects ranges that are processes during
 migrations and auto-splits but does not retroactively affect all ranges.
 
+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 range size, see 
diff --git a/source/tutorial/modify-chunk-size-in-sharded-cluster.txt b/source/tutorial/modify-chunk-size-in-sharded-cluster.txt
@@ -42,4 +42,22 @@ To modify the range size, use the following procedure:
          { upsert: true }
       )
 
-The allowed range size is between 1 and 1024 megabytes, inclusive.
+Modifying the chunk size has several limitations:
+
+- .. include:: /includes/autosplit-no-operation.rst
+
+  .. include:: /includes/autosplit-commands.rst
+
+- In MongoDB versions earlier than 6.0, automatic splitting only occurs
+  for insert or update operations.
+
+- If you lower the chunk size, it may take time for all chunks to split to
+  the new size.
+
+- Splits cannot be undone.
+
+- If you increase the chunk size, existing chunks grow only through
+  insertion or updates until they reach the new size.
+
+- The allowed range of the chunk size is between 1 and 1024 megabytes,
+  inclusive.
