liveBook · Manning

Major upgrade

As explained in MongoDB 8.0 in Action, Third Edition

A major upgrade is a software-version upgrade that introduces substantial changes and typically requires explicit initiation and preparation.

A major upgrade moves an Atlas cluster to a new MongoDB major version, such as 7.0 to 8.0, bringing significant engine changes and new features. Unlike minor upgrades, it requires manual initiation and preparation. section 21.4

Prepare and control the upgrade by checking these conditions:

  • Keep the Atlas cluster healthy before starting. section 21.4
  • Complete any on-demand snapshots before initiating the upgrade. section 21.4
  • Upgrade only one major version at a time; version skipping is not allowed. section 21.4
  • Review release notes and verify MongoDB driver compatibility because new versions can introduce non-backward-compatible behavior. section 21.4

Typical upgrade path

Moving from MongoDB 7.0 to 8.0 is a major upgrade. Moving from 8.0.3 to 8.0.5 is instead a minor upgrade, focused on patches and improvements within the same major version. section 21.4

How MongoDB 8.0 in Action, Third Edition covers it

How deep it goes
Explains prerequisites, sequential versioning, compatibility review, and release-note checks without detailing upgrade commands.
Examples
Uses MongoDB 7.0-to-8.0 and 8.0.3-to-8.0.5 transitions to contrast major and minor upgrades.
What it assumes
Requires a healthy cluster, completed on-demand snapshots, compatible MongoDB drivers, and an immediately preceding major version.
What you can do after
Operate/configure an Atlas major upgrade after validating cluster health, snapshots, version order, release notes, and driver compatibility.
How it connects
Connects major upgrades with Atlas clusters, minor upgrades, release notes, MongoDB drivers, snapshots, and cluster health.

Related concepts

This explainer was generated by Manning's knowledge graph from the text of MongoDB 8.0 in Action, Third Edition. The section links point to the parts of the book it draws on.