<!-- 
RSS generated by JIRA (9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66) at Thu Feb 08 07:55:43 UTC 2024

It is possible to restrict the fields that are returned in this document by specifying the 'field' parameter in your request.
For example, to request only the issue key and summary append 'field=key&field=summary' to the URL of your request.
-->
<rss version="0.92" >
<channel>
    <title>MongoDB Jira</title>
    <link>https://jira.mongodb.org</link>
    <description>This file is an XML representation of an issue</description>
    <language>en-us</language>    <build-info>
        <version>9.7.1</version>
        <build-number>970001</build-number>
        <build-date>13-04-2023</build-date>
    </build-info>


<item>
            <title>[DOCS-8140] Document the new balancer control commands and the deprecation of the old shell&apos;s balancer control scripts</title>
                <link>https://jira.mongodb.org/browse/DOCS-8140</link>
                <project id="10380" key="DOCS">Documentation</project>
                    <description>&lt;p&gt;Prior to v3.4, the start/stopBalancer shell scripts were using the &lt;tt&gt;config.settings&lt;/tt&gt; section plus the state of the balancer lock in order to set the balancer state.&lt;/p&gt;

&lt;p&gt;In sharding 3.4, the balancer is running on the CSRS primary and it permanently holds the balancer lock in order to prevent any legacy 3.2 mongos instance from attempting to do balancing. Since the old shell scripts for start/stopBalancer relied on the state of the balancer lock to determine whether it is running, with this change these old scripts no longer work.&lt;/p&gt;

&lt;p&gt;The new way to interact with the balancer in 3.4 is through the &lt;tt&gt;startBalancer/stopBalancer/balancerStatus&lt;/tt&gt; commands. The way they work is:&lt;/p&gt;
&lt;ul&gt;
	&lt;li&gt;startBalancer - starts the balancer thread, but does not wait for a balancer round.&lt;/li&gt;
	&lt;li&gt;stopBalancer - waits for any active balancer round to complete and then stops the balancer. No more balancing will occur until &lt;tt&gt;startBalancer&lt;/tt&gt; is called.&lt;/li&gt;
	&lt;li&gt;balancerStatus - returns information about the run-time status of the balancer. This information is available on both primary and secondary, but only meaningful when read from the primary:
	&lt;ul&gt;
		&lt;li&gt;mode (string) - State of the balancer. Can be one of &quot;full&quot; (balancer is active, but not necessarily doing balancing at this moment), &quot;off&quot; (balancer is stopped and will not be doing any chunk movements).&lt;/li&gt;
		&lt;li&gt;inBalancerRound (boolean) - indicates whether the balancer is currently actively moving chunks or sleeping.&lt;/li&gt;
		&lt;li&gt;numBalancerRounds (number) - indicates the number of balancer rounds which have been done since the node was last started. This value is not persisted anywhere, is reset to 0 on node restart and will remain at its last value if the node is not primary or if the balancer is stopped.&lt;/li&gt;
	&lt;/ul&gt;
	&lt;/li&gt;
&lt;/ul&gt;


&lt;p&gt;&lt;b&gt;Backwards compatibility&lt;/b&gt;&lt;br/&gt;
This section is about the backwards compatibility of the start/stopBalancer shell scripts.&lt;/p&gt;

&lt;p&gt;The 3.4 shell is backwards compatible with sharded clusters, which are running all components on 3.2 or earlier (config, shards and mongos).&lt;/p&gt;

&lt;p&gt;The 3.2 and earlier shell is &lt;b&gt;not&lt;/b&gt; compatible with 3.4 clusters.&lt;/p&gt;

&lt;p&gt;For clusters which are in the process of being upgraded, the following rules apply:&lt;/p&gt;

&lt;p&gt;If only the CSRS config server primary has been upgraded to 3.4, but not the shards and mongos, neither the old shell balancer control will work, nor the 3.4 one. In order to be able to control the balancer in this state, a one-off mongos instance needs to be spawned so the balancer control commands are available.&lt;/p&gt;</description>
                <environment></environment>
        <key id="295467">DOCS-8140</key>
            <summary>Document the new balancer control commands and the deprecation of the old shell&apos;s balancer control scripts</summary>
                <type id="3" iconUrl="https://jira.mongodb.org/secure/viewavatar?size=xsmall&amp;avatarId=14718&amp;avatarType=issuetype">Task</type>
                                            <priority id="2" iconUrl="https://jira.mongodb.org/images/icons/priorities/critical.svg">Critical - P2</priority>
                        <status id="6" iconUrl="https://jira.mongodb.org/images/icons/statuses/closed.png" description="The issue is considered finished, the resolution is correct. Issues which are closed can be reopened.">Closed</status>
                    <statusCategory id="3" key="done" colorName="success"/>
                                    <resolution id="9">Done</resolution>
                                        <assignee username="kay.kim@mongodb.com">Kay Kim</assignee>
                                    <reporter username="kaloian.manassiev@mongodb.com">Kaloian Manassiev</reporter>
                        <labels>
                    </labels>
                <created>Tue, 21 Jun 2016 13:23:55 +0000</created>
                <updated>Sat, 4 Mar 2023 01:37:15 +0000</updated>
                            <resolved>Mon, 28 Nov 2016 22:08:05 +0000</resolved>
                                                    <fixVersion>3.4.0</fixVersion>
                    <fixVersion>mongodb-3.4p1</fixVersion>
                    <fixVersion>DOCS Q3 W10</fixVersion>
                    <fixVersion>DOCS Q3 W10-part_deux</fixVersion>
                                    <component>Server</component>
                        <due></due>
                            <votes>0</votes>
                                    <watches>6</watches>
                                                                                                                <comments>
                            <comment id="1443910" author="xgen-internal-githook" created="Mon, 28 Nov 2016 21:47:12 +0000"  >&lt;p&gt;Author:&lt;/p&gt;
{u&apos;username&apos;: u&apos;kay-kim&apos;, u&apos;name&apos;: u&apos;kay&apos;, u&apos;email&apos;: u&apos;kay.kim@10gen.com&apos;}
&lt;p&gt;Message: &lt;a href=&quot;https://jira.mongodb.org/browse/DOCS-8140&quot; title=&quot;Document the new balancer control commands and the deprecation of the old shell&amp;#39;s balancer control scripts&quot; class=&quot;issue-link&quot; data-issue-key=&quot;DOCS-8140&quot;&gt;&lt;del&gt;DOCS-8140&lt;/del&gt;&lt;/a&gt; mongo shell balancer command updates per 3.4&lt;br/&gt;
Branch: master&lt;br/&gt;
&lt;a href=&quot;https://github.com/mongodb/docs/commit/07ccfb0bb8fea115272540db62fadb4799f67303&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/docs/commit/07ccfb0bb8fea115272540db62fadb4799f67303&lt;/a&gt;&lt;/p&gt;</comment>
                            <comment id="1409211" author="kay.kim@10gen.com" created="Fri, 14 Oct 2016 20:52:52 +0000"  >&lt;p&gt;I think we might have been looking at the wrong SERVER ticket. I believe the main SERVER ticket for this is indeed fixed and going.&lt;/p&gt;

&lt;p&gt;The ticket you were looking at &amp;#8211; that is an effect &lt;img class=&quot;emoticon&quot; src=&quot;https://jira.mongodb.org/images/icons/emoticons/help_16.png&quot; height=&quot;16&quot; width=&quot;16&quot; align=&quot;absmiddle&quot; alt=&quot;&quot; border=&quot;0&quot;/&gt; of the main SERVER ticket.&lt;/p&gt;

&lt;p&gt;cc: &lt;a href=&quot;https://jira.mongodb.org/secure/ViewProfile.jspa?name=emily.hall&quot; class=&quot;user-hover&quot; rel=&quot;emily.hall&quot;&gt;emily.hall&lt;/a&gt;&lt;/p&gt;</comment>
                            <comment id="1396291" author="emily.hall" created="Wed, 28 Sep 2016 23:28:47 +0000"  >&lt;p&gt;Closing issue because linked Server ticket was resolved as &quot;Won&apos;t Fix&quot;&lt;/p&gt;</comment>
                    </comments>
                <issuelinks>
                            <issuelinktype id="10011">
                    <name>Depends</name>
                                            <outwardlinks description="depends on">
                                        <issuelink>
            <issuekey id="295839">SERVER-24720</issuekey>
        </issuelink>
                            </outwardlinks>
                                                        </issuelinktype>
                            <issuelinktype id="10012">
                    <name>Related</name>
                                            <outwardlinks description="related to">
                                        <issuelink>
            <issuekey id="305237">SERVER-25361</issuekey>
        </issuelink>
                            </outwardlinks>
                                                        </issuelinktype>
                    </issuelinks>
                <attachments>
                    </attachments>
                <subtasks>
                    </subtasks>
                <customfields>
                                                <customfield id="customfield_10050" key="com.atlassian.jira.toolkit:comments">
                        <customfieldname># Replies</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>3.0</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        <customfield id="customfield_10055" key="com.atlassian.jira.ext.charting:firstresponsedate">
                        <customfieldname>Date of 1st Reply</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>Sat, 30 Jul 2016 15:42:09 +0000</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10052" key="com.atlassian.jira.toolkit:dayslastcommented">
                        <customfieldname>Days since reply</customfieldname>
                        <customfieldvalues>
                                        7 years, 11 weeks, 2 days ago
    
                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_18254" key="com.onresolve.jira.groovy.groovyrunner:scripted-field">
                        <customfieldname>Dependencies</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue><![CDATA[<s><a href='https://jira.mongodb.org/browse/SERVER-24720'>SERVER-24720</a></s>]]></customfieldvalue>


                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_15850" key="com.atlassian.jira.plugins.jira-development-integration-plugin:devsummary">
                        <customfieldname>Development</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                            <customfield id="customfield_10857" key="com.pyxis.greenhopper.jira:gh-epic-link">
                        <customfieldname>Epic Link</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>DOCS-8747</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            <customfield id="customfield_10057" key="com.atlassian.jira.toolkit:lastusercommented">
                        <customfieldname>Last comment by Customer</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>true</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10056" key="com.atlassian.jira.toolkit:lastupdaterorcommenter">
                        <customfieldname>Last commenter</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>dbeng-pm-bot</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_11151" key="com.atlassian.jira.toolkit:LastCommentDate">
                        <customfieldname>Last public comment date</customfieldname>
                        <customfieldvalues>
                            7 years, 11 weeks, 2 days ago
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                            <customfield id="customfield_10051" key="com.atlassian.jira.toolkit:participants">
                        <customfieldname>Participants</customfieldname>
                        <customfieldvalues>
                                        <customfieldvalue>emily.hall</customfieldvalue>
            <customfieldvalue>xgen-internal-githook</customfieldvalue>
            <customfieldvalue>kaloian.manassiev@mongodb.com</customfieldvalue>
            <customfieldvalue>kay.kim@mongodb.com</customfieldvalue>
    
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                        <customfield id="customfield_14254" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Product Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>1|hrmplz:</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                <customfield id="customfield_12550" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>2|hs6ui7:</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10558" key="com.pyxis.greenhopper.jira:gh-global-rank">
                        <customfieldname>Rank (Obsolete)</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>9223372036854775807</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                            <customfield id="customfield_22279" key="com.atlassian.jira.plugin.system.customfieldtypes:labels">
                        <customfieldname>Server Compat</customfieldname>
                        <customfieldvalues>
                                        <label>3.3</label>
    
                        </customfieldvalues>
                    </customfield>
                                                                                            <customfield id="customfield_10557" key="com.pyxis.greenhopper.jira:gh-sprint">
                        <customfieldname>Sprint</customfieldname>
                        <customfieldvalues>
                                <customfieldvalue id="1324">KANBAN BUCKET</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                                                                        <customfield id="customfield_10555" key="com.atlassian.jira.plugin.system.customfieldtypes:float">
                        <customfieldname>Story Points</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>1.5</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                <customfield id="customfield_10053" key="com.atlassian.jira.ext.charting:timeinstatus">
                        <customfieldname>Time In Status</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            <customfield id="customfield_14350" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>serverRank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>1|hrzc1j:</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                </customfields>
    </item>
</channel>
</rss>