[DOCS-11471] 4.0 Upgrade/Downgrade docs Created: 21/Mar/18  Updated: 29/Oct/23  Resolved: 23/May/18

Status: Closed
Project: Documentation
Component/s: manual
Affects Version/s: None
Fix Version/s: 3.7.2

Type: Task Priority: Major - P3
Reporter: Kay Kim (Inactive) Assignee: Kay Kim (Inactive)
Resolution: Fixed Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Issue Links:
Documented
documents SERVER-32412 Add featureCompatibilityVersion 4.0 t... Closed
Related
related to DOCS-11199 Docs for SERVER-32275: Remove MONGODB... Closed
Participants:
Days since reply: 5 years, 38 weeks ago
Epic Link: DOCS: 4.0 Server
Story Points: 2

 Description   

Description

We need a v4.0 upgrade/downgrade page for standalone/repl/sharded clusters

Scope of changes (files that need work and how much)

Upgrade

Prereq

  • Upgrade only from 3.6-> 4.0.
  • If master-slave repl, convert to repl before upgrade since master-slave is gone.
  • Before upgrading to MongoDB 4.0, you must upgrade to pv1.
  • If using MongoDB-CR, upgrade to SCRAM before upgrade.
  • auth mechanism – scram-sha-256 only for 4.0
  • Any driver dependencies?

gotchas DOCS-11532

$isolated/$atomic has already been marked as deprecated, so now it can be marked as removed altogether. The one caveat worth mentioning is the upgrade/downgrade scenario since it's possible to create a partial index with $isolated in 3.4 and allowed to parse in 3.6. The following sequence of steps would crash a mongod on startup:

1. Create partial index with $isolated in 3.4
2. Upgrade to 3.6, everything works fine.
3. Upgrade to 4.0, mongod will fail to start since it doesn't recognize the $isolated option persisted to disk.

Let me know if that makes sense and feel free to follow up if it doesn't!

FCV 4.0

  • scram-sha-256
  • $convert (and its helpers), the 'format' option to $dateFromString, etc.
  • transactions
  • generate and store database versions in config.databases on setFCV=4.0

Downgrade

Prereq

  • Stored fcv4.0 features (scram-sha-256 credentials, views with agg convert operators) DOCS-11382
  • FCV -> 3.6
    *

Impact to other docs outside of this product

None – OpsMgr 4.0 should have its own separate Upgrade ticket.

MVP (work and date?)

Resources (e.g. Scope Docs, Invision)

Engineering Ticket Description:

In order to facilitate the development of 4.0-specific features, a 4.0 value should be added to the featureCompatibility enum and also should be an accepted input to the setFeatureCompatibilityVersion command. Transitions from 3.4 to 4.0 should be explicitly prohibited, as all 3.4-specific code will be removed as part of this project.



 Comments   
Comment by Githook User [ 23/May/18 ]

Author:

{'username': 'kay-kim', 'name': 'kay', 'email': 'kay.kim@10gen.com'}

Message: DOCS-11471: 4.0 downgrade
Branch: master
https://github.com/mongodb/docs/commit/e2bd3717212afb980d03a88414f33eb165926391

Comment by Githook User [ 22/May/18 ]

Author:

{'username': 'kay-kim', 'name': 'kay', 'email': 'kay.kim@10gen.com'}

Message: DOCS-11471: upgrade/downgrade
Branch: master
https://github.com/mongodb/docs/commit/64911296d079f85ea0fee02b2b1f137749021699

Generated at Thu Feb 08 08:02:53 UTC 2024 using Jira 9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66.