[SERVER-8391] Pre-flight upgrade tool to check for changes breaking backwards compatibility or introducing regressions Created: 30/Jan/13  Updated: 11/Jul/16  Resolved: 05/Mar/14

Status: Closed
Project: Core Server
Component/s: Admin, Tools
Affects Version/s: None
Fix Version/s: 2.6.0-rc1

Type: New Feature Priority: Major - P3
Reporter: Thomas Rueckstiess Assignee: Matt Dannenberg
Resolution: Done Votes: 3
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Issue Links:
Related
related to SERVER-12828 Reindexing drops indexes if key conta... Closed
related to SERVER-13129 db.upgradeCheck() no longer checks al... Closed
related to SERVER-13130 db.upgradeCheck() or db.upgradeCheckA... Closed
related to SERVER-12806 Object.invalidForStorage error messag... Closed
related to DOCS-2650 document 2.6 shell helper upgradeCheck() Closed
related to SERVER-9516 Upgrade/downgrade support for new sch... Closed
related to SERVER-12836 upgradeCheck() or collUpgradeCheck() ... Closed
related to SERVER-12837 upgradeCheck() prints way too much ou... Closed
related to SERVER-12838 invalidForStorage should return actua... Closed
related to SERVER-13003 upgradeCheck on admin db should check... Closed
is related to SERVER-12841 upgradeCheck() gives unhelpful messag... Closed
is related to SERVER-15731 Pre-flight upgrade tool to check for ... Closed
is related to SERVER-12070 Validate all indexes for new restrict... Closed
is related to SERVER-5290 fail to insert docs with fields too l... Closed
is related to SERVER-12233 Command to check for over-long index ... Closed
Participants:

 Description   

Include the ability to do an upgrade check for users coming from versions prior to 2.6.

Invoke from a 2.6 mongo shell connected to a <2.6 mongod or mongos.
There is the option to only run the checks on an individual db or collection, as well as the ability to skip document level checks.

The shell helper checks the following data and index issues that are no longer valid in 2.6:

  • collections without _id field (only possible <= 2.0)
  • documents with index keys that are greater than max size (max size depends on key type and index version)
  • invalid index specs
  • documents with illegal field names


 Comments   
Comment by Githook User [ 03/Mar/14 ]

Author:

{u'username': u'dannenberg', u'name': u'matt dannenberg', u'email': u'matt.dannenberg@10gen.com'}

Message: SERVER-8391 upgradechecker now supports database or collection as argument
Branch: master
https://github.com/mongodb/mongo/commit/6a10de0bb8fe996daca5ecd5687f1072abb0dd8b

Comment by Githook User [ 20/Feb/14 ]

Author:

{u'username': u'dannenberg', u'name': u'matt dannenberg', u'email': u'matt.dannenberg@10gen.com'}

Message: SERVER-8391 upgradeCheck() function added to shell
Branch: master
https://github.com/mongodb/mongo/commit/25bddf266b85a97d8bc17796cb0c2a0759ba639c

Comment by Githook User [ 20/Feb/14 ]

Author:

{u'username': u'dannenberg', u'name': u'matt dannenberg', u'email': u'matt.dannenberg@10gen.com'}

Message: SERVER-8391 made a library for validateIndexKey()
Branch: master
https://github.com/mongodb/mongo/commit/cb382700f1807de6c67456a8284c8e4415d4b741

Comment by Githook User [ 20/Feb/14 ]

Author:

{u'username': u'hkhalsa', u'name': u'Hari Khalsa', u'email': u'hkhalsa@10gen.com'}

Message: SERVER-8391 include correct hash key generation file
Branch: master
https://github.com/mongodb/mongo/commit/78ccc51be325d99e61e5bb2c0cb3029005a97b34

Comment by Githook User [ 20/Feb/14 ]

Author:

{u'username': u'hkhalsa', u'name': u'Hari Khalsa', u'email': u'hkhalsa@10gen.com'}

Message: SERVER-8391 introduce a (indexObj x doc) -> keys function for upgrade checking
Branch: master
https://github.com/mongodb/mongo/commit/f03fe8518989be07ebf741725a7d50ca66577d6f

Comment by Githook User [ 19/Feb/14 ]

Author:

{u'username': u'dannenberg', u'name': u'matt dannenberg', u'email': u'matt.dannenberg@10gen.com'}

Message: Revert "SERVER-8391 mongoadmin initial commit"

This reverts commit 0f7c3ffaf78b241c0a491232e993ee7d695d02cd.
Branch: master
https://github.com/mongodb/mongo/commit/a71a95ce4be07232a7dd4e9becf1249a987e7760

Comment by Githook User [ 29/Jan/14 ]

Author:

{u'username': u'dannenberg', u'name': u'matt dannenberg', u'email': u'matt.dannenberg@10gen.com'}

Message: SERVER-8391 mongoadmin_options_test added
Branch: master
https://github.com/mongodb/mongo/commit/39266981d3c3b6d277af2dbdd68448c6c040d692

Comment by Githook User [ 29/Jan/14 ]

Author:

{u'username': u'dannenberg', u'name': u'matt dannenberg', u'email': u'matt.dannenberg@10gen.com'}

Message: SERVER-8391 mongoadmin initial commit

create the tool with --upgradeCheck flag which currently ensures all collections that should have an _id index do in fact have an _id index
Branch: master
https://github.com/mongodb/mongo/commit/0f7c3ffaf78b241c0a491232e993ee7d695d02cd

Generated at Thu Feb 08 03:17:18 UTC 2024 using Jira 9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66.