DOCSP-25925-migrationConcurrency (BACKPORT) (#2502)

* DOCSP-25925-migrationConcurrency (#2144)

* DOCSP-25925-migrationConcurrency

* DOCSP-25925-migrationConcurrency

* DOCSP-25925-migrationConcurrency

* DOCSP-25925-migrationConcurrency

* DOCSP-25925-migrationConcurrency

* DOCSP-25925-migrationConcurrency

* DOCSP-25925-migrationConcurrency

* DOCSP-25925-migrationConcurrency

* DOCSP-25925-migrationConcurrency

* DOCSP-25925-migrationConcurrency

* DOCSP-25925-migrationConcurrency

Co-authored-by: jason-price-mongodb <[email protected]>

* DOCSP-25925-migrationConcurrency

* DOCSP-25925-migrationConcurrency

---------

Co-authored-by: jason-price-mongodb <[email protected]>

Author: jason-price-mongodb

source/reference/parameters.txt

@@ -2712,6 +2712,40 @@ Sharding Parameters
    ``AsyncRequestsSenderUseBaton`` and always enables the performance
    enhancement controlled by the parameter.
 
+.. parameter:: chunkMigrationConcurrency
+
+   *Available starting in MongoDB 5.0.16*
+
+   *Type*: integer
+
+   *Default*: 1
+
+   |both|
+
+   Specifies an integer that sets the number of threads on the source
+   shard and the receiving shard for :ref:`chunk migration
+   <migrate-chunks-sharded-cluster>`.
+   
+   Increasing the concurrency improves chunk migration performance, but
+   also increases the workload and disk IOPS usage on the the source
+   shard and the receiving shard.
+
+   Maximum value is 500. You should typically use fewer than 32 threads
+   unless you are using NVMe (Non-Volatile Memory Express) disks.
+
+   The following example sets ``chunkMigrationConcurrency`` to ``5``:
+
+   .. code-block:: bash
+
+      mongod --setParameter chunkMigrationConcurrency=5
+
+   During runtime, you can also set the parameter with the
+   :dbcommand:`setParameter` command:
+
+   .. code-block:: javascript
+
+      db.adminCommand( { setParameter: 1, chunkMigrationConcurrency: 5 } )
+
 .. parameter:: disableResumableRangeDeleter
 
    .. versionadded:: 4.4