Skip to content

Commit 347686f

Browse files
jason-price-mongodbjason-price-mongodb
andauthored
DOCS-15028 sharding task executor pool min size without restart (#386) (#414)
* 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 011ff32 commit 347686f

File tree

1 file changed

+67
-19
lines changed

1 file changed

+67
-19
lines changed

source/reference/parameters.txt

Lines changed: 67 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -2199,9 +2199,6 @@ Sharding Parameters
21992199
Maximum time that :binary:`~bin.mongos` goes without communication to a
22002200
host before :binary:`~bin.mongos` drops all connections to the host.
22012201

2202-
You can only set this parameter during start-up and cannot change
2203-
this setting using the :dbcommand:`setParameter` database command.
2204-
22052202
If set, :parameter:`ShardingTaskExecutorPoolHostTimeoutMS` should be
22062203
greater than the sum of
22072204
:parameter:`ShardingTaskExecutorPoolRefreshRequirementMS` and
@@ -2210,10 +2207,21 @@ Sharding Parameters
22102207
:parameter:`ShardingTaskExecutorPoolHostTimeoutMS` to be greater than the
22112208
sum.
22122209

2213-
.. code-block:: sh
2210+
The following example sets
2211+
:parameter:`ShardingTaskExecutorPoolHostTimeoutMS` to ``120000``
2212+
during startup:
2213+
2214+
.. code-block:: bash
22142215

22152216
mongos --setParameter ShardingTaskExecutorPoolHostTimeoutMS=120000
22162217

2218+
During runtime, you can also set the parameter with the
2219+
:dbcommand:`setParameter` command:
2220+
2221+
.. code-block:: javascript
2222+
2223+
db.adminCommand( { setParameter: 1, ShardingTaskExecutorPoolHostTimeoutMS: 120000 } )
2224+
22172225
.. parameter:: ShardingTaskExecutorPoolMaxConnecting
22182226

22192227
.. versionadded:: 3.6
@@ -2235,13 +2243,21 @@ Sharding Parameters
22352243
If it is greater, :binary:`~bin.mongos` ignores the
22362244
:parameter:`ShardingTaskExecutorPoolMaxConnecting` value.
22372245

2238-
You can only set this parameter during start-up and cannot change
2239-
this setting using the :dbcommand:`setParameter` database command.
2246+
The following example sets
2247+
:parameter:`ShardingTaskExecutorPoolMaxConnecting` to ``20``
2248+
during startup:
22402249

22412250
.. code-block:: sh
22422251

22432252
mongos --setParameter ShardingTaskExecutorPoolMaxConnecting=20
22442253

2254+
During runtime, you can also set the parameter with the
2255+
:dbcommand:`setParameter` command:
2256+
2257+
.. code-block:: javascript
2258+
2259+
db.adminCommand( { setParameter: 1, ShardingTaskExecutorPoolMaxConnecting: 20 } )
2260+
22452261
.. parameter:: ShardingTaskExecutorPoolMaxSize
22462262

22472263
Type: integer
@@ -2259,12 +2275,20 @@ Sharding Parameters
22592275

22602276
ShardingTaskExecutorPoolMaxSize * taskExecutorPoolSize
22612277

2262-
You can only set this parameter during start-up and cannot change
2263-
this setting using the :dbcommand:`setParameter` database command.
2278+
The following example sets
2279+
:parameter:`ShardingTaskExecutorPoolMaxSize` to ``20``
2280+
during startup:
22642281

22652282
.. code-block:: sh
22662283

2267-
mongos --setParameter ShardingTaskExecutorPoolMaxSize=4
2284+
mongos --setParameter ShardingTaskExecutorPoolMaxSize=20
2285+
2286+
During runtime, you can also set the parameter with the
2287+
:dbcommand:`setParameter` command:
2288+
2289+
.. code-block:: javascript
2290+
2291+
db.adminCommand( { setParameter: 1, ShardingTaskExecutorPoolMaxSize: 20 } )
22682292

22692293
:binary:`~bin.mongos` can have up to ``n`` TaskExecutor connection
22702294
pools, where ``n`` is the number of cores. See
@@ -2289,13 +2313,21 @@ Sharding Parameters
22892313
connections until :parameter:`ShardingTaskExecutorPoolHostTimeoutMS`
22902314
milliseconds pass without any application using that pool.
22912315

2292-
You can only set this parameter during start-up and cannot change
2293-
this setting using the :dbcommand:`setParameter` database command.
2316+
The following example sets
2317+
:parameter:`ShardingTaskExecutorPoolMinSize` to ``2``
2318+
during startup:
22942319

22952320
.. code-block:: sh
22962321

22972322
mongos --setParameter ShardingTaskExecutorPoolMinSize=2
22982323

2324+
During runtime, you can also set the parameter with the
2325+
:dbcommand:`setParameter` command:
2326+
2327+
.. code-block:: javascript
2328+
2329+
db.adminCommand( { setParameter: 1, ShardingTaskExecutorPoolMinSize: 2 } )
2330+
22992331
:binary:`~bin.mongos` can have up to ``n`` TaskExecutor connection
23002332
pools, where ``n`` is the number of cores. See
23012333
:parameter:`taskExecutorPoolSize`.
@@ -2313,19 +2345,27 @@ Sharding Parameters
23132345
Maximum time the :binary:`~bin.mongos` waits before attempting to
23142346
heartbeat a resting connection in the pool.
23152347

2316-
You can only set this parameter during start-up and cannot change
2317-
this setting using the :dbcommand:`setParameter` database command.
2318-
23192348
If set, :parameter:`ShardingTaskExecutorPoolRefreshRequirementMS` should be
23202349
greater than :parameter:`ShardingTaskExecutorPoolRefreshTimeoutMS`.
23212350
Otherwise, :binary:`~bin.mongos` adjusts the value of
23222351
:parameter:`ShardingTaskExecutorPoolRefreshTimeoutMS` to be less than
23232352
:parameter:`ShardingTaskExecutorPoolRefreshRequirementMS`.
23242353

2325-
.. code-block:: sh
2354+
The following example sets
2355+
:parameter:`ShardingTaskExecutorPoolRefreshRequirementMS` to
2356+
``90000`` during startup:
2357+
2358+
.. code-block:: bash
23262359

23272360
mongos --setParameter ShardingTaskExecutorPoolRefreshRequirementMS=90000
23282361

2362+
During runtime, you can also set the parameter with the
2363+
:dbcommand:`setParameter` command:
2364+
2365+
.. code-block:: javascript
2366+
2367+
db.adminCommand( { setParameter: 1, ShardingTaskExecutorPoolRefreshRequirementMS: 90000 } )
2368+
23292369
.. parameter:: ShardingTaskExecutorPoolRefreshTimeoutMS
23302370

23312371
Type: integer
@@ -2337,19 +2377,27 @@ Sharding Parameters
23372377
Maximum time the :binary:`~bin.mongos` waits for a heartbeat before
23382378
timing out the heartbeat.
23392379

2340-
You can only set this parameter during start-up and cannot change
2341-
this setting using the :dbcommand:`setParameter` database command.
2342-
23432380
If set, :parameter:`ShardingTaskExecutorPoolRefreshTimeoutMS` should be
23442381
less than :parameter:`ShardingTaskExecutorPoolRefreshRequirementMS`.
23452382
Otherwise, :binary:`~bin.mongos` adjusts the value of
23462383
:parameter:`ShardingTaskExecutorPoolRefreshTimeoutMS` to be less than
23472384
:parameter:`ShardingTaskExecutorPoolRefreshRequirementMS`.
23482385

2349-
.. code-block:: sh
2386+
The following example sets
2387+
:parameter:`ShardingTaskExecutorPoolRefreshTimeoutMS` to
2388+
``30000`` during startup:
2389+
2390+
.. code-block:: bash
23502391

23512392
mongos --setParameter ShardingTaskExecutorPoolRefreshTimeoutMS=30000
23522393

2394+
During runtime, you can also set the parameter with the
2395+
:dbcommand:`setParameter` command:
2396+
2397+
.. code-block:: javascript
2398+
2399+
db.adminCommand( { setParameter: 1, ShardingTaskExecutorPoolRefreshTimeoutMS: 30000 } )
2400+
23532401
.. parameter:: ShardingTaskExecutorPoolReplicaSetMatching
23542402

23552403
.. versionadded:: 4.2

0 commit comments

Comments
 (0)