DOCSP-50630 forwardport numInitialChunks Removal (#12356)

* DOCSP-50630 forwardport numInitialChunks Removal

* *

Author: ajhuh-mdb

content/manual/upcoming/source/core/sharding-data-partitioning.txt

@@ -70,10 +70,7 @@ Empty Collection
       entire range of the shard key values and performs an initial
       chunk distribution. By default, the
       operation creates 2 chunks per shard and migrates across the
-      cluster. You can use ``numInitialChunks`` option to specify a
-      different number of initial chunks. This initial creation and
-      distribution of chunks allows for faster setup of
-      sharding.
+      cluster.
 
     - After the initial distribution, the balancer manages the chunk
       distribution going forward.

content/manual/upcoming/source/reference/command/shardCollection.txt

@@ -61,7 +61,6 @@ The command has the following form:
         shardCollection: "<database>.<collection>",
         key: { <field1>: <1|"hashed">, ... },
         unique: <boolean>,
-        numInitialChunks: <integer>,
         presplitHashedZones: <boolean>,
         collation: { locale: "simple" },
         timeseries: <object>
@@ -116,33 +115,6 @@ The command takes the following fields:
 
        You cannot specify ``true`` when using :ref:`hashed shard keys 
        <sharding-hashed>`.
- 
-   * - ``numInitialChunks``
-     - integer
-     - Specifies the initial number of chunks to create across all shards in 
-       the cluster when sharding an *empty* collection with a
-       :ref:`hashed shard key <sharding-hashed-sharding>`. MongoDB
-       will then create and balance chunks across the cluster. The
-       ``numInitialChunks`` must result in less than ``8192`` per shard.
-       
-       If the collection is not empty or the shard key does not
-       contain a hashed field, the operation returns an error.
- 
-       - If sharding with :ref:`presplitHashedZones: true
-         <cmd-shard-collection-presplitHashedZones>`,
-         MongoDB attempts to evenly distribute the specified
-         number of chunks across the zones in the cluster.
- 
-       - If sharding with :ref:`presplitHashedZones: false
-         <cmd-shard-collection-presplitHashedZones>` or omitted and
-         no zones and zone ranges are defined for the empty
-         collection, MongoDB attempts to evenly distributed the
-         specified number of chunks across the shards in the cluster.
-
-       - If sharding with :ref:`presplitHashedZones: false
-         <cmd-shard-collection-presplitHashedZones>` or omitted and
-         zones and zone ranges have been defined for the empty
-         collection, ``numInitialChunks`` has no effect.
 
    * - ``collation``
      - document
@@ -272,11 +244,6 @@ Zone Sharding and Initial Chunk Distribution
 
 .. include:: /includes/extracts/zoned-sharding-shard-operation-chunk-distribution-with-links.rst
 
-See :ref:`pre-define-zone-range-example` for an example. If sharding a
-collection using a ranged or single-field hashed shard key, the
-``numInitialChunks`` option has no effect if zones and zone ranges have
-been defined for the empty collection.
-
 To shard a collection using a :ref:`compound hashed index
 <index-type-compound-hashed>`, see
 :ref:`shardCollection-zones-compound-hashed`.
@@ -288,11 +255,6 @@ Zone Sharding and Compound Hashed Indexes
 
 .. include:: /includes/extracts/zoned-sharding-shard-operation-chunk-distribution-hashed-short.rst
 
-The ``numInitialChunks`` option has no effect if zones and zone ranges
-have been defined for the empty collection *and*
-:ref:`presplitHashedZones <cmd-shard-collection-presplitHashedZones>` is
-``false``.
-
 See :ref:`pre-define-zone-range-hashed-example` for an example.
 
 .. seealso::

content/manual/upcoming/source/reference/method/sh.shardCollection.txt

@@ -103,15 +103,10 @@ Definition
         - document
 
         - Optional. A document containing optional fields, including
-          ``numInitialChunks`` and ``collation``.
-          
-          
-   
-
+          ``collation``.
 
    The ``options`` argument supports the following options:
 
-
    .. list-table::
       :header-rows: 1
       :widths: 20 20 80
@@ -122,36 +117,6 @@ Definition
 
         - Description
 
-      * - ``numInitialChunks``
-   
-        - integer
-   
-        - Optional. Specifies the minimum number of chunks to create
-          initially when sharding an *empty* collection with a
-          :ref:`hashed shard key <sharding-hashed-sharding>`. MongoDB
-          then creates and balances chunks across the cluster. The
-          ``numInitialChunks`` parameter must be less than ``8192`` chunks per shard.
-          Defaults to ``2`` chunks per shard.
-
-          If the collection is not empty or the shard key does not
-          contain a hashed field, the operation returns an error.
-
-          - If sharding with :ref:`presplitHashedZones: true
-            <method-shard-collection-presplitHashedZones>`,
-            MongoDB attempts to evenly distribute the specified
-            number of chunks across the zones in the cluster.
-
-          - If sharding with :ref:`presplitHashedZones: false
-            <method-shard-collection-presplitHashedZones>` or omitted and
-            no zones and zone ranges are defined for the empty
-            collection, MongoDB attempts to evenly distributed the
-            specified number of chunks across the shards in the cluster.
-
-          - If sharding with :ref:`presplitHashedZones: false
-            <method-shard-collection-presplitHashedZones>` or omitted and
-            zones and zone ranges have been defined for the empty
-            collection, ``numInitialChunks`` has no effect.
-
       * - ``collation``
 
         - document
@@ -289,11 +254,6 @@ Zone Sharding and Initial Chunk Distribution
 
 .. include:: /includes/extracts/zoned-sharding-shard-operation-chunk-distribution-with-links.rst
 
-See :ref:`pre-define-zone-range-example` for an example. If sharding a
-collection using a ranged or single-field hashed shard key, the
-``numInitialChunks`` option has no effect if zones and zone ranges have
-been defined for the empty collection.
-
 To shard a collection using a :ref:`compound hashed index
 <index-type-compound-hashed>`, see
 :ref:`sh.shardCollection-zones-compound-hashed`.
@@ -305,11 +265,6 @@ Initial Chunk Distribution with Compound Hashed Indexes
 
 .. include:: /includes/extracts/zoned-sharding-shard-operation-chunk-distribution-hashed-short.rst
 
-The ``numInitialChunks`` option has no effect if zones and zone ranges
-have been defined for the empty collection *and*
-:ref:`presplitHashedZones <method-shard-collection-presplitHashedZones>`
-is ``false``.
-
 See :ref:`pre-define-zone-range-hashed-example` for an example.
 
 .. seealso::
@@ -367,7 +322,6 @@ following example uses
      { last_name: "hashed" },
      false,
      {
-       numInitialChunks: 5,
        collation: { locale: "simple" }
      }
    )

content/manual/upcoming/source/release-notes/8.0.txt

@@ -750,6 +750,14 @@ output:
 
 .. include:: /includes/plan-cache-rename.rst
 
+numInitialChunks Option Removed 
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Starting in MongoDB 7.2, the ``numInitialChunks`` option is removed from the 
+:dbcommand:`shardCollection` command. The server automatically creates 
+chunks on every shard in a cluster when using :ref:`hashed sharding 
+<sharding-hashed>` for an empty collection.
+
 Parameter Filtering
 ~~~~~~~~~~~~~~~~~~~