Skip to content

Commit cf48f7c

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

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
@@ -3229,9 +3229,6 @@ Sharding Parameters
32293229
Maximum time that :binary:`~bin.mongos` goes without communication to a
32303230
host before :binary:`~bin.mongos` drops all connections to the host.
32313231

3232-
You can only set this parameter during start-up and cannot change
3233-
this setting using the :dbcommand:`setParameter` database command.
3234-
32353232
If set, :parameter:`ShardingTaskExecutorPoolHostTimeoutMS` should be
32363233
greater than the sum of
32373234
:parameter:`ShardingTaskExecutorPoolRefreshRequirementMS` and
@@ -3240,10 +3237,21 @@ Sharding Parameters
32403237
:parameter:`ShardingTaskExecutorPoolHostTimeoutMS` to be greater than the
32413238
sum.
32423239

3240+
The following example sets
3241+
:parameter:`ShardingTaskExecutorPoolHostTimeoutMS` to ``120000``
3242+
during startup:
3243+
32433244
.. code-block:: bash
32443245

32453246
mongos --setParameter ShardingTaskExecutorPoolHostTimeoutMS=120000
32463247

3248+
During runtime, you can also set the parameter with the
3249+
:dbcommand:`setParameter` command:
3250+
3251+
.. code-block:: javascript
3252+
3253+
db.adminCommand( { setParameter: 1, ShardingTaskExecutorPoolHostTimeoutMS: 120000 } )
3254+
32473255
.. parameter:: ShardingTaskExecutorPoolMaxConnecting
32483256

32493257
.. versionadded:: 3.6
@@ -3265,13 +3273,21 @@ Sharding Parameters
32653273
If it is greater, :binary:`~bin.mongos` ignores the
32663274
:parameter:`ShardingTaskExecutorPoolMaxConnecting` value.
32673275

3268-
You can only set this parameter during start-up and cannot change
3269-
this setting using the :dbcommand:`setParameter` database command.
3276+
The following example sets
3277+
:parameter:`ShardingTaskExecutorPoolMaxConnecting` to ``20``
3278+
during startup:
32703279

32713280
.. code-block:: bash
32723281

32733282
mongos --setParameter ShardingTaskExecutorPoolMaxConnecting=20
32743283

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

32773293
Type: integer
@@ -3289,12 +3305,20 @@ Sharding Parameters
32893305

32903306
ShardingTaskExecutorPoolMaxSize * taskExecutorPoolSize
32913307

3292-
You can only set this parameter during start-up and cannot change
3293-
this setting using the :dbcommand:`setParameter` database command.
3308+
The following example sets
3309+
:parameter:`ShardingTaskExecutorPoolMaxSize` to ``20``
3310+
during startup:
32943311

32953312
.. code-block:: bash
32963313

3297-
mongos --setParameter ShardingTaskExecutorPoolMaxSize=4
3314+
mongos --setParameter ShardingTaskExecutorPoolMaxSize=20
3315+
3316+
During runtime, you can also set the parameter with the
3317+
:dbcommand:`setParameter` command:
3318+
3319+
.. code-block:: javascript
3320+
3321+
db.adminCommand( { setParameter: 1, ShardingTaskExecutorPoolMaxSize: 20 } )
32983322

32993323
:binary:`~bin.mongos` can have up to ``n`` TaskExecutor connection
33003324
pools, where ``n`` is the number of cores. See
@@ -3334,13 +3358,21 @@ Sharding Parameters
33343358
:parameter:`warmMinConnectionsInShardingTaskExecutorPoolOnStartup`
33353359
parameter is enabled by default for the :binary:`~bin.mongos`.
33363360

3337-
You can only set this parameter during start-up and cannot change
3338-
this setting using the :dbcommand:`setParameter` database command.
3361+
The following example sets
3362+
:parameter:`ShardingTaskExecutorPoolMinSize` to ``2``
3363+
during startup:
33393364

33403365
.. code-block:: bash
33413366

33423367
mongos --setParameter ShardingTaskExecutorPoolMinSize=2
33433368

3369+
During runtime, you can also set the parameter with the
3370+
:dbcommand:`setParameter` command:
3371+
3372+
.. code-block:: javascript
3373+
3374+
db.adminCommand( { setParameter: 1, ShardingTaskExecutorPoolMinSize: 2 } )
3375+
33443376
:binary:`~bin.mongos` can have up to ``n`` TaskExecutor connection
33453377
pools, where ``n`` is the number of cores. See
33463378
:parameter:`taskExecutorPoolSize`.
@@ -3361,19 +3393,27 @@ Sharding Parameters
33613393
Maximum time the :binary:`~bin.mongos` waits before attempting to
33623394
heartbeat a resting connection in the pool.
33633395

3364-
You can only set this parameter during start-up and cannot change
3365-
this setting using the :dbcommand:`setParameter` database command.
3366-
33673396
If set, :parameter:`ShardingTaskExecutorPoolRefreshRequirementMS` should be
33683397
greater than :parameter:`ShardingTaskExecutorPoolRefreshTimeoutMS`.
33693398
Otherwise, :binary:`~bin.mongos` adjusts the value of
33703399
:parameter:`ShardingTaskExecutorPoolRefreshTimeoutMS` to be less than
33713400
:parameter:`ShardingTaskExecutorPoolRefreshRequirementMS`.
33723401

3402+
The following example sets
3403+
:parameter:`ShardingTaskExecutorPoolRefreshRequirementMS` to
3404+
``90000`` during startup:
3405+
33733406
.. code-block:: bash
33743407

33753408
mongos --setParameter ShardingTaskExecutorPoolRefreshRequirementMS=90000
33763409

3410+
During runtime, you can also set the parameter with the
3411+
:dbcommand:`setParameter` command:
3412+
3413+
.. code-block:: javascript
3414+
3415+
db.adminCommand( { setParameter: 1, ShardingTaskExecutorPoolRefreshRequirementMS: 90000 } )
3416+
33773417
.. parameter:: ShardingTaskExecutorPoolRefreshTimeoutMS
33783418

33793419
Type: integer
@@ -3385,19 +3425,27 @@ Sharding Parameters
33853425
Maximum time the :binary:`~bin.mongos` waits for a heartbeat before
33863426
timing out the heartbeat.
33873427

3388-
You can only set this parameter during start-up and cannot change
3389-
this setting using the :dbcommand:`setParameter` database command.
3390-
33913428
If set, :parameter:`ShardingTaskExecutorPoolRefreshTimeoutMS` should be
33923429
less than :parameter:`ShardingTaskExecutorPoolRefreshRequirementMS`.
33933430
Otherwise, :binary:`~bin.mongos` adjusts the value of
33943431
:parameter:`ShardingTaskExecutorPoolRefreshTimeoutMS` to be less than
33953432
:parameter:`ShardingTaskExecutorPoolRefreshRequirementMS`.
33963433

3434+
The following example sets
3435+
:parameter:`ShardingTaskExecutorPoolRefreshTimeoutMS` to
3436+
``30000`` during startup:
3437+
33973438
.. code-block:: bash
33983439

33993440
mongos --setParameter ShardingTaskExecutorPoolRefreshTimeoutMS=30000
34003441

3442+
During runtime, you can also set the parameter with the
3443+
:dbcommand:`setParameter` command:
3444+
3445+
.. code-block:: javascript
3446+
3447+
db.adminCommand( { setParameter: 1, ShardingTaskExecutorPoolRefreshTimeoutMS: 30000 } )
3448+
34013449
.. parameter:: ShardingTaskExecutorPoolReplicaSetMatching
34023450

34033451
.. versionadded:: 4.2

0 commit comments

Comments
 (0)