[DOCS-12383] Docs for SERVER-9043: Link `flushRouterConfig` on the config server and shards Created: 22/Jan/19  Updated: 13/Nov/23  Resolved: 26/Feb/19

Status: Closed
Project: Documentation
Component/s: manual, Server
Affects Version/s: None
Fix Version/s: 4.0.6, 4.1.8, 3.6.11, Server_Docs_20231030, Server_Docs_20231106, Server_Docs_20231105, Server_Docs_20231113

Type: Task Priority: Major - P3
Reporter: Kay Kim (Inactive) Assignee: Kay Kim (Inactive)
Resolution: Fixed Votes: 0
Labels: ShardingRoughEdges, neweng
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Issue Links:
Documented
documents SERVER-9043 Link `flushRouterConfig` on the confi... Closed
Participants:
Days since reply: 4 years, 49 weeks, 3 days ago
Epic Link: DOCS: 4.2 Server/Tools

 Description   

Description

Description:

With this change, the flushRouterConfig command is now available on all nodes (shards and config server), so the linked documentation needs to be updated to say that.

In addition, starting in version 3.4, the instructions in points 6 and 7 are not correct anymore. The balancer doesn't need to be restarted, instead, they should be:

6) Clear current cluster meta information. After the jumbo flag has been cleared out from the chunks collection, run flushRouterConfig: <DB.collection> directly against the config server primary.

Engineering Ticket Description:

Currently there is the ability to flush router config on mongos nodes. The Primary nodes in repl sets also hold some cached config information in ChunkManager. Currently the way to 'flush' this information from a Primary is to step down, causing a new Primary to be elected. If the functionality existed that allowed a similar operation to FlushRouterConfig to run on Primaries, then this step down could be avoided in those cases where it currently is used.

Scope of changes

  • source/includes/ref-toc-command-sharding.yaml
  • source/reference/command/flushRouterConfig.txt
  • source/includes/steps-clear-jumbo-flag.yaml
  • source/reference/command/movePrimary.txt
  • source/tutorial/remove-shards-from-cluster.txt <<- include the flushRouterConfig blurb found in movePrimary here.

Impact to Other Docs

MVP (Work and Date)

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



 Comments   
Comment by Githook User [ 04/Mar/19 ]

Author:

{'name': 'Kay Kim', 'username': 'kay-kim', 'email': 'kay.kim@10gen.com'}

Message: DOCS-12383: backport to 3.6.11 flushRouterConfig
Branch: v3.6
https://github.com/mongodb/docs/commit/b13c8d3e82f6bbb094e3f875c339efcd8dd43e42

Comment by Githook User [ 26/Feb/19 ]

Author:

{'name': 'Kay Kim', 'email': 'kay.kim@10gen.com', 'username': 'kay-kim'}

Message: DOCS-12383: backport to 3.4 for jumbo flag and routing clearance
Branch: v3.4
https://github.com/mongodb/docs/commit/a09b5ec9109239595fbfb67631e80ed9295baec1

Comment by Githook User [ 26/Feb/19 ]

Author:

{'name': 'Kay Kim', 'email': 'kay.kim@10gen.com', 'username': 'kay-kim'}

Message: DOCS-12383: backport to 3.6.11 flushRouterConfig
Branch: v3.6.11
https://github.com/mongodb/docs/commit/3c27e9bef8cd13363862c72bc4912db1417b9c0a

Comment by Githook User [ 26/Feb/19 ]

Author:

{'name': 'Kay Kim', 'username': 'kay-kim', 'email': 'kay.kim@10gen.com'}

Message: DOCS-12383: flushRouterConfig
Branch: v4.0
https://github.com/mongodb/docs/commit/cc322996b275a5d1932b4a1f748b40a3269ec7f8

Comment by Githook User [ 26/Feb/19 ]

Author:

{'name': 'Kay Kim', 'email': 'kay.kim@10gen.com', 'username': 'kay-kim'}

Message: DOCS-12383: flushRouterConfig
Branch: master
https://github.com/mongodb/docs/commit/8705507f824f765c79eab2e981310fd4ea8e3b01

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