[DOCS-1188] Documentation for index type/plugin kerfuffle. Created: 01/Mar/13  Updated: 04/Mar/23  Resolved: 18/Mar/13

Status: Closed
Project: Documentation
Component/s: Server
Affects Version/s: None
Fix Version/s: mongodb-2.4

Type: Task Priority: Critical - P2
Reporter: Daniel Pasette (Inactive) Assignee: Sam Kleinman (Inactive)
Resolution: Done Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Issue Links:
Depends
depends on SERVER-8751 Downgrading 2.4=>2.2 without dropping... Closed
Participants:
Days since reply: 10 years, 48 weeks, 2 days ago

 Description   

Need to explain error messages that can occur when upgrading to 2.4 with invalid index types. See: SERVER-8751, et al.

  • Indexes with invalid types created <2.4 will warn on startup (including {foo:"1"}

    instead of

    {foo:1}

    and

    {foo:"text"}

    ).

  • When creating indexes of type "text" or "2dsphere" in 2.4, mongodb checks that there are no other indexes with types that were not valid in 2.2, including {foo:"1"}

    . In order to create new index type, user will have to drop offending indexes.

  • Going forward, indexes of invalid types will not be allowed to be created.
  • If you have invalid indexes and you try to reIndex(), it will drop all indexes and fail upon discovery of first invalid index.
  • Invalid indexes are treated as ascending eg., {foo:"-1"}

    will be treated like,

    {foo:1}

    . This behavior is meant as a bridge for users who accidentally created indexes with invalid types, but is not guaranteed to be true forever.

Need to create two new dochub entries:



 Comments   
Comment by auto [ 18/Mar/13 ]

Author:

{u'date': u'2013-03-18T22:39:40Z', u'name': u'kay', u'email': u'kay.kim@10gen.com'}

Message: DOCS-1251, DOCS-1244, and some of Rassi's comments for DOCS-1188
Branch: master
https://github.com/mongodb/docs/commit/f27b4392aba1465f1906307e636cc73795ac9834

Comment by auto [ 18/Mar/13 ]

Author:

{u'date': u'2013-03-14T14:02:23Z', u'name': u'Sam Kleinman', u'email': u'samk@10gen.com'}

Message: DOCS-1188: index type upgrade/downgrade concerns
Branch: master
https://github.com/mongodb/docs/commit/b4484456f86c92b14ac50741a203952f76a2d185

Comment by J Rassi [ 09/Mar/13 ]

Invalid indexes are treated as ascending eg., {foo:"-1"} will be treated like, {foo:1}. This behavior is meant as a bridge for users who accidentally created indexes with invalid types, but is not guaranteed to be true forever.

Not exactly a "bridge", see SERVER-8923.

Comment by Daniel Pasette (Inactive) [ 05/Mar/13 ]

Code is now checked in for this. We should start drafting upgrade/downgrade notes.

Generated at Thu Feb 08 07:40:27 UTC 2024 using Jira 9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66.