<!-- 
RSS generated by JIRA (9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66) at Thu Feb 08 08:00:57 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-10590] Issues with repairDatabase documentation</title>
                <link>https://jira.mongodb.org/browse/DOCS-10590</link>
                <project id="10380" key="DOCS">Documentation</project>
                    <description>&lt;p&gt;There are several issues with the &lt;tt&gt;repairDatabase&lt;/tt&gt; documentation page in &lt;a href=&quot;https://docs.mongodb.com/manual/reference/command/repairDatabase/&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://docs.mongodb.com/manual/reference/command/repairDatabase/&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;&lt;tt&gt;repairDatabase&lt;/tt&gt; is an administrative command that needs to be run with due care, especially in a replica set configuration. However, the tone and content of the documentation page gives the impression that this is a &quot;safe&quot; command to run. As a result, the suggestion to run &lt;tt&gt;repairDatabase&lt;/tt&gt; for the smallest of issues is often see in community advice.&lt;/p&gt;

&lt;p&gt;In MMAPv1, &lt;tt&gt;repairDatabase&lt;/tt&gt; rebuilds the data files based on the data that can be successfully read. Running this command in a replica set could potentially create inconsistencies in the set. Since all nodes in a replica set are assumed to contain identical data, this will lead to difficult to diagnose crashes and other surprising behaviour.&lt;/p&gt;

&lt;p&gt;Confirmation will be needed as to what exactly &lt;tt&gt;repairDatabase&lt;/tt&gt; does for WiredTiger.&lt;/p&gt;

&lt;p&gt;A sample of incorrect and misleading statements in the page are:&lt;/p&gt;
&lt;ol&gt;
	&lt;li&gt;&lt;tt&gt;The repairDatabase command compacts all collections in the database. It is identical to running the compact command on each collection individually.&lt;/tt&gt; &lt;b&gt;This statement is very, very false and misleading&lt;/b&gt;. &lt;tt&gt;repairDatabase&lt;/tt&gt; is &lt;b&gt;not&lt;/b&gt; identical to bulk-compact.&lt;/li&gt;
	&lt;li&gt;&lt;tt&gt;repairDatabase reduces the total size of the data files on disk&lt;/tt&gt; Reducing data size is not the goal of &lt;tt&gt;repairDatabase&lt;/tt&gt;&lt;/li&gt;
	&lt;li&gt;&lt;tt&gt;However, if you trust that there is no corruption and you have enough free space, then repairDatabase is the appropriate and the only way to reclaim disk space.&lt;/tt&gt; This statement is misleading. Reclaiming space should never be the goal of doing a &lt;tt&gt;repairDatabase&lt;/tt&gt;.&lt;/li&gt;
&lt;/ol&gt;


&lt;p&gt;The result of running &lt;tt&gt;repairDatabase&lt;/tt&gt; may be irreversible. Hence, this command should come with:&lt;/p&gt;
&lt;ol&gt;
	&lt;li&gt;Encouragement to take a file copy backup of the dbpath before attempting any repair operations&lt;/li&gt;
	&lt;li&gt;Information on what this command does for each storage engine&lt;/li&gt;
	&lt;li&gt;Big warnings against running this in a replica set.&lt;/li&gt;
	&lt;li&gt;Big warnings that you should not treat this command lightly, since the consequences of this command may be irreversible, lost data, etc.&lt;/li&gt;
	&lt;li&gt;Big warnings that this command is a last resort.&lt;/li&gt;
&lt;/ol&gt;
</description>
                <environment></environment>
        <key id="409461">DOCS-10590</key>
            <summary>Issues with repairDatabase documentation</summary>
                <type id="1" iconUrl="https://jira.mongodb.org/secure/viewavatar?size=xsmall&amp;avatarId=14703&amp;avatarType=issuetype">Bug</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="13201">Fixed</resolution>
                                        <assignee username="kay.kim@mongodb.com">Kay Kim</assignee>
                                    <reporter username="kevin.adistambha@mongodb.com">Kevin Adistambha</reporter>
                        <labels>
                    </labels>
                <created>Fri, 28 Jul 2017 01:38:29 +0000</created>
                <updated>Mon, 30 Oct 2023 19:35:54 +0000</updated>
                            <resolved>Thu, 3 Aug 2017 01:08:27 +0000</resolved>
                                                    <fixVersion>Server_Docs_20231030</fixVersion>
                                    <component>manual</component>
                        <due></due>
                            <votes>0</votes>
                                    <watches>4</watches>
                                                                                                                <comments>
                            <comment id="1661263" author="xgen-internal-githook" created="Thu, 31 Aug 2017 02:10:13 +0000"  >&lt;p&gt;Author:&lt;/p&gt;
{&apos;username&apos;: &apos;kay-kim&apos;, &apos;name&apos;: &apos;kay&apos;, &apos;email&apos;: &apos;kay.kim@10gen.com&apos;}
&lt;p&gt;Message: &lt;a href=&quot;https://jira.mongodb.org/browse/DOCS-10590&quot; title=&quot;Issues with repairDatabase documentation&quot; class=&quot;issue-link&quot; data-issue-key=&quot;DOCS-10590&quot;&gt;&lt;del&gt;DOCS-10590&lt;/del&gt;&lt;/a&gt;: repairDatabase cleanup part2&lt;br/&gt;
Branch: v3.0&lt;br/&gt;
&lt;a href=&quot;https://github.com/mongodb/docs/commit/47f9818fcd5bb474310c7d6cd44089ab59a91f2a&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/docs/commit/47f9818fcd5bb474310c7d6cd44089ab59a91f2a&lt;/a&gt;&lt;/p&gt;</comment>
                            <comment id="1661262" author="xgen-internal-githook" created="Thu, 31 Aug 2017 02:09:54 +0000"  >&lt;p&gt;Author:&lt;/p&gt;
{&apos;username&apos;: &apos;kay-kim&apos;, &apos;name&apos;: &apos;kay&apos;, &apos;email&apos;: &apos;kay.kim@10gen.com&apos;}
&lt;p&gt;Message: &lt;a href=&quot;https://jira.mongodb.org/browse/DOCS-10590&quot; title=&quot;Issues with repairDatabase documentation&quot; class=&quot;issue-link&quot; data-issue-key=&quot;DOCS-10590&quot;&gt;&lt;del&gt;DOCS-10590&lt;/del&gt;&lt;/a&gt;: repairDatabase cleanup part2&lt;br/&gt;
Branch: v3.2&lt;br/&gt;
&lt;a href=&quot;https://github.com/mongodb/docs/commit/3cbb1b2d095a4707de9d4073cfcb28f715e5dfcb&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/docs/commit/3cbb1b2d095a4707de9d4073cfcb28f715e5dfcb&lt;/a&gt;&lt;/p&gt;</comment>
                            <comment id="1661261" author="xgen-internal-githook" created="Thu, 31 Aug 2017 02:09:35 +0000"  >&lt;p&gt;Author:&lt;/p&gt;
{&apos;username&apos;: &apos;kay-kim&apos;, &apos;name&apos;: &apos;kay&apos;, &apos;email&apos;: &apos;kay.kim@10gen.com&apos;}
&lt;p&gt;Message: &lt;a href=&quot;https://jira.mongodb.org/browse/DOCS-10590&quot; title=&quot;Issues with repairDatabase documentation&quot; class=&quot;issue-link&quot; data-issue-key=&quot;DOCS-10590&quot;&gt;&lt;del&gt;DOCS-10590&lt;/del&gt;&lt;/a&gt;: repairDatabase cleanup part2&lt;br/&gt;
Branch: v3.4&lt;br/&gt;
&lt;a href=&quot;https://github.com/mongodb/docs/commit/1e0daafda78af156cfe5323c9818c102ebee67d5&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/docs/commit/1e0daafda78af156cfe5323c9818c102ebee67d5&lt;/a&gt;&lt;/p&gt;</comment>
                            <comment id="1661260" author="xgen-internal-githook" created="Thu, 31 Aug 2017 02:09:00 +0000"  >&lt;p&gt;Author:&lt;/p&gt;
{&apos;username&apos;: &apos;kay-kim&apos;, &apos;name&apos;: &apos;kay&apos;, &apos;email&apos;: &apos;kay.kim@10gen.com&apos;}
&lt;p&gt;Message: &lt;a href=&quot;https://jira.mongodb.org/browse/DOCS-10590&quot; title=&quot;Issues with repairDatabase documentation&quot; class=&quot;issue-link&quot; data-issue-key=&quot;DOCS-10590&quot;&gt;&lt;del&gt;DOCS-10590&lt;/del&gt;&lt;/a&gt;: repairDatabase cleanup part2&lt;br/&gt;
Branch: master&lt;br/&gt;
&lt;a href=&quot;https://github.com/mongodb/docs/commit/7d0452065dfbc58abd6f3183df94c90bceb2ce9d&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/docs/commit/7d0452065dfbc58abd6f3183df94c90bceb2ce9d&lt;/a&gt;&lt;/p&gt;</comment>
                            <comment id="1661258" author="xgen-internal-githook" created="Thu, 31 Aug 2017 02:03:31 +0000"  >&lt;p&gt;Author:&lt;/p&gt;
{&apos;username&apos;: &apos;kay-kim&apos;, &apos;name&apos;: &apos;kay&apos;, &apos;email&apos;: &apos;kay.kim@10gen.com&apos;}
&lt;p&gt;Message: &lt;a href=&quot;https://jira.mongodb.org/browse/DOCS-10590&quot; title=&quot;Issues with repairDatabase documentation&quot; class=&quot;issue-link&quot; data-issue-key=&quot;DOCS-10590&quot;&gt;&lt;del&gt;DOCS-10590&lt;/del&gt;&lt;/a&gt;: repairDatabase cleanup part2&lt;br/&gt;
Branch: v3.4&lt;br/&gt;
&lt;a href=&quot;https://github.com/mongodb/docs/commit/3be4892cbd338e496132cee2d941e04db9767307&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/docs/commit/3be4892cbd338e496132cee2d941e04db9767307&lt;/a&gt;&lt;/p&gt;</comment>
                            <comment id="1661254" author="xgen-internal-githook" created="Thu, 31 Aug 2017 02:02:58 +0000"  >&lt;p&gt;Author:&lt;/p&gt;
{&apos;username&apos;: &apos;kay-kim&apos;, &apos;name&apos;: &apos;kay&apos;, &apos;email&apos;: &apos;kay.kim@10gen.com&apos;}
&lt;p&gt;Message: &lt;a href=&quot;https://jira.mongodb.org/browse/DOCS-10590&quot; title=&quot;Issues with repairDatabase documentation&quot; class=&quot;issue-link&quot; data-issue-key=&quot;DOCS-10590&quot;&gt;&lt;del&gt;DOCS-10590&lt;/del&gt;&lt;/a&gt;: repairDatabase cleanup part2&lt;br/&gt;
Branch: v3.0&lt;br/&gt;
&lt;a href=&quot;https://github.com/mongodb/docs/commit/c5b50b28ace4f8c144512b12408f236fbc5e4779&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/docs/commit/c5b50b28ace4f8c144512b12408f236fbc5e4779&lt;/a&gt;&lt;/p&gt;</comment>
                            <comment id="1661253" author="xgen-internal-githook" created="Thu, 31 Aug 2017 02:02:31 +0000"  >&lt;p&gt;Author:&lt;/p&gt;
{&apos;username&apos;: &apos;kay-kim&apos;, &apos;name&apos;: &apos;kay&apos;, &apos;email&apos;: &apos;kay.kim@10gen.com&apos;}
&lt;p&gt;Message: &lt;a href=&quot;https://jira.mongodb.org/browse/DOCS-10590&quot; title=&quot;Issues with repairDatabase documentation&quot; class=&quot;issue-link&quot; data-issue-key=&quot;DOCS-10590&quot;&gt;&lt;del&gt;DOCS-10590&lt;/del&gt;&lt;/a&gt;: repairDatabase cleanup part2&lt;br/&gt;
Branch: v3.2&lt;br/&gt;
&lt;a href=&quot;https://github.com/mongodb/docs/commit/8d5b9bedb059a641d8b411db87c5ed82e84bd804&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/docs/commit/8d5b9bedb059a641d8b411db87c5ed82e84bd804&lt;/a&gt;&lt;/p&gt;</comment>
                            <comment id="1661251" author="xgen-internal-githook" created="Thu, 31 Aug 2017 02:01:00 +0000"  >&lt;p&gt;Author:&lt;/p&gt;
{&apos;username&apos;: &apos;kay-kim&apos;, &apos;name&apos;: &apos;kay&apos;, &apos;email&apos;: &apos;kay.kim@10gen.com&apos;}
&lt;p&gt;Message: &lt;a href=&quot;https://jira.mongodb.org/browse/DOCS-10590&quot; title=&quot;Issues with repairDatabase documentation&quot; class=&quot;issue-link&quot; data-issue-key=&quot;DOCS-10590&quot;&gt;&lt;del&gt;DOCS-10590&lt;/del&gt;&lt;/a&gt;: repairDatabase cleanup part2&lt;br/&gt;
Branch: master&lt;br/&gt;
&lt;a href=&quot;https://github.com/mongodb/docs/commit/770d0eda36e54cbd0691fa2d66085c3b43ed718f&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/docs/commit/770d0eda36e54cbd0691fa2d66085c3b43ed718f&lt;/a&gt;&lt;/p&gt;</comment>
                            <comment id="1634385" author="kay.kim@10gen.com" created="Fri, 28 Jul 2017 12:56:24 +0000"  >&lt;p&gt;heh &amp;#8211; You&apos;ve gotten me trained &lt;a href=&quot;https://jira.mongodb.org/secure/ViewProfile.jspa?name=kevin.adistambha&quot; class=&quot;user-hover&quot; rel=&quot;kevin.adistambha&quot;&gt;kevin.adistambha&lt;/a&gt; &amp;#8211; I&apos;m like &quot;Oh, I&apos;ll see if Kevin opens a CR himself&quot; &lt;img class=&quot;emoticon&quot; src=&quot;https://jira.mongodb.org/images/icons/emoticons/wink.png&quot; height=&quot;16&quot; width=&quot;16&quot; align=&quot;absmiddle&quot; alt=&quot;&quot; border=&quot;0&quot;/&gt; &lt;/p&gt;</comment>
                    </comments>
                <issuelinks>
                            <issuelinktype id="10012">
                    <name>Related</name>
                                            <outwardlinks description="related to">
                                        <issuelink>
            <issuekey id="348388">DOCS-9814</issuekey>
        </issuelink>
                            </outwardlinks>
                                                                <inwardlinks description="is related to">
                                        <issuelink>
            <issuekey id="313016">DOCS-8713</issuekey>
        </issuelink>
            <issuelink>
            <issuekey id="331157">DOCS-9301</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>9.0</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        <customfield id="customfield_10055" key="com.atlassian.jira.ext.charting:firstresponsedate">
                        <customfieldname>Date of 1st Reply</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>Fri, 28 Jul 2017 12:56:24 +0000</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10052" key="com.atlassian.jira.toolkit:dayslastcommented">
                        <customfieldname>Days since reply</customfieldname>
                        <customfieldvalues>
                                        6 years, 24 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_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>
                            6 years, 24 weeks ago
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                            <customfield id="customfield_10051" key="com.atlassian.jira.toolkit:participants">
                        <customfieldname>Participants</customfieldname>
                        <customfieldvalues>
                                        <customfieldvalue>xgen-internal-githook</customfieldvalue>
            <customfieldvalue>kay.kim@mongodb.com</customfieldvalue>
            <customfieldvalue>kevin.adistambha@mongodb.com</customfieldvalue>
    
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                        <customfield id="customfield_14254" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Product Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>1|htbtz3:</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                <customfield id="customfield_12550" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>2|ht3n1z:</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="1324">KANBAN BUCKET</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|htbg1r:</customfieldvalue>

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