[DOCS-12880] Investigate changes in SERVER-41195: Turn off auto-splitting when the balancer is turned off Created: 11/Jul/19  Updated: 29/Oct/23  Resolved: 29/Jul/19

Status: Closed
Project: Documentation
Component/s: None
Affects Version/s: None
Fix Version/s: 4.3.1, 4.2.0-rc5

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

Issue Links:
Documented
documents SERVER-41195 Turn off auto-splitting when the bala... Closed
Participants:
Days since reply: 4 years, 28 weeks, 2 days ago
Epic Link: DOCS: 4.2 Server/Tools
Story Points: 0.1

 Description   

Description

SERVER ticket description

Currently, turning off the balancer doesn't turn off auto-splitting, which has caused confusion in the field, because customers continue to observe metadata refreshes. For better customer experience we should also turn off auto-splitting, when the balancer is turned off.

Since it almost never makes sense for the balancer to be on, but the auto-splitter to be off, I propose the following behaviour change of the balancerStart / balancerStop commands:

  • balancerStop - both stops the balancer and sets the auto-splitter setting to false
  • balancerStart - both starts the balancer and sets the auto-splitter setting to true

As a result, start/stop of the balancer will completely forget what was the previous auto-splitter setting.

Customers who wish to run balancer off/auto-splitter on or vice-versa configurations, will have to do it through direct writes to config.settings.

Change Description:

stopBalancer now disables autoSplit and startBalancer enables autoSplit

Scope of changes

Command and helpers

  • source/reference/command/balancerStart.txt
  • source/reference/command/balancerStop.txt
  • source/reference/method/sh.setBalancerState.txt
  • source/reference/method/sh.startBalancer.txt
  • source/reference/method/sh.stopBalancer.txt

Rel Notes

  • source/release-notes/4.2-compatibility.txt
  • source/release-notes/4.2.txt
  • source/includes/extracts-4.2-changes.yaml

Upgrade/Downgrade

  • source/includes/steps-4.2-downgrade-sharded-cluster.yaml
  • source/includes/steps-4.2-upgrade-sharded-cluster.yaml
  • source/includes/steps-upgrade-enterprise-sharded-cluster.yaml

Various other places where we stop/start balancer

  • source/tutorial/build-indexes-on-sharded-clusters.txt
  • source/tutorial/manage-sharded-cluster-balancer.txt
  • source/tutorial/migrate-sharded-cluster-to-new-hardware.txt
  • source/tutorial/restore-sharded-cluster.txt
  • source/includes/steps-backup-sharded-cluster-with-snapshots.yaml
  • source/includes/steps-enable-authentication-in-sharded-cluster.yaml
  • source/includes/steps-schedule-balancer-window.yaml

misc reference

  • source/reference/method/sh.status.txt
  • source/reference/config-database.txt

autosplit methods

  • source/reference/method/sh.enableAutoSplit.txt
  • source/reference/method/sh.disableAutoSplit.txt
     

    Impact to Other Docs

    MVP (Work and Date)

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



 Comments   
Comment by Githook User [ 29/Jul/19 ]

Author:

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

Message: DOCS-12880: 4.2 autosplit and balancer start/stop
Branch: master
https://github.com/mongodb/docs/commit/df6db63d83fc112cbdd4ce86c6f94f37a659acaf

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