<!-- 
RSS generated by JIRA (9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66) at Thu Feb 08 08:04:56 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-12315] Update restore procedure</title>
                <link>https://jira.mongodb.org/browse/DOCS-12315</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;Based on &lt;a href=&quot;https://docs.mongodb.com/manual/tutorial/restore-sharded-cluster/&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://docs.mongodb.com/manual/tutorial/restore-sharded-cluster/&lt;/a&gt;.&lt;/p&gt;

&lt;p&gt;Since the step includes dropping the local database of the config server (in effect, the oplog), it should also delete the _id: minOpTimeRecovery document in admin.system.version of every shard.&lt;/p&gt;

&lt;p&gt;If the user decides to ever change the shardNames after restore, they would also need to drop config.cache.collections, config.cache.chunks.* (for v3.6 or greater) and drop config.cache.databases (for v4.0 or greater) in every shard.&lt;/p&gt;
&lt;h2&gt;&lt;a name=&quot;Scopeofchanges&quot;&gt;&lt;/a&gt;Scope of changes&lt;/h2&gt;
&lt;ul&gt;
	&lt;li&gt;(Pending feedback from engineering) add step for removing &lt;tt&gt;minOptimeRecovery&lt;/tt&gt; document&lt;/li&gt;
	&lt;li&gt;Add steps for removing various &lt;tt&gt;*.cache&lt;/tt&gt; collections on shrad name change&lt;/li&gt;
&lt;/ul&gt;


&lt;h2&gt;&lt;a name=&quot;%C2%A0&quot;&gt;&lt;/a&gt;&#160;&lt;/h2&gt;</description>
                <environment></environment>
        <key id="665167">DOCS-12315</key>
            <summary>Update restore procedure</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="ravind.kumar">Ravind Kumar</assignee>
                                    <reporter username="randolph@mongodb.com">Randolph Tan</reporter>
                        <labels>
                            <label>docs-sharding</label>
                    </labels>
                <created>Thu, 3 Jan 2019 22:07:44 +0000</created>
                <updated>Mon, 30 Oct 2023 19:34:19 +0000</updated>
                            <resolved>Fri, 11 Jan 2019 19:41:24 +0000</resolved>
                                                    <fixVersion>Server_Docs_20231030</fixVersion>
                                    <component>manual</component>
                        <due></due>
                            <votes>0</votes>
                                    <watches>2</watches>
                                                                                                                <comments>
                            <comment id="2211499" author="xgen-internal-githook" created="Fri, 12 Apr 2019 16:33:23 +0000"  >&lt;p&gt;Author:&lt;/p&gt;
{&apos;name&apos;: &apos;ravind&apos;, &apos;username&apos;: &apos;rkumar-mongo&apos;, &apos;email&apos;: &apos;ravind.kumar@10gen.com&apos;}
&lt;p&gt;Message: &lt;a href=&quot;https://jira.mongodb.org/browse/DOCS-9517&quot; title=&quot;Docs for SERVER-24465: Remove recoverShardingState parameter&quot; class=&quot;issue-link&quot; data-issue-key=&quot;DOCS-9517&quot;&gt;&lt;del&gt;DOCS-9517&lt;/del&gt;&lt;/a&gt;: Update restore sharded cluster tutorial&lt;/p&gt;

&lt;p&gt;&lt;a href=&quot;https://jira.mongodb.org/browse/DOCS-12315&quot; title=&quot;Update restore procedure&quot; class=&quot;issue-link&quot; data-issue-key=&quot;DOCS-12315&quot;&gt;&lt;del&gt;DOCS-12315&lt;/del&gt;&lt;/a&gt;: Fixup for restore sharded cluster proc&lt;br/&gt;
Branch: v3.4&lt;br/&gt;
&lt;a href=&quot;https://github.com/mongodb/docs/commit/fcf307ece064f69c54ab669835e6de98eb2fbc95&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/docs/commit/fcf307ece064f69c54ab669835e6de98eb2fbc95&lt;/a&gt;&lt;/p&gt;</comment>
                            <comment id="2112788" author="xgen-internal-githook" created="Fri, 11 Jan 2019 19:43:37 +0000"  >&lt;p&gt;Author:&lt;/p&gt;
{&apos;email&apos;: &apos;ravind.kumar@mongodb.com&apos;, &apos;name&apos;: &apos;rkumar-mongo&apos;}
&lt;p&gt;Message: &lt;a href=&quot;https://jira.mongodb.org/browse/DOCS-12315&quot; title=&quot;Update restore procedure&quot; class=&quot;issue-link&quot; data-issue-key=&quot;DOCS-12315&quot;&gt;&lt;del&gt;DOCS-12315&lt;/del&gt;&lt;/a&gt;: Fixup for restore sharded cluster proc&lt;br/&gt;
Branch: v3.6&lt;br/&gt;
&lt;a href=&quot;https://github.com/mongodb/docs/commit/fd6d119e640336e4753b77a75f33bf3fb3b0ba5d&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/docs/commit/fd6d119e640336e4753b77a75f33bf3fb3b0ba5d&lt;/a&gt;&lt;/p&gt;</comment>
                            <comment id="2112786" author="xgen-internal-githook" created="Fri, 11 Jan 2019 19:41:38 +0000"  >&lt;p&gt;Author:&lt;/p&gt;
{&apos;email&apos;: &apos;ravind.kumar@mongodb.com&apos;, &apos;name&apos;: &apos;rkumar-mongo&apos;}
&lt;p&gt;Message: &lt;a href=&quot;https://jira.mongodb.org/browse/DOCS-12315&quot; title=&quot;Update restore procedure&quot; class=&quot;issue-link&quot; data-issue-key=&quot;DOCS-12315&quot;&gt;&lt;del&gt;DOCS-12315&lt;/del&gt;&lt;/a&gt;: Fixup for restore sharded cluster proc&lt;br/&gt;
Branch: v4.0&lt;br/&gt;
&lt;a href=&quot;https://github.com/mongodb/docs/commit/210938baa562096be34602e24cc4d6a345e1fdbe&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/docs/commit/210938baa562096be34602e24cc4d6a345e1fdbe&lt;/a&gt;&lt;/p&gt;</comment>
                            <comment id="2112785" author="ravind.kumar" created="Fri, 11 Jan 2019 19:41:24 +0000"  >&lt;p&gt;Fix deployed to master/4.2, 4.0, and 3.6. 3.4 work will be covered in wrap up work for &lt;a href=&quot;https://jira.mongodb.org/browse/DOCS-9517&quot; title=&quot;Docs for SERVER-24465: Remove recoverShardingState parameter&quot; class=&quot;issue-link&quot; data-issue-key=&quot;DOCS-9517&quot;&gt;&lt;del&gt;DOCS-9517&lt;/del&gt;&lt;/a&gt;. &lt;a href=&quot;https://jira.mongodb.org/secure/ViewProfile.jspa?name=eric.sommer&quot; class=&quot;user-hover&quot; rel=&quot;eric.sommer&quot;&gt;eric.sommer&lt;/a&gt; hopefully this resolves the issue in whole.&#160;&lt;/p&gt;</comment>
                            <comment id="2112780" author="xgen-internal-githook" created="Fri, 11 Jan 2019 19:39:40 +0000"  >&lt;p&gt;Author:&lt;/p&gt;
{&apos;email&apos;: &apos;ravind.kumar@mongodb.com&apos;, &apos;name&apos;: &apos;rkumar-mongo&apos;}
&lt;p&gt;Message: &lt;a href=&quot;https://jira.mongodb.org/browse/DOCS-12315&quot; title=&quot;Update restore procedure&quot; class=&quot;issue-link&quot; data-issue-key=&quot;DOCS-12315&quot;&gt;&lt;del&gt;DOCS-12315&lt;/del&gt;&lt;/a&gt;: Fixup for restore sharded cluster proc&lt;br/&gt;
Branch: master&lt;br/&gt;
&lt;a href=&quot;https://github.com/mongodb/docs/commit/e659f15dd7686a6cbdb510fd927febdd3fb091c8&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/docs/commit/e659f15dd7686a6cbdb510fd927febdd3fb091c8&lt;/a&gt;&lt;/p&gt;</comment>
                            <comment id="2112621" author="ravind.kumar" created="Fri, 11 Jan 2019 18:30:27 +0000"  >&lt;p&gt;Based on discussions, I&apos;m going to just re-add the step to remove the &lt;tt&gt;minOpTimeRecovery&lt;/tt&gt; document in master/4.2, 4.0, and 3.6&lt;/p&gt;

&lt;p&gt;3.4 will needs some extra validation before we can wrap that up, but that will be lower priority given other tickets on deck right now.&lt;/p&gt;

&lt;p&gt;&#160;&lt;/p&gt;

&lt;p&gt;To emphasize one point, our documented backup procedure is an initial-sync procedure, and our restore procedures work on those assumptions.&lt;/p&gt;</comment>
                            <comment id="2111185" author="ravind.kumar" created="Thu, 10 Jan 2019 16:25:09 +0000"  >&lt;p&gt;Discussing more via slack to get some consensus here.&lt;/p&gt;</comment>
                            <comment id="2111136" author="esha.maharishi@10gen.com" created="Thu, 10 Jan 2019 15:52:43 +0000"  >&lt;p&gt;I agree with &lt;a href=&quot;https://jira.mongodb.org/secure/ViewProfile.jspa?name=renctan&quot; class=&quot;user-hover&quot; rel=&quot;renctan&quot;&gt;renctan&lt;/a&gt;. The bottom line is, if a backup procedure just copies the config servers&apos; data files and starts a new cluster using them, the minOpTimeRecovery document should not be deleted from the shards (and the local database should not be dropped during the restore).&lt;/p&gt;</comment>
                            <comment id="2111100" author="renctan" created="Thu, 10 Jan 2019 15:32:58 +0000"  >&lt;p&gt;The minOpTimeRecovery refers to the low watermark for the opTime the shard should be using when talking to the config server. If the restore procedure makes it such that all config nodes are identical, then the minOpTimeRecovery is no longer necessary (but shouldn&apos;t hurt to keep around). However, if the procedure involves dropping the oplog of the config, then the minOpTimeRecovery is no longer valid and can should be removed. I don&apos;t know whether the procedure is different across version, so the answer to &quot;is this generally true to remove minOpTimeRecovery regardless of version?&quot; depends on the procedure for that version.&lt;/p&gt;</comment>
                            <comment id="2111039" author="ravind.kumar" created="Thu, 10 Jan 2019 14:44:38 +0000"  >&lt;p&gt;See &lt;a href=&quot;https://jira.mongodb.org/browse/DOCS-12347&quot; title=&quot;Missing step to remove minOpTimeRecovery document during shared cluster restore&quot; class=&quot;issue-link&quot; data-issue-key=&quot;DOCS-12347&quot;&gt;&lt;del&gt;DOCS-12347&lt;/del&gt;&lt;/a&gt; for additional discussion/information on the issue at hand.&lt;/p&gt;

&lt;p&gt;&#160;&lt;/p&gt;

&lt;p&gt;&lt;a href=&quot;https://jira.mongodb.org/secure/ViewProfile.jspa?name=esha.maharishi&quot; class=&quot;user-hover&quot; rel=&quot;esha.maharishi&quot;&gt;esha.maharishi&lt;/a&gt; &lt;a href=&quot;https://jira.mongodb.org/secure/ViewProfile.jspa?name=renctan&quot; class=&quot;user-hover&quot; rel=&quot;renctan&quot;&gt;renctan&lt;/a&gt; is this generally true to remove &lt;tt&gt;minOpTimeRecovery&lt;/tt&gt; regardless of version? HELP-5524 seemed to indicate it is necessary, but based on discussions in HELP-8560 it seems like based on our recovery proc (dropping local) it may not matter?&lt;/p&gt;</comment>
                            <comment id="2105711" author="esha.maharishi@10gen.com" created="Fri, 4 Jan 2019 17:03:13 +0000"  >&lt;p&gt;I updated HELP-5524 with this info as well.&lt;/p&gt;</comment>
                            <comment id="2105697" author="esha.maharishi@10gen.com" created="Fri, 4 Jan 2019 16:58:59 +0000"  >&lt;p&gt;&lt;a href=&quot;https://jira.mongodb.org/secure/ViewProfile.jspa?name=ravind.kumar&quot; class=&quot;user-hover&quot; rel=&quot;ravind.kumar&quot;&gt;ravind.kumar&lt;/a&gt;, I think what &lt;a href=&quot;https://jira.mongodb.org/secure/ViewProfile.jspa?name=renctan&quot; class=&quot;user-hover&quot; rel=&quot;renctan&quot;&gt;renctan&lt;/a&gt; suggested is right. The minOpTimeRecovery document can be deleted, &lt;b&gt;only&lt;/b&gt; because all three types of CSRS restore involve &lt;b&gt;restoring to a single node replica sets&lt;/b&gt; and then adding more nodes to them (the added nodes will sync from the first nodes).&lt;/p&gt;

&lt;p&gt;It would have not been correct if, instead, a backup was taken of each CSRS node in the original cluster and restored to a corresponding number of nodes in the new cluster, which is what I had assumed was happening.&lt;/p&gt;</comment>
                            <comment id="2105651" author="ravind.kumar" created="Fri, 4 Jan 2019 16:34:14 +0000"  >&lt;p&gt;This conflicts with information provided in HELP-5524 where it was recommended users &lt;b&gt;not&lt;/b&gt; delete the &lt;tt&gt;minOpTimeRecovery&lt;/tt&gt; document.&lt;/p&gt;

&lt;p&gt;Adding instructions for nuking the various cache collections is simple enough I think.&lt;/p&gt;

&lt;p&gt;&lt;a href=&quot;https://jira.mongodb.org/secure/ViewProfile.jspa?name=esha.maharishi&quot; class=&quot;user-hover&quot; rel=&quot;esha.maharishi&quot;&gt;esha.maharishi&lt;/a&gt; can you comment here?&lt;/p&gt;</comment>
                    </comments>
                <issuelinks>
                            <issuelinktype id="10010">
                    <name>Duplicate</name>
                                                                <inwardlinks description="is duplicated by">
                                        <issuelink>
            <issuekey id="669042">DOCS-12347</issuekey>
        </issuelink>
                            </inwardlinks>
                                    </issuelinktype>
                            <issuelinktype id="10012">
                    <name>Related</name>
                                            <outwardlinks description="related to">
                                                        </outwardlinks>
                                                                <inwardlinks description="is related to">
                                        <issuelink>
            <issuekey id="336282">DOCS-9517</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>13.0</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        <customfield id="customfield_10055" key="com.atlassian.jira.ext.charting:firstresponsedate">
                        <customfieldname>Date of 1st Reply</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>Fri, 4 Jan 2019 16:34:14 +0000</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10052" key="com.atlassian.jira.toolkit:dayslastcommented">
                        <customfieldname>Days since reply</customfieldname>
                        <customfieldvalues>
                                        4 years, 43 weeks, 5 days 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_10857" key="com.pyxis.greenhopper.jira:gh-epic-link">
                        <customfieldname>Epic Link</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>DOCSP-1769</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>
                            4 years, 43 weeks, 5 days ago
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                            <customfield id="customfield_10051" key="com.atlassian.jira.toolkit:participants">
                        <customfieldname>Participants</customfieldname>
                        <customfieldvalues>
                                        <customfieldvalue>esha.maharishi@mongodb.com</customfieldvalue>
            <customfieldvalue>xgen-internal-githook</customfieldvalue>
            <customfieldvalue>randolph@mongodb.com</customfieldvalue>
            <customfieldvalue>ravind.kumar</customfieldvalue>
    
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                        <customfield id="customfield_14254" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Product Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>1|hui4qf:</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                <customfield id="customfield_12550" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>2|hu857j:</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_10555" key="com.atlassian.jira.plugin.system.customfieldtypes:float">
                        <customfieldname>Story Points</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>0.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|huhqzr:</customfieldvalue>

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