[DOCS-14167] Investigate changes in SERVER-53394: Make ShardingTaskExecutorPoolReplicaSetMatching default to disabled for MongoD Created: 29/Jan/21  Updated: 13/Nov/23  Resolved: 25/Mar/21

Status: Closed
Project: Documentation
Component/s: manual, Server
Affects Version/s: None
Fix Version/s: 4.9.0, 4.2.13, 4.4.5, Server_Docs_20231030, Server_Docs_20231106, Server_Docs_20231105, Server_Docs_20231113

Type: Task Priority: Major - P3
Reporter: Backlog - Core Eng Program Management Team Assignee: Naomi Pentrel (Inactive)
Resolution: Done Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Issue Links:
Backports
backported by DOCS-14208 [BACKPORT] [v4.2] Make ShardingTaskEx... Closed
backported by DOCS-14236 [BACKPORT] [v4.4] Make ShardingTaskEx... Closed
Documented
documents SERVER-53394 Make ShardingTaskExecutorPoolReplicaS... Closed
Participants:
Days since reply: 2 years, 43 weeks, 6 days ago
Epic Link: DOCSP-9747
Story Points: 2

 Description   

Description

Downstream Change Summary

Downstream changes:
Configuration Changes (Atlas, STAR, docs)
The ShardingTaskExecutorPoolReplicaSetMatching server parameter (see https://docs.mongodb.com/manual/reference/parameters/#param.ShardingTaskExecutorPoolReplicaSetMatching) has a new possible value, "automatic". This new value is now the default. The behavior of this new value depends on the process: on mongos, it is identical to the existing "matchPrimaryNode" option; on mongod, it is identical to the existing "disabled" option. (On mongos, this parameter determines the minimum size limit of the mongos instance's connection pools to the secondaries of the cluster's shards; on mongod, this parameter determines the minimum size limit of the mongod instance's connection pools to the secondaries of other shards in the cluster.)

Command results changes (ADL, drivers, BIC, docs):
The connPoolStats command output now contains an additional field, "replicaSetMatchingStrategy"; the value of this field describes the actual policy used by that process to determine the min size of connection pools from that server to RS secondaries in (other) shards. The policy will either be "matchPrimaryNode", "matchBusiestNode", or "disabled", with the behavior described by the existing docs for the STEPRSM parameter. Note that even if the "automatic" value is used to set the server parameter, the "replicaSetMatchingStrategy" field in the connPoolStats output will describe the actual policy being used, not "automatic." This contrasts with the output of using getParameter() to find the value of the STEPRSM parameter, which will display "automatic" if that is the value of the server parameter.

Description of Linked Ticket

We currently set ShardingTaskExecutorPoolReplicaSetMatching to "matchPrimaryNode" by default for both MongoD and MongoS (see here). However, the "matchPrimaryNode" behavior can be problematic for topologies when multiple shardsvrs experience a rapid influx of cross-shard operations. We should disable this behavior on MongoD nodes but not MongoS nodes.

Scope of changes

Impact to Other Docs

MVP (Work and Date)

Resources (Scope or Design Docs, Invision, etc.)



 Comments   
Comment by Githook User [ 08/Apr/21 ]

Author:

{'name': 'Naomi Pentrel', 'email': '5212232+npentrel@users.noreply.github.com', 'username': 'npentrel'}

Message: DOCS-14167 ReplicaSetMatching default to disabled
Branch: master
https://github.com/mongodb/docs/commit/1267728ec2feaf643e25fdd1dffa64a6632aea22

Comment by Githook User [ 25/Mar/21 ]

Author:

{'name': 'Naomi Pentrel', 'email': '5212232+npentrel@users.noreply.github.com', 'username': 'npentrel'}

Message: DOCS-14167 ReplicaSetMatching default to disabled
Branch: v4.4.5
https://github.com/mongodb/docs/commit/1267728ec2feaf643e25fdd1dffa64a6632aea22

Comment by Githook User [ 25/Mar/21 ]

Author:

{'name': 'Naomi Pentrel', 'email': '5212232+npentrel@users.noreply.github.com', 'username': 'npentrel'}

Message: DOCS-14167 ReplicaSetMatching default to disabled
Branch: v4.2
https://github.com/mongodb/docs/commit/2d8847b438704eba2a8ef183f8c9acfdcdbd191c

Comment by Githook User [ 25/Mar/21 ]

Author:

{'name': 'Naomi Pentrel', 'email': '5212232+npentrel@users.noreply.github.com', 'username': 'npentrel'}

Message: DOCS-14167 ReplicaSetMatching default to disabled
Branch: v5.0
https://github.com/mongodb/docs/commit/5964709d0312911aff21bd135fe685d4ce4a1c11

Generated at Thu Feb 08 08:09:41 UTC 2024 using Jira 9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66.