<!-- 
RSS generated by JIRA (9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66) at Thu Feb 08 07:42:26 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-2004] reIndex documentation warning is not accurate</title>
                <link>https://jira.mongodb.org/browse/DOCS-2004</link>
                <project id="10380" key="DOCS">Documentation</project>
                    <description>&lt;p&gt;The following warning from the &lt;a href=&quot;http://docs.mongodb.org/manual/reference/command/reIndex/&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;&lt;tt&gt;reIndex&lt;/tt&gt;&lt;/a&gt; command documentation is not accurate.  &lt;/p&gt;
&lt;p/&gt;
&lt;div id=&quot;syntaxplugin&quot; class=&quot;syntaxplugin&quot; style=&quot;border: 1px dashed #bbb; border-radius: 5px !important; overflow: auto; max-height: 30em;&quot;&gt;
&lt;table cellspacing=&quot;0&quot; cellpadding=&quot;0&quot; border=&quot;0&quot; width=&quot;100%&quot; style=&quot;font-size: 1em; line-height: 1.4em !important; font-weight: normal; font-style: normal; color: black;&quot;&gt;
		&lt;tbody &gt;
				&lt;tr id=&quot;syntaxplugin_code_and_gutter&quot;&gt;
						&lt;td  style=&quot; line-height: 1.4em !important; padding: 0em; vertical-align: top;&quot;&gt;
					&lt;pre style=&quot;font-size: 1em; margin: 0 10px;  margin-top: 10px;   margin-bottom: 10px;  width: auto; padding: 0;&quot;&gt;&lt;span style=&quot;color: black; font-family: &apos;Consolas&apos;, &apos;Bitstream Vera Sans Mono&apos;, &apos;Courier New&apos;, Courier, monospace !important;&quot;&gt;This command obtains a write lock on the affected database and will block other operations until it has completed.&lt;/span&gt;&lt;/pre&gt;
			&lt;/td&gt;
		&lt;/tr&gt;
			&lt;/tbody&gt;
&lt;/table&gt;
&lt;/div&gt;
&lt;p/&gt;

&lt;p&gt;The warning is only true sometimes.  The &lt;tt&gt;reIndex&lt;/tt&gt; command will hold a lock and block all other database operations if it is rebuilding &lt;tt&gt;_id&lt;/tt&gt; index.  As for all other indexes, the options that were used initially to create the index would be used to rebuild the index.  For example, if &lt;tt&gt;ensureIndex&lt;/tt&gt; background option were set to true, then the same option would be true for &lt;tt&gt;reIndex&lt;/tt&gt;, which does not block other database activities.  Conversely, if the index were build in the foreground, then &lt;tt&gt;reIndex&lt;/tt&gt; would be performed in the foreground.&lt;/p&gt;</description>
                <environment></environment>
        <key id="91779">DOCS-2004</key>
            <summary>reIndex documentation warning is not accurate</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="sam.kleinman">Sam Kleinman</assignee>
                                    <reporter username="sherry.ger@10gen.com">Sherry Ger</reporter>
                        <labels>
                    </labels>
                <created>Fri, 27 Sep 2013 03:40:50 +0000</created>
                <updated>Mon, 11 Jul 2016 06:56:35 +0000</updated>
                            <resolved>Fri, 27 Sep 2013 14:40:07 +0000</resolved>
                                                    <fixVersion>mongodb-2.4</fixVersion>
                                        <due></due>
                            <votes>0</votes>
                                    <watches>3</watches>
                                                                                                                <comments>
                            <comment id="433580" author="auto" created="Tue, 1 Oct 2013 00:00:41 +0000"  >&lt;p&gt;Author:&lt;/p&gt;
{u&apos;username&apos;: u&apos;tychoish&apos;, u&apos;name&apos;: u&apos;Sam Kleinman&apos;, u&apos;email&apos;: u&apos;samk@10gen.com&apos;}
&lt;p&gt;Message: &lt;a href=&quot;https://jira.mongodb.org/browse/DOCS-2004&quot; title=&quot;reIndex documentation warning is not accurate&quot; class=&quot;issue-link&quot; data-issue-key=&quot;DOCS-2004&quot;&gt;&lt;del&gt;DOCS-2004&lt;/del&gt;&lt;/a&gt;: reindex warning&lt;br/&gt;
Branch: master&lt;br/&gt;
&lt;a href=&quot;https://github.com/mongodb/docs/commit/6b45df66e9b569fff718a04c7a5cf554328fb601&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/docs/commit/6b45df66e9b569fff718a04c7a5cf554328fb601&lt;/a&gt;&lt;/p&gt;</comment>
                            <comment id="432484" author="jlee" created="Fri, 27 Sep 2013 17:10:08 +0000"  >&lt;p&gt;Hi,&lt;/p&gt;

&lt;p&gt;That sounds great.  &lt;/p&gt;

&lt;p&gt;The only suggestion I would make is to still somehow call attention to the fact that the reIndex will drop and rebuild the _id index which will cause the block.  Although it&apos;s implied by the fact that the index is not &lt;/p&gt;
{ background:true }
&lt;p&gt;, the index is created by default so I don&apos;t think people think about it.  &lt;/p&gt;

&lt;p&gt;The only reason it occurred to me that the documentation might be wrong is because someone made a comment in the forums that didn&apos;t feel right and I decided to dig a bit.&lt;/p&gt;

&lt;p&gt;Thanks.&lt;/p&gt;</comment>
                            <comment id="432409" author="auto" created="Fri, 27 Sep 2013 15:26:36 +0000"  >&lt;p&gt;Author:&lt;/p&gt;
{u&apos;username&apos;: u&apos;tychoish&apos;, u&apos;name&apos;: u&apos;Sam Kleinman&apos;, u&apos;email&apos;: u&apos;samk@10gen.com&apos;}
&lt;p&gt;Message: &lt;a href=&quot;https://jira.mongodb.org/browse/DOCS-2004&quot; title=&quot;reIndex documentation warning is not accurate&quot; class=&quot;issue-link&quot; data-issue-key=&quot;DOCS-2004&quot;&gt;&lt;del&gt;DOCS-2004&lt;/del&gt;&lt;/a&gt;: adding cross references&lt;br/&gt;
Branch: master&lt;br/&gt;
&lt;a href=&quot;https://github.com/mongodb/docs/commit/8b8311ad95e6c650dbbc2e1400ed2832f22d869d&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/docs/commit/8b8311ad95e6c650dbbc2e1400ed2832f22d869d&lt;/a&gt;&lt;/p&gt;</comment>
                            <comment id="432407" author="samk" created="Fri, 27 Sep 2013 15:26:23 +0000"  >&lt;p&gt;The warning that I removed was overly broad and added generically based on weather the implementation of the command &lt;b&gt;ever&lt;/b&gt; took a write lock, which while true doesn&apos;t actually reflect the locking behavior in a way that would be useful to users. I think its more useful to document the locking behavior of the logical operation (building an index)... &lt;/p&gt;

&lt;p&gt;My inclination is to cross reference to this page (&lt;a href=&quot;http://docs.mongodb.org/manual/core/index-creation/&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;http://docs.mongodb.org/manual/core/index-creation/&lt;/a&gt;) on all the relevant pages rather than provide specific descriptions about the locks used by various commands.&lt;/p&gt;

&lt;p&gt;Does this make sense for you?&lt;/p&gt;</comment>
                            <comment id="432400" author="jlee" created="Fri, 27 Sep 2013 15:17:33 +0000"  >&lt;p&gt;Hi,&lt;/p&gt;

&lt;p&gt;I&apos;m not sure if this comment is premature, but I originally reported this issue in DOCS-2001 ( that got changed to CS-8949 ).&lt;/p&gt;

&lt;p&gt;The reIndex command will still block other database operations for as it rebuilds indexes that were created without the background flag ( e.g. the _id index ).  Since the operation drops and recreates all indexes on the collection, it will still block for a minimum of one index, but has the potential to release the lock depending on how the other indexes are created.&lt;/p&gt;

&lt;p&gt;The warning should be amended rather than removed.  There is also another page ( &lt;a href=&quot;http://docs.mongodb.org/manual/reference/method/db.collection.reIndex/&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;http://docs.mongodb.org/manual/reference/method/db.collection.reIndex/&lt;/a&gt; )that needs to be amended to be consistent with this one...I&apos;m not sure if that was opened as a separate ticket.&lt;/p&gt;

&lt;p&gt;Thanks.&lt;/p&gt;</comment>
                            <comment id="432385" author="auto" created="Fri, 27 Sep 2013 14:39:52 +0000"  >&lt;p&gt;Author:&lt;/p&gt;
{u&apos;username&apos;: u&apos;tychoish&apos;, u&apos;name&apos;: u&apos;Sam Kleinman&apos;, u&apos;email&apos;: u&apos;samk@10gen.com&apos;}
&lt;p&gt;Message: &lt;a href=&quot;https://jira.mongodb.org/browse/DOCS-2004&quot; title=&quot;reIndex documentation warning is not accurate&quot; class=&quot;issue-link&quot; data-issue-key=&quot;DOCS-2004&quot;&gt;&lt;del&gt;DOCS-2004&lt;/del&gt;&lt;/a&gt;: removing unclear warning about the write lock of the the reIndex database command.&lt;br/&gt;
Branch: master&lt;br/&gt;
&lt;a href=&quot;https://github.com/mongodb/docs/commit/de41eeda8fbabf31fea5e0cd8493c6ef515dfb11&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/docs/commit/de41eeda8fbabf31fea5e0cd8493c6ef515dfb11&lt;/a&gt;&lt;/p&gt;</comment>
                            <comment id="432382" author="samk" created="Fri, 27 Sep 2013 14:38:06 +0000"  >&lt;p&gt;removed warning about write lock. &lt;/p&gt;</comment>
                    </comments>
                <issuelinks>
                            <issuelinktype id="10012">
                    <name>Related</name>
                                                                <inwardlinks description="is related to">
                                                        </inwardlinks>
                                    </issuelinktype>
                    </issuelinks>
                <attachments>
                    </attachments>
                <subtasks>
                    </subtasks>
                <customfields>
                                                <customfield id="customfield_10050" key="com.atlassian.jira.toolkit:comments">
                        <customfieldname># Replies</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>7.0</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        <customfield id="customfield_10055" key="com.atlassian.jira.ext.charting:firstresponsedate">
                        <customfieldname>Date of 1st Reply</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>Fri, 27 Sep 2013 14:38:06 +0000</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10052" key="com.atlassian.jira.toolkit:dayslastcommented">
                        <customfieldname>Days since reply</customfieldname>
                        <customfieldvalues>
                                        10 years, 20 weeks, 2 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_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>jess.mokrzecki@mongodb.com</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_11151" key="com.atlassian.jira.toolkit:LastCommentDate">
                        <customfieldname>Last public comment date</customfieldname>
                        <customfieldvalues>
                            10 years, 20 weeks, 2 days ago
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                            <customfield id="customfield_10051" key="com.atlassian.jira.toolkit:participants">
                        <customfieldname>Participants</customfieldname>
                        <customfieldvalues>
                                        <customfieldvalue>auto</customfieldvalue>
            <customfieldvalue>jlee</customfieldvalue>
            <customfieldvalue>sam.kleinman</customfieldvalue>
            <customfieldvalue>sherry.ger@10gen.com</customfieldvalue>
    
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                        <customfield id="customfield_14254" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Product Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>1|hrpfpr:</customfieldvalue>

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

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10558" key="com.pyxis.greenhopper.jira:gh-global-rank">
                        <customfieldname>Rank (Obsolete)</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>83972</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|hrycef:</customfieldvalue>

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