MongoDB Upgrade Paths

Parent: MongoDB Expert Knowledge · researched 2026-05-28T15:11:05.255Z· 20 sources · 33 concepts · skill mongodb-upgrade-paths

Operational reference for MongoDB major-version upgrades on self-managed deployments. Covers the supported version sequence, Feature Compatibility Version (FCV) lifecycle, rolling replica-set and shar

MongoDB Upgrade Paths

When to use this skill

When NOT to use this skill

Related skills

1. Version upgrade paths

Hard rules

"Straight-to-8" jump pattern

Pre-flight: identify your starting version honestly

2. Feature Compatibility Version (FCV)

Key facts

Downgrade preservation window

Burn-in recommendation

3. Rolling upgrades — replica sets

Order

Election timing

Arbiter handling

4. Sharded cluster upgrades

Order (8.0 example, applies to every major hop)

Version-skew rules

Config shard caveat (8.0+)

5. Driver compatibility

Retry semantics

Other drivers — quick rules

6. Pre-upgrade checks

Required gates

Index builds and commit quorum (8.0 nuance)

Binary downgrade window

The "Point of No Return" command

Practical rollback playbook

8. Disk pre-warming (Cookie 7.0 → 8.0 lesson)

The problem

Why MongoDB docs don't cover it

Pre-warming SOP (manual, customer-driven)

Recommendation to MongoDB Engineering

9. Upgrade event coverage

Pre-event (T-7 days through T-0)

During event (T-0 → T-end)

Post-event (T-end → T+72 hours)

Sign-off artefacts

10. Common upgrade failures

10.1 Driver mismatch

10.2 FCV unpinned too early

10.3 Index build conflicts

10.4 mongos version skew

10.5 PSA topology stepdown failure

10.6 Oplog window overflow during long maintenance

10.7 Cold-cache latency regression (Section 8)

Sources

Children

Frontier under this node: Arbiter handling and PSA topology, Binary downgrade window, Change-stream resumability, Cold-cache latency regression, Common upgrade failures, Config server / shards / mongos upgrade sequence, Config shard caveat (8.0+), Disk pre-warming SOP (Cookie 7.0→8.0 lesson), Driver compatibility matrix (Java/Node/Python/.NET/Go), Driver mismatch failure mode, Error Envelope and customer sign-off, FCV pinning and downgrade preservation window, FCV unpinned too early, Feature Compatibility Version (FCV), In-flight index builds, Index build commit quorum (8.0 nuance), Index build conflicts, Java driver 4.10 and 5.x retry semantics, Oplog window overflow, Oplog window sizing, PSA topology stepdown failure, Point of No Return, Pre-upgrade safety checks, Replica-set election timing, Rolling replica-set upgrade, Sharded cluster upgrade ordering, Straight-to-8 jump pattern, Upgrade event coverage (pre/during/post), Upgrade rollback playbook, Version upgrade paths (4.4 → 5.0 → 6.0 → 7.0 → 8.0), WiredTiger cache warm-up, mongos version skew failure, mongos version skew rules

← the whole tree · 3D view· how to read this page