Skip to content

Commit 5a69e9d

Browse files
jason-price-mongodbjason-price-mongodb
andauthored
DOCS-15028 sharding task executor pool min size without restart (#386) (#409)
* DOCS-15028 ShardingTaskExecutorPoolMinSize without restart * DOCS-15028-ShardingTaskExecutorPoolMinSize-without-restart Co-authored-by: jason-price-mongodb <[email protected]> Co-authored-by: jason-price-mongodb <[email protected]>
1 parent 1f5cd51 commit 5a69e9d

File tree

1 file changed

+64
-16
lines changed

1 file changed

+64
-16
lines changed

source/reference/parameters.txt

Lines changed: 64 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -3199,9 +3199,6 @@ Sharding Parameters
31993199
Maximum time that :binary:`~bin.mongos` goes without communication to a
32003200
host before :binary:`~bin.mongos` drops all connections to the host.
32013201

3202-
You can only set this parameter during start-up and cannot change
3203-
this setting using the :dbcommand:`setParameter` database command.
3204-
32053202
If set, :parameter:`ShardingTaskExecutorPoolHostTimeoutMS` should be
32063203
greater than the sum of
32073204
:parameter:`ShardingTaskExecutorPoolRefreshRequirementMS` and
@@ -3210,10 +3207,21 @@ Sharding Parameters
32103207
:parameter:`ShardingTaskExecutorPoolHostTimeoutMS` to be greater than the
32113208
sum.
32123209

3210+
The following example sets
3211+
:parameter:`ShardingTaskExecutorPoolHostTimeoutMS` to ``120000``
3212+
during startup:
3213+
32133214
.. code-block:: bash
32143215

32153216
mongos --setParameter ShardingTaskExecutorPoolHostTimeoutMS=120000
32163217

3218+
During runtime, you can also set the parameter with the
3219+
:dbcommand:`setParameter` command:
3220+
3221+
.. code-block:: javascript
3222+
3223+
db.adminCommand( { setParameter: 1, ShardingTaskExecutorPoolHostTimeoutMS: 120000 } )
3224+
32173225
.. parameter:: ShardingTaskExecutorPoolMaxConnecting
32183226

32193227
.. versionadded:: 3.6
@@ -3235,13 +3243,21 @@ Sharding Parameters
32353243
If it is greater, :binary:`~bin.mongos` ignores the
32363244
:parameter:`ShardingTaskExecutorPoolMaxConnecting` value.
32373245

3238-
You can only set this parameter during start-up and cannot change
3239-
this setting using the :dbcommand:`setParameter` database command.
3246+
The following example sets
3247+
:parameter:`ShardingTaskExecutorPoolMaxConnecting` to ``20``
3248+
during startup:
32403249

32413250
.. code-block:: bash
32423251

32433252
mongos --setParameter ShardingTaskExecutorPoolMaxConnecting=20
32443253

3254+
During runtime, you can also set the parameter with the
3255+
:dbcommand:`setParameter` command:
3256+
3257+
.. code-block:: javascript
3258+
3259+
db.adminCommand( { setParameter: 1, ShardingTaskExecutorPoolMaxConnecting: 20 } )
3260+
32453261
.. parameter:: ShardingTaskExecutorPoolMaxSize
32463262

32473263
Type: integer
@@ -3259,12 +3275,20 @@ Sharding Parameters
32593275

32603276
ShardingTaskExecutorPoolMaxSize * taskExecutorPoolSize
32613277

3262-
You can only set this parameter during start-up and cannot change
3263-
this setting using the :dbcommand:`setParameter` database command.
3278+
The following example sets
3279+
:parameter:`ShardingTaskExecutorPoolMaxSize` to ``20``
3280+
during startup:
32643281

32653282
.. code-block:: bash
32663283

3267-
mongos --setParameter ShardingTaskExecutorPoolMaxSize=4
3284+
mongos --setParameter ShardingTaskExecutorPoolMaxSize=20
3285+
3286+
During runtime, you can also set the parameter with the
3287+
:dbcommand:`setParameter` command:
3288+
3289+
.. code-block:: javascript
3290+
3291+
db.adminCommand( { setParameter: 1, ShardingTaskExecutorPoolMaxSize: 20 } )
32683292

32693293
:binary:`~bin.mongos` can have up to ``n`` TaskExecutor connection
32703294
pools, where ``n`` is the number of cores. See
@@ -3304,13 +3328,21 @@ Sharding Parameters
33043328
:parameter:`warmMinConnectionsInShardingTaskExecutorPoolOnStartup`
33053329
parameter is enabled by default for the :binary:`~bin.mongos`.
33063330

3307-
You can only set this parameter during start-up and cannot change
3308-
this setting using the :dbcommand:`setParameter` database command.
3331+
The following example sets
3332+
:parameter:`ShardingTaskExecutorPoolMinSize` to ``2``
3333+
during startup:
33093334

33103335
.. code-block:: bash
33113336

33123337
mongos --setParameter ShardingTaskExecutorPoolMinSize=2
33133338

3339+
During runtime, you can also set the parameter with the
3340+
:dbcommand:`setParameter` command:
3341+
3342+
.. code-block:: javascript
3343+
3344+
db.adminCommand( { setParameter: 1, ShardingTaskExecutorPoolMinSize: 2 } )
3345+
33143346
:binary:`~bin.mongos` can have up to ``n`` TaskExecutor connection
33153347
pools, where ``n`` is the number of cores. See
33163348
:parameter:`taskExecutorPoolSize`.
@@ -3331,19 +3363,27 @@ Sharding Parameters
33313363
Maximum time the :binary:`~bin.mongos` waits before attempting to
33323364
heartbeat a resting connection in the pool.
33333365

3334-
You can only set this parameter during start-up and cannot change
3335-
this setting using the :dbcommand:`setParameter` database command.
3336-
33373366
If set, :parameter:`ShardingTaskExecutorPoolRefreshRequirementMS` should be
33383367
greater than :parameter:`ShardingTaskExecutorPoolRefreshTimeoutMS`.
33393368
Otherwise, :binary:`~bin.mongos` adjusts the value of
33403369
:parameter:`ShardingTaskExecutorPoolRefreshTimeoutMS` to be less than
33413370
:parameter:`ShardingTaskExecutorPoolRefreshRequirementMS`.
33423371

3372+
The following example sets
3373+
:parameter:`ShardingTaskExecutorPoolRefreshRequirementMS` to
3374+
``90000`` during startup:
3375+
33433376
.. code-block:: bash
33443377

33453378
mongos --setParameter ShardingTaskExecutorPoolRefreshRequirementMS=90000
33463379

3380+
During runtime, you can also set the parameter with the
3381+
:dbcommand:`setParameter` command:
3382+
3383+
.. code-block:: javascript
3384+
3385+
db.adminCommand( { setParameter: 1, ShardingTaskExecutorPoolRefreshRequirementMS: 90000 } )
3386+
33473387
.. parameter:: ShardingTaskExecutorPoolRefreshTimeoutMS
33483388

33493389
Type: integer
@@ -3355,19 +3395,27 @@ Sharding Parameters
33553395
Maximum time the :binary:`~bin.mongos` waits for a heartbeat before
33563396
timing out the heartbeat.
33573397

3358-
You can only set this parameter during start-up and cannot change
3359-
this setting using the :dbcommand:`setParameter` database command.
3360-
33613398
If set, :parameter:`ShardingTaskExecutorPoolRefreshTimeoutMS` should be
33623399
less than :parameter:`ShardingTaskExecutorPoolRefreshRequirementMS`.
33633400
Otherwise, :binary:`~bin.mongos` adjusts the value of
33643401
:parameter:`ShardingTaskExecutorPoolRefreshTimeoutMS` to be less than
33653402
:parameter:`ShardingTaskExecutorPoolRefreshRequirementMS`.
33663403

3404+
The following example sets
3405+
:parameter:`ShardingTaskExecutorPoolRefreshTimeoutMS` to
3406+
``30000`` during startup:
3407+
33673408
.. code-block:: bash
33683409

33693410
mongos --setParameter ShardingTaskExecutorPoolRefreshTimeoutMS=30000
33703411

3412+
During runtime, you can also set the parameter with the
3413+
:dbcommand:`setParameter` command:
3414+
3415+
.. code-block:: javascript
3416+
3417+
db.adminCommand( { setParameter: 1, ShardingTaskExecutorPoolRefreshTimeoutMS: 30000 } )
3418+
33713419
.. parameter:: ShardingTaskExecutorPoolReplicaSetMatching
33723420

33733421
.. versionadded:: 4.2

0 commit comments

Comments
 (0)