<!-- 
RSS generated by JIRA (9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66) at Thu Feb 08 08:10:37 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-14542] Server: Update tables for resharding-related donor, recipient, and coordinator states</title>
                <link>https://jira.mongodb.org/browse/DOCS-14542</link>
                <project id="10380" key="DOCS">Documentation</project>
                    <description>&lt;h2&gt;&lt;a name=&quot;Description&quot;&gt;&lt;/a&gt;Description&lt;/h2&gt;
&lt;p&gt;The Sharding team&apos;s work on the resharding project after &lt;a href=&quot;https://jira.mongodb.org/browse/DOCS-14197&quot; title=&quot;Investigate changes in SERVER-50976: Add currentOp reporting for ReshardingCoordinatorService Instances&quot; class=&quot;issue-link&quot; data-issue-key=&quot;DOCS-14197&quot;&gt;&lt;del&gt;DOCS-14197&lt;/del&gt;&lt;/a&gt;, &lt;a href=&quot;https://jira.mongodb.org/browse/DOCS-14195&quot; title=&quot;Investigate changes in SERVER-51021: Add currentOp reporting for ReshardingRecipientService Instances&quot; class=&quot;issue-link&quot; data-issue-key=&quot;DOCS-14195&quot;&gt;&lt;del&gt;DOCS-14195&lt;/del&gt;&lt;/a&gt;, &lt;a href=&quot;https://jira.mongodb.org/browse/DOCS-14193&quot; title=&quot;Investigate changes in SERVER-50978: Add currentOp reporting for ReshardingDonorService Instances&quot; class=&quot;issue-link&quot; data-issue-key=&quot;DOCS-14193&quot;&gt;&lt;del&gt;DOCS-14193&lt;/del&gt;&lt;/a&gt;, and &lt;a href=&quot;https://jira.mongodb.org/browse/DOCS-14084&quot; title=&quot;Investigate changes in SERVER-52773: Add &amp;quot;resharding&amp;quot; section to server status&quot; class=&quot;issue-link&quot; data-issue-key=&quot;DOCS-14084&quot;&gt;&lt;del&gt;DOCS-14084&lt;/del&gt;&lt;/a&gt; were originally completed has led to some of the donor, recipient, and coordinators either being renamed or removed altogether. The following is a summary of the changes with references to the code and documentation:&lt;/p&gt;

&lt;h6&gt;&lt;a name=&quot;Donorstates&quot;&gt;&lt;/a&gt;Donor states&lt;/h6&gt;

&lt;ul&gt;
	&lt;li&gt;The &quot;preparing&amp;#45;to&amp;#45;mirror&quot; state was renamed to &quot;preparing&amp;#45;to&amp;#45;block&amp;#45;writes&quot;. The meaning changed slightly from before where the donor shard is now only &lt;em&gt;about to&lt;/em&gt; prevent new incoming write operations to the collection being resharded and isn&apos;t actually preventing them yet. (see also &lt;a href=&quot;https://jira.mongodb.org/browse/SERVER-57952&quot; title=&quot;Resharding donor shards cannot complete a shard version refresh after acquiring the critical section, stalling the resharding operation&quot; class=&quot;issue-link&quot; data-issue-key=&quot;SERVER-57952&quot;&gt;&lt;del&gt;SERVER-57952&lt;/del&gt;&lt;/a&gt;)&lt;/li&gt;
	&lt;li&gt;The &quot;mirroring&quot; state was renamed to &quot;blocking&amp;#45;writes&quot;.&lt;/li&gt;
	&lt;li&gt;The &quot;dropping&quot; state was removed.&lt;/li&gt;
	&lt;li&gt;The numeric value for some of the states were reassigned - (5) is &quot;error&quot;, (6) is &quot;blocking&amp;#45;writes&quot;, and (7) is &quot;done&quot;.&lt;/li&gt;
&lt;/ul&gt;


&lt;p&gt;&lt;a href=&quot;https://github.com/mongodb/mongo/blob/5bea2fccdf860e9119712d39b7d2da788fe63708/src/mongo/s/resharding/common_types.idl#L54-L64&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/mongo/blob/5bea2fccdf860e9119712d39b7d2da788fe63708/src/mongo/s/resharding/common_types.idl#L54-L64&lt;/a&gt;&lt;br/&gt;
&lt;a href=&quot;https://docs.mongodb.com/v5.0/reference/command/serverStatus/#mongodb-serverstatus-serverstatus.shardingStatistics.resharding.donorState&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://docs.mongodb.com/v5.0/reference/command/serverStatus/#mongodb-serverstatus-serverstatus.shardingStatistics.resharding.donorState&lt;/a&gt;&lt;br/&gt;
&lt;a href=&quot;https://docs.mongodb.com/v5.0/reference/operator/aggregation/currentOp/#mongodb-data--currentOp.donorState&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://docs.mongodb.com/v5.0/reference/operator/aggregation/currentOp/#mongodb-data--currentOp.donorState&lt;/a&gt;&lt;/p&gt;

&lt;h6&gt;&lt;a name=&quot;Recipientstates&quot;&gt;&lt;/a&gt;Recipient states&lt;/h6&gt;

&lt;ul&gt;
	&lt;li&gt;An &quot;awaiting&amp;#45;fetch&amp;#45;timestamp&quot; was added. Recipients start in this state while waiting for all donor shards to transition into the &quot;donating&amp;#45;initial&amp;#45;data&quot; state.&lt;/li&gt;
	&lt;li&gt;The &quot;steady&amp;#45;state&quot; state was removed. It was effectively folded in with the &quot;applying&quot; state. The &quot;Recipient shard data is not yet consistent with donor shard data, but will be when the steady state is reached.&quot; line can probably be removed.&lt;/li&gt;
	&lt;li&gt;The &quot;renaming&quot; state was removed.&lt;/li&gt;
	&lt;li&gt;The numeric value for some of the states were reassigned.&lt;/li&gt;
&lt;/ul&gt;


&lt;p&gt;&lt;a href=&quot;https://github.com/mongodb/mongo/blob/5bea2fccdf860e9119712d39b7d2da788fe63708/src/mongo/s/resharding/common_types.idl#L66-L77&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/mongo/blob/5bea2fccdf860e9119712d39b7d2da788fe63708/src/mongo/s/resharding/common_types.idl#L66-L77&lt;/a&gt;&lt;br/&gt;
&lt;a href=&quot;https://docs.mongodb.com/v5.0/reference/command/serverStatus/#mongodb-serverstatus-serverstatus.shardingStatistics.resharding.recipientState&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://docs.mongodb.com/v5.0/reference/command/serverStatus/#mongodb-serverstatus-serverstatus.shardingStatistics.resharding.recipientState&lt;/a&gt;&lt;br/&gt;
&lt;a href=&quot;https://docs.mongodb.com/v5.0/reference/operator/aggregation/currentOp/#mongodb-data--currentOp.recipientState&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://docs.mongodb.com/v5.0/reference/operator/aggregation/currentOp/#mongodb-data--currentOp.recipientState&lt;/a&gt;&lt;/p&gt;

&lt;h6&gt;&lt;a name=&quot;Coordinatorstates&quot;&gt;&lt;/a&gt;Coordinator states&lt;/h6&gt;

&lt;ul&gt;
	&lt;li&gt;The &quot;mirroring&quot; state was renamed to &quot;blocking&amp;#45;writes&quot;.&lt;/li&gt;
	&lt;li&gt;The &quot;renaming&quot; state was removed.&lt;/li&gt;
	&lt;li&gt;The &quot;error&quot; state was renamed to &quot;aborting&quot;. In addition to this being due to unrecoverable error during the resharding operation, the coordinator will also report &quot;aborting&quot; if the user had manually canceled the resharding operation with the abortReshardCollection command.&lt;/li&gt;
	&lt;li&gt;The &quot;committed&quot; state was renamed to &quot;committing&quot;.&lt;/li&gt;
	&lt;li&gt;The &quot;done&quot; state should be removed from the documentation. Unlike the donor&apos;s and recipient&apos;s &quot;done&quot; state, the coordinator never writes down or returns &quot;done&quot; to the user. CoordinatorStateEnum::kDone is used to trigger the coordinator state document to be removed.&lt;/li&gt;
	&lt;li&gt;The numeric value for some of the states were reassigned - (6) is &quot;aborting&quot; and (7) is &quot;committing&quot;.&lt;/li&gt;
&lt;/ul&gt;


&lt;p&gt;&lt;a href=&quot;https://github.com/mongodb/mongo/blob/5bea2fccdf860e9119712d39b7d2da788fe63708/src/mongo/s/resharding/common_types.idl#L40-L52&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/mongo/blob/5bea2fccdf860e9119712d39b7d2da788fe63708/src/mongo/s/resharding/common_types.idl#L40-L52&lt;/a&gt;&lt;br/&gt;
&lt;a href=&quot;https://docs.mongodb.com/v5.0/reference/command/serverStatus/#mongodb-serverstatus-serverstatus.shardingStatistics.resharding.coordinatorState&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://docs.mongodb.com/v5.0/reference/command/serverStatus/#mongodb-serverstatus-serverstatus.shardingStatistics.resharding.coordinatorState&lt;/a&gt;&lt;br/&gt;
&lt;a href=&quot;https://docs.mongodb.com/v5.0/reference/operator/aggregation/currentOp/#mongodb-data--currentOp.coordinatorState&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://docs.mongodb.com/v5.0/reference/operator/aggregation/currentOp/#mongodb-data--currentOp.coordinatorState&lt;/a&gt;&lt;/p&gt;

&lt;h2&gt;&lt;a name=&quot;Scopeofchanges&quot;&gt;&lt;/a&gt;Scope of changes&lt;/h2&gt;

&lt;h2&gt;&lt;a name=&quot;ImpacttoOtherDocs&quot;&gt;&lt;/a&gt;Impact to Other Docs&lt;/h2&gt;

&lt;h2&gt;&lt;a name=&quot;MVP%28WorkandDate%29&quot;&gt;&lt;/a&gt;MVP (Work and Date)&lt;/h2&gt;

&lt;h2&gt;&lt;a name=&quot;Resources%28ScopeorDesignDocs%2CInvision%2Cetc.%29&quot;&gt;&lt;/a&gt;Resources (Scope or Design Docs, Invision, etc.)&lt;/h2&gt;
</description>
                <environment></environment>
        <key id="1772823">DOCS-14542</key>
            <summary>Server: Update tables for resharding-related donor, recipient, and coordinator states</summary>
                <type id="3" iconUrl="https://jira.mongodb.org/secure/viewavatar?size=xsmall&amp;avatarId=14718&amp;avatarType=issuetype">Task</type>
                                            <priority id="3" iconUrl="https://jira.mongodb.org/images/icons/priorities/major.svg">Major - P3</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="naomi.pentrel@mongodb.com">Naomi Pentrel</assignee>
                                    <reporter username="max.hirschhorn@mongodb.com">Max Hirschhorn</reporter>
                        <labels>
                    </labels>
                <created>Tue, 8 Jun 2021 13:20:37 +0000</created>
                <updated>Mon, 13 Nov 2023 17:53:07 +0000</updated>
                            <resolved>Wed, 21 Jul 2021 17:55:59 +0000</resolved>
                                                    <fixVersion>5.0.0-rc4</fixVersion>
                    <fixVersion>5.1.0-rc0</fixVersion>
                    <fixVersion>Server_Docs_20231030</fixVersion>
                    <fixVersion>Server_Docs_20231106</fixVersion>
                    <fixVersion>Server_Docs_20231105</fixVersion>
                    <fixVersion>Server_Docs_20231113</fixVersion>
                                    <component>manual</component>
                    <component>Server</component>
                        <due></due>
                            <votes>0</votes>
                                    <watches>2</watches>
                                                                                                                <comments>
                            <comment id="3955088" author="xgen-internal-githook" created="Wed, 21 Jul 2021 14:45:07 +0000"  >&lt;p&gt;Author:&lt;/p&gt;
{&apos;name&apos;: &apos;Naomi Pentrel&apos;, &apos;email&apos;: &apos;5212232+npentrel@users.noreply.github.com&apos;, &apos;username&apos;: &apos;npentrel&apos;}
&lt;p&gt;Message: &lt;a href=&quot;https://jira.mongodb.org/browse/DOCS-14542&quot; title=&quot;Server: Update tables for resharding-related donor, recipient, and coordinator states&quot; class=&quot;issue-link&quot; data-issue-key=&quot;DOCS-14542&quot;&gt;&lt;del&gt;DOCS-14542&lt;/del&gt;&lt;/a&gt;: Update resharding related states&lt;br/&gt;
Branch: master&lt;br/&gt;
&lt;a href=&quot;https://github.com/mongodb/docs/commit/e4bf5f8cfc657839c0c52365e10ba909b4f35d53&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/docs/commit/e4bf5f8cfc657839c0c52365e10ba909b4f35d53&lt;/a&gt;&lt;/p&gt;</comment>
                            <comment id="3895477" author="max.hirschhorn@10gen.com" created="Wed, 23 Jun 2021 21:43:50 +0000"  >&lt;p&gt;Updated the description to account for how we recently reintroduced &quot;preparing&amp;#45;to&amp;#45;block&amp;#45;writes&quot; as part of &lt;a href=&quot;https://jira.mongodb.org/browse/SERVER-57952&quot; title=&quot;Resharding donor shards cannot complete a shard version refresh after acquiring the critical section, stalling the resharding operation&quot; class=&quot;issue-link&quot; data-issue-key=&quot;SERVER-57952&quot;&gt;&lt;del&gt;SERVER-57952&lt;/del&gt;&lt;/a&gt;.&lt;/p&gt;</comment>
                            <comment id="3866965" author="JIRAUSER1254808" created="Tue, 8 Jun 2021 18:09:28 +0000"  >&lt;p&gt;&lt;a href=&quot;https://jira.mongodb.org/secure/ViewProfile.jspa?name=jeffrey.allen&quot; class=&quot;user-hover&quot; rel=&quot;jeffrey.allen&quot;&gt;jeffrey.allen&lt;/a&gt;Hey Jeff, just assigning this to you as pretty much a test for my first triaged ticket. Feel free to remove the assignment. Cheers, Jason.&lt;/p&gt;</comment>
                    </comments>
                <issuelinks>
                            <issuelinktype id="10420">
                    <name>Backports</name>
                                            <outwardlinks description="backported by">
                                        <issuelink>
            <issuekey id="1796255">DOCS-14597</issuekey>
        </issuelink>
                            </outwardlinks>
                                                        </issuelinktype>
                            <issuelinktype id="10320">
                    <name>Documented</name>
                                            <outwardlinks description="documents">
                                        <issuelink>
            <issuekey id="1792903">SERVER-57952</issuekey>
        </issuelink>
                            </outwardlinks>
                                                        </issuelinktype>
                            <issuelinktype id="10012">
                    <name>Related</name>
                                                                <inwardlinks description="is related to">
                                        <issuelink>
            <issuekey id="1581729">DOCS-14084</issuekey>
        </issuelink>
            <issuelink>
            <issuekey id="1612710">DOCS-14193</issuekey>
        </issuelink>
            <issuelink>
            <issuekey id="1613359">DOCS-14195</issuekey>
        </issuelink>
            <issuelink>
            <issuekey id="1614121">DOCS-14197</issuekey>
        </issuelink>
                            </inwardlinks>
                                    </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>Tue, 8 Jun 2021 18:09:28 +0000</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10052" key="com.atlassian.jira.toolkit:dayslastcommented">
                        <customfieldname>Days since reply</customfieldname>
                        <customfieldvalues>
                                        2 years, 29 weeks ago
    
                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_18254" key="com.onresolve.jira.groovy.groovyrunner:scripted-field">
                        <customfieldname>Dependencies</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue><![CDATA[]]></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_14876" key="com.atlassian.jira.plugin.system.customfieldtypes:userpicker">
                        <customfieldname>Docs Reviewer</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>andrew.feierabend@mongodb.com</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                                                                                                    <customfield id="customfield_10857" key="com.pyxis.greenhopper.jira:gh-epic-link">
                        <customfieldname>Epic Link</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>DOCSP-9747</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>emet.ozar@mongodb.com</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_11151" key="com.atlassian.jira.toolkit:LastCommentDate">
                        <customfieldname>Last public comment date</customfieldname>
                        <customfieldvalues>
                            2 years, 29 weeks ago
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                            <customfield id="customfield_10051" key="com.atlassian.jira.toolkit:participants">
                        <customfieldname>Participants</customfieldname>
                        <customfieldvalues>
                                        <customfieldvalue>xgen-internal-githook</customfieldvalue>
            <customfieldvalue>jason.price@mongodb.com</customfieldvalue>
            <customfieldvalue>max.hirschhorn@mongodb.com</customfieldvalue>
            <customfieldvalue>naomi.pentrel@mongodb.com</customfieldvalue>
    
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                        <customfield id="customfield_14254" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Product Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>1|hzkfbj:</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                <customfield id="customfield_12550" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>2|hz50lr:</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_10557" key="com.pyxis.greenhopper.jira:gh-sprint">
                        <customfieldname>Sprint</customfieldname>
                        <customfieldvalues>
                                <customfieldvalue id="5131">ServerDocs2021: Jun8 - Jun15</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                                                                        <customfield id="customfield_10555" key="com.atlassian.jira.plugin.system.customfieldtypes:float">
                        <customfieldname>Story Points</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>3.0</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|hzk1kn:</customfieldvalue>

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