Skip to content

Commit 548d5e6

Browse files
jason-price-mongodbjason-price-mongodb
andauthored
DOCS-15028 sharding task executor pool min size without restart (#386) (#412)
* 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 72a376d commit 548d5e6

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

3011-
You can only set this parameter during start-up and cannot change
3012-
this setting using the :dbcommand:`setParameter` database command.
3013-
30143011
If set, :parameter:`ShardingTaskExecutorPoolHostTimeoutMS` should be
30153012
greater than the sum of
30163013
:parameter:`ShardingTaskExecutorPoolRefreshRequirementMS` and
@@ -3019,10 +3016,21 @@ Sharding Parameters
30193016
:parameter:`ShardingTaskExecutorPoolHostTimeoutMS` to be greater than the
30203017
sum.
30213018

3019+
The following example sets
3020+
:parameter:`ShardingTaskExecutorPoolHostTimeoutMS` to ``120000``
3021+
during startup:
3022+
30223023
.. code-block:: bash
30233024

30243025
mongos --setParameter ShardingTaskExecutorPoolHostTimeoutMS=120000
30253026

3027+
During runtime, you can also set the parameter with the
3028+
:dbcommand:`setParameter` command:
3029+
3030+
.. code-block:: javascript
3031+
3032+
db.adminCommand( { setParameter: 1, ShardingTaskExecutorPoolHostTimeoutMS: 120000 } )
3033+
30263034
.. parameter:: ShardingTaskExecutorPoolMaxConnecting
30273035

30283036
.. versionadded:: 3.6
@@ -3044,13 +3052,21 @@ Sharding Parameters
30443052
If it is greater, :binary:`~bin.mongos` ignores the
30453053
:parameter:`ShardingTaskExecutorPoolMaxConnecting` value.
30463054

3047-
You can only set this parameter during start-up and cannot change
3048-
this setting using the :dbcommand:`setParameter` database command.
3055+
The following example sets
3056+
:parameter:`ShardingTaskExecutorPoolMaxConnecting` to ``20``
3057+
during startup:
30493058

30503059
.. code-block:: bash
30513060

30523061
mongos --setParameter ShardingTaskExecutorPoolMaxConnecting=20
30533062

3063+
During runtime, you can also set the parameter with the
3064+
:dbcommand:`setParameter` command:
3065+
3066+
.. code-block:: javascript
3067+
3068+
db.adminCommand( { setParameter: 1, ShardingTaskExecutorPoolMaxConnecting: 20 } )
3069+
30543070
.. parameter:: ShardingTaskExecutorPoolMaxSize
30553071

30563072
Type: integer
@@ -3068,12 +3084,20 @@ Sharding Parameters
30683084

30693085
ShardingTaskExecutorPoolMaxSize * taskExecutorPoolSize
30703086

3071-
You can only set this parameter during start-up and cannot change
3072-
this setting using the :dbcommand:`setParameter` database command.
3087+
The following example sets
3088+
:parameter:`ShardingTaskExecutorPoolMaxSize` to ``20``
3089+
during startup:
30733090

30743091
.. code-block:: bash
30753092

3076-
mongos --setParameter ShardingTaskExecutorPoolMaxSize=4
3093+
mongos --setParameter ShardingTaskExecutorPoolMaxSize=20
3094+
3095+
During runtime, you can also set the parameter with the
3096+
:dbcommand:`setParameter` command:
3097+
3098+
.. code-block:: javascript
3099+
3100+
db.adminCommand( { setParameter: 1, ShardingTaskExecutorPoolMaxSize: 20 } )
30773101

30783102
:binary:`~bin.mongos` can have up to ``n`` TaskExecutor connection
30793103
pools, where ``n`` is the number of cores. See
@@ -3113,13 +3137,21 @@ Sharding Parameters
31133137
:parameter:`warmMinConnectionsInShardingTaskExecutorPoolOnStartup`
31143138
parameter is enabled by default for the :binary:`~bin.mongos`.
31153139

3116-
You can only set this parameter during start-up and cannot change
3117-
this setting using the :dbcommand:`setParameter` database command.
3140+
The following example sets
3141+
:parameter:`ShardingTaskExecutorPoolMinSize` to ``2``
3142+
during startup:
31183143

31193144
.. code-block:: bash
31203145

31213146
mongos --setParameter ShardingTaskExecutorPoolMinSize=2
31223147

3148+
During runtime, you can also set the parameter with the
3149+
:dbcommand:`setParameter` command:
3150+
3151+
.. code-block:: javascript
3152+
3153+
db.adminCommand( { setParameter: 1, ShardingTaskExecutorPoolMinSize: 2 } )
3154+
31233155
:binary:`~bin.mongos` can have up to ``n`` TaskExecutor connection
31243156
pools, where ``n`` is the number of cores. See
31253157
:parameter:`taskExecutorPoolSize`.
@@ -3140,19 +3172,27 @@ Sharding Parameters
31403172
Maximum time the :binary:`~bin.mongos` waits before attempting to
31413173
heartbeat a resting connection in the pool.
31423174

3143-
You can only set this parameter during start-up and cannot change
3144-
this setting using the :dbcommand:`setParameter` database command.
3145-
31463175
If set, :parameter:`ShardingTaskExecutorPoolRefreshRequirementMS` should be
31473176
greater than :parameter:`ShardingTaskExecutorPoolRefreshTimeoutMS`.
31483177
Otherwise, :binary:`~bin.mongos` adjusts the value of
31493178
:parameter:`ShardingTaskExecutorPoolRefreshTimeoutMS` to be less than
31503179
:parameter:`ShardingTaskExecutorPoolRefreshRequirementMS`.
31513180

3181+
The following example sets
3182+
:parameter:`ShardingTaskExecutorPoolRefreshRequirementMS` to
3183+
``90000`` during startup:
3184+
31523185
.. code-block:: bash
31533186

31543187
mongos --setParameter ShardingTaskExecutorPoolRefreshRequirementMS=90000
31553188

3189+
During runtime, you can also set the parameter with the
3190+
:dbcommand:`setParameter` command:
3191+
3192+
.. code-block:: javascript
3193+
3194+
db.adminCommand( { setParameter: 1, ShardingTaskExecutorPoolRefreshRequirementMS: 90000 } )
3195+
31563196
.. parameter:: ShardingTaskExecutorPoolRefreshTimeoutMS
31573197

31583198
Type: integer
@@ -3164,19 +3204,27 @@ Sharding Parameters
31643204
Maximum time the :binary:`~bin.mongos` waits for a heartbeat before
31653205
timing out the heartbeat.
31663206

3167-
You can only set this parameter during start-up and cannot change
3168-
this setting using the :dbcommand:`setParameter` database command.
3169-
31703207
If set, :parameter:`ShardingTaskExecutorPoolRefreshTimeoutMS` should be
31713208
less than :parameter:`ShardingTaskExecutorPoolRefreshRequirementMS`.
31723209
Otherwise, :binary:`~bin.mongos` adjusts the value of
31733210
:parameter:`ShardingTaskExecutorPoolRefreshTimeoutMS` to be less than
31743211
:parameter:`ShardingTaskExecutorPoolRefreshRequirementMS`.
31753212

3213+
The following example sets
3214+
:parameter:`ShardingTaskExecutorPoolRefreshTimeoutMS` to
3215+
``30000`` during startup:
3216+
31763217
.. code-block:: bash
31773218

31783219
mongos --setParameter ShardingTaskExecutorPoolRefreshTimeoutMS=30000
31793220

3221+
During runtime, you can also set the parameter with the
3222+
:dbcommand:`setParameter` command:
3223+
3224+
.. code-block:: javascript
3225+
3226+
db.adminCommand( { setParameter: 1, ShardingTaskExecutorPoolRefreshTimeoutMS: 30000 } )
3227+
31803228
.. parameter:: ShardingTaskExecutorPoolReplicaSetMatching
31813229

31823230
.. versionadded:: 4.2

0 commit comments

Comments
 (0)