<!-- 
RSS generated by JIRA (9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66) at Thu Feb 08 07:54:06 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-7353] Document limited circumstances for writing to the configdb</title>
                <link>https://jira.mongodb.org/browse/DOCS-7353</link>
                <project id="10380" key="DOCS">Documentation</project>
                    <description>&lt;p&gt;The docs at &lt;a href=&quot;https://docs.mongodb.org/manual/reference/config-database/&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://docs.mongodb.org/manual/reference/config-database/&lt;/a&gt; state:&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;IMPORTANT&lt;br/&gt;
Consider the schema of the &lt;tt&gt;config&lt;/tt&gt; database &lt;em&gt;internal&lt;/em&gt; and may change between releases of MongoDB. The &lt;tt&gt;config&lt;/tt&gt; database is not a dependable API, and users should not write data to the &lt;tt&gt;config&lt;/tt&gt; database in the course of normal operation or maintenance.&lt;/p&gt;

&lt;p&gt;WARNING&lt;br/&gt;
Modification of the &lt;tt&gt;config&lt;/tt&gt; database on a functioning system may lead to instability or inconsistent data sets. If you must modify the &lt;tt&gt;config&lt;/tt&gt; database, use &lt;a href=&quot;https://docs.mongodb.org/manual/reference/program/mongodump/#bin.mongodump&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;mongodump&lt;/a&gt; to create a full backup of the &lt;tt&gt;config&lt;/tt&gt; database.&lt;/p&gt;&lt;/blockquote&gt;

&lt;p&gt;While all of this is true, there is one situation where it is acceptable to write to the config db.  This is the case of doing a test write to unused collection in order to verify the write availability of the config servers.  For example, running the following on a mongos:&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;db.getSiblingDB(&quot;config&quot;).testConfigServerWriteAvail.update( { _id: 1 }, { $inc: { a: 1 } }, { upsert: true } )&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;If this succeeds, the the config servers are up and able to successfully process writes.  If this fails, then they are not.&lt;/p&gt;

&lt;p&gt;Since the collections in the config db may change over time (ie. future releases of the server may use collections that older versions do not), users wishing to do this must choose the name of test-write collection very carefully to avoid any potential collisions in the future (hence &quot;&lt;tt&gt;testConfigServerWriteAvail&lt;/tt&gt;&quot; in the example above).&lt;/p&gt;

&lt;p&gt;It is still never acceptable under any circumstances to store any general-purpose user data in the config db, since that&apos;s not its intended purpose and it hasn&apos;t been designed for such a use case.&lt;/p&gt;</description>
                <environment></environment>
        <key id="270328">DOCS-7353</key>
            <summary>Document limited circumstances for writing to the configdb</summary>
                <type id="4" iconUrl="https://jira.mongodb.org/secure/viewavatar?size=xsmall&amp;avatarId=14710&amp;avatarType=issuetype">Improvement</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="steve.renaker@mongodb.com">Steve Renaker</assignee>
                                    <reporter username="kevin.pulo@mongodb.com">Kevin Pulo</reporter>
                        <labels>
                    </labels>
                <created>Mon, 7 Mar 2016 03:18:08 +0000</created>
                <updated>Mon, 30 Oct 2023 21:35:22 +0000</updated>
                            <resolved>Wed, 30 Mar 2016 21:49:25 +0000</resolved>
                                                    <fixVersion>Server_Docs_20231030</fixVersion>
                                    <component>manual</component>
                        <due></due>
                            <votes>0</votes>
                                    <watches>3</watches>
                                                                                                                <comments>
                            <comment id="1220283" author="xgen-internal-githook" created="Wed, 30 Mar 2016 18:53:22 +0000"  >&lt;p&gt;Author:&lt;/p&gt;
{u&apos;username&apos;: u&apos;steveren&apos;, u&apos;name&apos;: u&apos;Steve Renaker&apos;, u&apos;email&apos;: u&apos;steve.renaker@mongodb.com&apos;}
&lt;p&gt;Message: &lt;a href=&quot;https://jira.mongodb.org/browse/DOCS-7353&quot; title=&quot;Document limited circumstances for writing to the configdb&quot; class=&quot;issue-link&quot; data-issue-key=&quot;DOCS-7353&quot;&gt;&lt;del&gt;DOCS-7353&lt;/del&gt;&lt;/a&gt;: moved warning about modifying config db&lt;/p&gt;

&lt;p&gt;Signed-off-by: kay &amp;lt;kay.kim@10gen.com&amp;gt;&lt;br/&gt;
Branch: master&lt;br/&gt;
&lt;a href=&quot;https://github.com/mongodb/docs/commit/360e5afbad197701b814bf126b996667e9b71cb8&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/docs/commit/360e5afbad197701b814bf126b996667e9b71cb8&lt;/a&gt;&lt;/p&gt;</comment>
                            <comment id="1220282" author="xgen-internal-githook" created="Wed, 30 Mar 2016 18:53:21 +0000"  >&lt;p&gt;Author:&lt;/p&gt;
{u&apos;username&apos;: u&apos;steveren&apos;, u&apos;name&apos;: u&apos;Steve Renaker&apos;, u&apos;email&apos;: u&apos;steve.renaker@mongodb.com&apos;}
&lt;p&gt;Message: &lt;a href=&quot;https://jira.mongodb.org/browse/DOCS-7353&quot; title=&quot;Document limited circumstances for writing to the configdb&quot; class=&quot;issue-link&quot; data-issue-key=&quot;DOCS-7353&quot;&gt;&lt;del&gt;DOCS-7353&lt;/del&gt;&lt;/a&gt;: new wording for writing to a test collection in config db&lt;/p&gt;

&lt;p&gt;Signed-off-by: kay &amp;lt;kay.kim@10gen.com&amp;gt;&lt;br/&gt;
Branch: master&lt;br/&gt;
&lt;a href=&quot;https://github.com/mongodb/docs/commit/e03d215650a77b8a3a33ada25adb030d23b9b1f7&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/docs/commit/e03d215650a77b8a3a33ada25adb030d23b9b1f7&lt;/a&gt;&lt;/p&gt;</comment>
                            <comment id="1220281" author="xgen-internal-githook" created="Wed, 30 Mar 2016 18:53:20 +0000"  >&lt;p&gt;Author:&lt;/p&gt;
{u&apos;username&apos;: u&apos;steveren&apos;, u&apos;name&apos;: u&apos;Steve Renaker&apos;, u&apos;email&apos;: u&apos;steve.renaker@mongodb.com&apos;}
&lt;p&gt;Message: &lt;a href=&quot;https://jira.mongodb.org/browse/DOCS-7353&quot; title=&quot;Document limited circumstances for writing to the configdb&quot; class=&quot;issue-link&quot; data-issue-key=&quot;DOCS-7353&quot;&gt;&lt;del&gt;DOCS-7353&lt;/del&gt;&lt;/a&gt;: changed wording of &quot;Important&quot; box&lt;/p&gt;

&lt;p&gt;Signed-off-by: kay &amp;lt;kay.kim@10gen.com&amp;gt;&lt;br/&gt;
Branch: master&lt;br/&gt;
&lt;a href=&quot;https://github.com/mongodb/docs/commit/9231aff216f8999c27b32e63405cfcac84e32f30&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/docs/commit/9231aff216f8999c27b32e63405cfcac84e32f30&lt;/a&gt;&lt;/p&gt;</comment>
                            <comment id="1220280" author="xgen-internal-githook" created="Wed, 30 Mar 2016 18:53:19 +0000"  >&lt;p&gt;Author:&lt;/p&gt;
{u&apos;username&apos;: u&apos;steveren&apos;, u&apos;name&apos;: u&apos;Steve Renaker&apos;, u&apos;email&apos;: u&apos;steve.renaker@mongodb.com&apos;}
&lt;p&gt;Message: &lt;a href=&quot;https://jira.mongodb.org/browse/DOCS-7353&quot; title=&quot;Document limited circumstances for writing to the configdb&quot; class=&quot;issue-link&quot; data-issue-key=&quot;DOCS-7353&quot;&gt;&lt;del&gt;DOCS-7353&lt;/del&gt;&lt;/a&gt;: limited circumstances for writing to the config db&lt;/p&gt;

&lt;p&gt;Signed-off-by: kay &amp;lt;kay.kim@10gen.com&amp;gt;&lt;br/&gt;
Branch: master&lt;br/&gt;
&lt;a href=&quot;https://github.com/mongodb/docs/commit/bb03861f849aaea01de96915b2d6fe32824b7717&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/docs/commit/bb03861f849aaea01de96915b2d6fe32824b7717&lt;/a&gt;&lt;/p&gt;</comment>
                    </comments>
                <issuelinks>
                            <issuelinktype id="10012">
                    <name>Related</name>
                                            <outwardlinks description="related to">
                                                        </outwardlinks>
                                                        </issuelinktype>
                    </issuelinks>
                <attachments>
                    </attachments>
                <subtasks>
                    </subtasks>
                <customfields>
                                                <customfield id="customfield_10050" key="com.atlassian.jira.toolkit:comments">
                        <customfieldname># Replies</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>4.0</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        <customfield id="customfield_10055" key="com.atlassian.jira.ext.charting:firstresponsedate">
                        <customfieldname>Date of 1st Reply</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>Mon, 28 Mar 2016 23:03:02 +0000</customfieldvalue>

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

                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                <customfield id="customfield_12550" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>2|hrcwtr:</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="1162">Docs Sprint 2016(0711-0729)</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|hrz3a7:</customfieldvalue>

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