<!-- 
RSS generated by JIRA (9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66) at Thu Feb 08 07:43:30 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-2465] Comprehensive document about backward-breaking changes in v2.6</title>
                <link>https://jira.mongodb.org/browse/DOCS-2465</link>
                <project id="10380" key="DOCS">Documentation</project>
                    <description>&lt;p&gt;It would be good to have a single document that enumerated the backward-breaking changes that users will face upgrading to v2.6.&lt;/p&gt;

&lt;p&gt;Broadly, the categories of breakage I can think of include:&lt;/p&gt;

&lt;p&gt;(1) query engine changes (possibly including tightened semantics of query operators),&lt;br/&gt;
(2) update changes (stricter rules in various places, e.g., no empty string field names),&lt;br/&gt;
(3) indexing changes (e.g., erroring rather than storing documents that have overly long index keys, tightening up the rules about index options),&lt;br/&gt;
(4) changes to the optimizer and hinting, if any.&lt;/p&gt;

&lt;p&gt;I propose that this document take the form of an &quot;upgrade preparedness&quot; checklist with maximally precise, step-by-step instructions for how to identify whether the user&apos;s application will run afoul of a particular change, and suggestions for what to do about it, whenever possible.&lt;/p&gt;</description>
                <environment></environment>
        <key id="104242">DOCS-2465</key>
            <summary>Comprehensive document about backward-breaking changes in v2.6</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="kay.kim@mongodb.com">Kay Kim</assignee>
                                    <reporter username="richard.kreuter">Richard Kreuter</reporter>
                        <labels>
                            <label>sprint-rollover</label>
                    </labels>
                <created>Thu, 2 Jan 2014 19:29:27 +0000</created>
                <updated>Tue, 17 Feb 2015 21:34:49 +0000</updated>
                            <resolved>Wed, 5 Mar 2014 22:52:30 +0000</resolved>
                                                    <fixVersion>v1.3.2</fixVersion>
                                    <component>manual</component>
                        <due></due>
                            <votes>0</votes>
                                    <watches>4</watches>
                                                                                                                <comments>
                            <comment id="510340" author="kay.kim@10gen.com" created="Wed, 5 Mar 2014 22:52:30 +0000"  >&lt;p&gt;first pass finished.  Will close and have Dan/Andrew(tall)/Matt open new tickets as specific issues arise.&lt;/p&gt;</comment>
                            <comment id="510327" author="xgen-internal-githook" created="Wed, 5 Mar 2014 22:33:32 +0000"  >&lt;p&gt;Author:&lt;/p&gt;
{u&apos;username&apos;: u&apos;kay-kim&apos;, u&apos;name&apos;: u&apos;kay&apos;, u&apos;email&apos;: u&apos;kay.kim@10gen.com&apos;}
&lt;p&gt;Message: &lt;a href=&quot;https://jira.mongodb.org/browse/DOCS-2826&quot; title=&quot;2.6 rel notes cleanup&quot; class=&quot;issue-link&quot; data-issue-key=&quot;DOCS-2826&quot;&gt;&lt;del&gt;DOCS-2826&lt;/del&gt;&lt;/a&gt; &lt;a href=&quot;https://jira.mongodb.org/browse/DOCS-2743&quot; title=&quot;Running explain no longer causes the query planner cache to be dropped&quot; class=&quot;issue-link&quot; data-issue-key=&quot;DOCS-2743&quot;&gt;&lt;del&gt;DOCS-2743&lt;/del&gt;&lt;/a&gt; &lt;a href=&quot;https://jira.mongodb.org/browse/DOCS-2650&quot; title=&quot;document 2.6 shell helper upgradeCheck()&quot; class=&quot;issue-link&quot; data-issue-key=&quot;DOCS-2650&quot;&gt;&lt;del&gt;DOCS-2650&lt;/del&gt;&lt;/a&gt; &lt;a href=&quot;https://jira.mongodb.org/browse/DOCS-2465&quot; title=&quot;Comprehensive document about backward-breaking changes in v2.6&quot; class=&quot;issue-link&quot; data-issue-key=&quot;DOCS-2465&quot;&gt;&lt;del&gt;DOCS-2465&lt;/del&gt;&lt;/a&gt; &lt;a href=&quot;https://jira.mongodb.org/browse/DOCS-2726&quot; title=&quot;dochub link for index validation not working&quot; class=&quot;issue-link&quot; data-issue-key=&quot;DOCS-2726&quot;&gt;&lt;del&gt;DOCS-2726&lt;/del&gt;&lt;/a&gt; backwards compatibility and release notes cleanup&lt;br/&gt;
Branch: master&lt;br/&gt;
&lt;a href=&quot;https://github.com/mongodb/docs/commit/94f29def1eda4f0f24d247fa0b3172dabe43d813&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/docs/commit/94f29def1eda4f0f24d247fa0b3172dabe43d813&lt;/a&gt;&lt;/p&gt;</comment>
                            <comment id="476553" author="richard@10gen.com" created="Thu, 2 Jan 2014 19:40:31 +0000"  >&lt;p&gt;Link to a proposal for what to do about overly long index keys, &lt;a href=&quot;https://jira.mongodb.org/browse/SERVER-12233&quot; title=&quot;Command to check for over-long index keys&quot; class=&quot;issue-link&quot; data-issue-key=&quot;SERVER-12233&quot;&gt;&lt;del&gt;SERVER-12233&lt;/del&gt;&lt;/a&gt;.&lt;/p&gt;</comment>
                            <comment id="476552" author="richard@10gen.com" created="Thu, 2 Jan 2014 19:39:40 +0000"  >&lt;p&gt;Changes committed with links to &lt;a href=&quot;https://jira.mongodb.org/browse/SERVER-11178&quot; title=&quot;Create IndexCatalog and remove CatalogHacks&quot; class=&quot;issue-link&quot; data-issue-key=&quot;SERVER-11178&quot;&gt;&lt;del&gt;SERVER-11178&lt;/del&gt;&lt;/a&gt; have the consequence that calls to ensureIndex with equivalent index key specifications but distinct index options return errors (they were formerly sorta no-ops on the primary, but replicated to secondaries with (some of?) the options.&lt;/p&gt;

&lt;p&gt;So apps that regularly call ensureIndex may start getting errors where they didn&apos;t (but where the old server behavior was dubious, and the likely intent of the ensureIndex call was not being satisfied as a result). For example: suppose an application called for a unique index and there was already a non-unique index on those fields; the application would not get an error, but wouldn&apos;t be correct in relying on uniqueness enforcement thereafter.&lt;/p&gt;

&lt;p&gt;Good luck documenting!&lt;/p&gt;</comment>
                            <comment id="476544" author="richard@10gen.com" created="Thu, 2 Jan 2014 19:30:10 +0000"  >&lt;p&gt;The issue related to restricting overly long index keys, &lt;a href=&quot;https://jira.mongodb.org/browse/SERVER-5290&quot; title=&quot;fail to insert docs with fields too long to index, and fail to create indexes where doc keys are too big&quot; class=&quot;issue-link&quot; data-issue-key=&quot;SERVER-5290&quot;&gt;&lt;del&gt;SERVER-5290&lt;/del&gt;&lt;/a&gt;.&lt;/p&gt;

&lt;p&gt;Note that enforcing the restriction on long index keys has a few obvious consequences (and perhaps non-obvious ones):&lt;/p&gt;

&lt;p&gt;(1) inserts will fail when the indexed fields are too big,&lt;br/&gt;
(2) updates will fail when trying to change the indexed fields in the right sorts of ways,&lt;br/&gt;
(3) for users with existing data, updates that change other, possibly non-indexed fields will fail whenever those updates cause documents to move (and thereby force index updates),&lt;br/&gt;
(4) for users with existing data, migrations will fail whenever a chunk has an existing document that runs afoul of the index key length limit (this might lead to other problems in sharding, e.g., if we always try moving the same chunk and it always fails, chunk balancing in that collection will effectively cease; if we attempt to split chunks in response to the moveChunk failing, then we&apos;ll increase the number of chunks without necessity, leading to overly large config dbs later),&lt;br/&gt;
(5) for users whose secondaries contain different documents than their primaries (which is a &quot;broken&quot; edge case), index build operations might succeed on a primary and fail later on the secondary.&lt;/p&gt;

&lt;p&gt;Can&apos;t think of other things off the top of my head.&lt;/p&gt;</comment>
                    </comments>
                <issuelinks>
                            <issuelinktype id="10012">
                    <name>Related</name>
                                            <outwardlinks description="related to">
                                        <issuelink>
            <issuekey id="115947">DOCS-2826</issuekey>
        </issuelink>
            <issuelink>
            <issuekey id="116884">DOCS-2835</issuekey>
        </issuelink>
            <issuelink>
            <issuekey id="109348">DOCS-2650</issuekey>
        </issuelink>
                            </outwardlinks>
                                                                <inwardlinks description="is related to">
                                        <issuelink>
            <issuekey id="32794">SERVER-5290</issuekey>
        </issuelink>
            <issuelink>
            <issuekey id="94144">SERVER-11178</issuekey>
        </issuelink>
            <issuelink>
            <issuekey id="104106">SERVER-12233</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>5.0</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                    <customfield id="customfield_10855" key="com.atlassian.jira.plugin.system.customfieldtypes:float">
                        <customfieldname>Actual Time</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>12.0</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        <customfield id="customfield_10055" key="com.atlassian.jira.ext.charting:firstresponsedate">
                        <customfieldname>Date of 1st Reply</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>Thu, 2 Jan 2014 21:34:13 +0000</customfieldvalue>

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

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_11151" key="com.atlassian.jira.toolkit:LastCommentDate">
                        <customfieldname>Last public comment date</customfieldname>
                        <customfieldvalues>
                            9 years, 50 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>richard.kreuter</customfieldvalue>
    
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                        <customfield id="customfield_14254" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Product Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>1|hrrgr3:</customfieldvalue>

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

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

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