Skip to content

Commit 0e3f33b

Browse files
jason-price-mongodbjason-price-mongodb
andauthored
DOCS-15028 sharding task executor pool min size without restart (#386) (#413)
* 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 ab92607 commit 0e3f33b

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

2840-
You can only set this parameter during start-up and cannot change
2841-
this setting using the :dbcommand:`setParameter` database command.
2842-
28432840
If set, :parameter:`ShardingTaskExecutorPoolHostTimeoutMS` should be
28442841
greater than the sum of
28452842
:parameter:`ShardingTaskExecutorPoolRefreshRequirementMS` and
@@ -2848,10 +2845,21 @@ Sharding Parameters
28482845
:parameter:`ShardingTaskExecutorPoolHostTimeoutMS` to be greater than the
28492846
sum.
28502847

2848+
The following example sets
2849+
:parameter:`ShardingTaskExecutorPoolHostTimeoutMS` to ``120000``
2850+
during startup:
2851+
28512852
.. code-block:: bash
28522853

28532854
mongos --setParameter ShardingTaskExecutorPoolHostTimeoutMS=120000
28542855

2856+
During runtime, you can also set the parameter with the
2857+
:dbcommand:`setParameter` command:
2858+
2859+
.. code-block:: javascript
2860+
2861+
db.adminCommand( { setParameter: 1, ShardingTaskExecutorPoolHostTimeoutMS: 120000 } )
2862+
28552863
.. parameter:: ShardingTaskExecutorPoolMaxConnecting
28562864

28572865
.. versionadded:: 3.6
@@ -2873,13 +2881,21 @@ Sharding Parameters
28732881
If it is greater, :binary:`~bin.mongos` ignores the
28742882
:parameter:`ShardingTaskExecutorPoolMaxConnecting` value.
28752883

2876-
You can only set this parameter during start-up and cannot change
2877-
this setting using the :dbcommand:`setParameter` database command.
2884+
The following example sets
2885+
:parameter:`ShardingTaskExecutorPoolMaxConnecting` to ``20``
2886+
during startup:
28782887

28792888
.. code-block:: bash
28802889

28812890
mongos --setParameter ShardingTaskExecutorPoolMaxConnecting=20
28822891

2892+
During runtime, you can also set the parameter with the
2893+
:dbcommand:`setParameter` command:
2894+
2895+
.. code-block:: javascript
2896+
2897+
db.adminCommand( { setParameter: 1, ShardingTaskExecutorPoolMaxConnecting: 20 } )
2898+
28832899
.. parameter:: ShardingTaskExecutorPoolMaxSize
28842900

28852901
Type: integer
@@ -2897,12 +2913,20 @@ Sharding Parameters
28972913

28982914
ShardingTaskExecutorPoolMaxSize * taskExecutorPoolSize
28992915

2900-
You can only set this parameter during start-up and cannot change
2901-
this setting using the :dbcommand:`setParameter` database command.
2916+
The following example sets
2917+
:parameter:`ShardingTaskExecutorPoolMaxSize` to ``20``
2918+
during startup:
29022919

29032920
.. code-block:: bash
29042921

2905-
mongos --setParameter ShardingTaskExecutorPoolMaxSize=4
2922+
mongos --setParameter ShardingTaskExecutorPoolMaxSize=20
2923+
2924+
During runtime, you can also set the parameter with the
2925+
:dbcommand:`setParameter` command:
2926+
2927+
.. code-block:: javascript
2928+
2929+
db.adminCommand( { setParameter: 1, ShardingTaskExecutorPoolMaxSize: 20 } )
29062930

29072931
:binary:`~bin.mongos` can have up to ``n`` TaskExecutor connection
29082932
pools, where ``n`` is the number of cores. See
@@ -2942,13 +2966,21 @@ Sharding Parameters
29422966
:parameter:`warmMinConnectionsInShardingTaskExecutorPoolOnStartup`
29432967
parameter is enabled by default for the :binary:`~bin.mongos`.
29442968

2945-
You can only set this parameter during start-up and cannot change
2946-
this setting using the :dbcommand:`setParameter` database command.
2969+
The following example sets
2970+
:parameter:`ShardingTaskExecutorPoolMinSize` to ``2``
2971+
during startup:
29472972

29482973
.. code-block:: bash
29492974

29502975
mongos --setParameter ShardingTaskExecutorPoolMinSize=2
29512976

2977+
During runtime, you can also set the parameter with the
2978+
:dbcommand:`setParameter` command:
2979+
2980+
.. code-block:: javascript
2981+
2982+
db.adminCommand( { setParameter: 1, ShardingTaskExecutorPoolMinSize: 2 } )
2983+
29522984
:binary:`~bin.mongos` can have up to ``n`` TaskExecutor connection
29532985
pools, where ``n`` is the number of cores. See
29542986
:parameter:`taskExecutorPoolSize`.
@@ -2969,19 +3001,27 @@ Sharding Parameters
29693001
Maximum time the :binary:`~bin.mongos` waits before attempting to
29703002
heartbeat a resting connection in the pool.
29713003

2972-
You can only set this parameter during start-up and cannot change
2973-
this setting using the :dbcommand:`setParameter` database command.
2974-
29753004
If set, :parameter:`ShardingTaskExecutorPoolRefreshRequirementMS` should be
29763005
greater than :parameter:`ShardingTaskExecutorPoolRefreshTimeoutMS`.
29773006
Otherwise, :binary:`~bin.mongos` adjusts the value of
29783007
:parameter:`ShardingTaskExecutorPoolRefreshTimeoutMS` to be less than
29793008
:parameter:`ShardingTaskExecutorPoolRefreshRequirementMS`.
29803009

3010+
The following example sets
3011+
:parameter:`ShardingTaskExecutorPoolRefreshRequirementMS` to
3012+
``90000`` during startup:
3013+
29813014
.. code-block:: bash
29823015

29833016
mongos --setParameter ShardingTaskExecutorPoolRefreshRequirementMS=90000
29843017

3018+
During runtime, you can also set the parameter with the
3019+
:dbcommand:`setParameter` command:
3020+
3021+
.. code-block:: javascript
3022+
3023+
db.adminCommand( { setParameter: 1, ShardingTaskExecutorPoolRefreshRequirementMS: 90000 } )
3024+
29853025
.. parameter:: ShardingTaskExecutorPoolRefreshTimeoutMS
29863026

29873027
Type: integer
@@ -2993,19 +3033,27 @@ Sharding Parameters
29933033
Maximum time the :binary:`~bin.mongos` waits for a heartbeat before
29943034
timing out the heartbeat.
29953035

2996-
You can only set this parameter during start-up and cannot change
2997-
this setting using the :dbcommand:`setParameter` database command.
2998-
29993036
If set, :parameter:`ShardingTaskExecutorPoolRefreshTimeoutMS` should be
30003037
less than :parameter:`ShardingTaskExecutorPoolRefreshRequirementMS`.
30013038
Otherwise, :binary:`~bin.mongos` adjusts the value of
30023039
:parameter:`ShardingTaskExecutorPoolRefreshTimeoutMS` to be less than
30033040
:parameter:`ShardingTaskExecutorPoolRefreshRequirementMS`.
30043041

3042+
The following example sets
3043+
:parameter:`ShardingTaskExecutorPoolRefreshTimeoutMS` to
3044+
``30000`` during startup:
3045+
30053046
.. code-block:: bash
30063047

30073048
mongos --setParameter ShardingTaskExecutorPoolRefreshTimeoutMS=30000
30083049

3050+
During runtime, you can also set the parameter with the
3051+
:dbcommand:`setParameter` command:
3052+
3053+
.. code-block:: javascript
3054+
3055+
db.adminCommand( { setParameter: 1, ShardingTaskExecutorPoolRefreshTimeoutMS: 30000 } )
3056+
30093057
.. parameter:: ShardingTaskExecutorPoolReplicaSetMatching
30103058

30113059
.. versionadded:: 4.2

0 commit comments

Comments
 (0)