Uploaded image for project: 'Documentation'
  1. Documentation
  2. DOCS-12880

Investigate changes in SERVER-41195: Turn off auto-splitting when the balancer is turned off

    XMLWordPrintableJSON

Details

    • Icon: Task Task
    • Resolution: Fixed
    • Icon: Major - P3 Major - P3
    • 4.3.1, 4.2.0-rc5
    • None
    • None
    • None

    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.)

      Attachments

        Activity

          People

            kay.kim@mongodb.com Kay Kim (Inactive)
            backlog-server-pm Backlog - Core Eng Program Management Team
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved:
              4 years, 28 weeks, 2 days ago