Docs Menu
Docs Home
/
MongoDB Ops Manager
/
Manage
/
MongoDB Versions

Change the Version of MongoDB

On this page

  • Considerations
  • Prerequisites
  • Procedure

You can upgrade or downgrade MongoDB versions within the same Feature Compatibility Version (FCV) in Ops Manager sharded clusters, replica sets, and standalone MongoDB instances while maximizing the availability of your deployments.

You can add custom-built versions of MongoDB for Ops Manager to download.

If Ops Manager does not manage your deployment, you need to change the version of MongoDB manually. To learn more, see upgrade tutorials for each MongoDB release.

Note

Ops Manager support for End of Life MongoDB versions

Ops Manager doesn't support Backup, Monitoring, or Automation for versions earlier than MongoDB 3.6.

Ops Manager continues to support Automation, Backup, and Monitoring using the MongoDB Agent for clusters running MongoDB 3.6 or later.

Considerations

Note

Downgrading Limitations

You cannot downgrade a MongoDB deployment:

  • From version 5.0 to any version before 4.4.0

  • From version 4.4 to any version before 4.2.6

  • From version 4.2 to any version 4.0.12 (for Windows) or 4.0.7 (for Linux)

  • From version 4.0 to any version before 3.6.23

Prerequisites

Remove Incompatible MongoDB Features when Downgrading

If the MongoDB deployment has set its Feature Compatibility Version to the same release series as its Version, you must first downgrade the featureCompatibilityVersion of the instance manually.

1

Unmanage, but continue to monitor, the deployment.

2

Read the Downgrade Considerations and take appropriate action for unsupported features.

3

Downgrade the Feature Compatibility Version.

Note

This sets the featureCompatibilityVersion to 5.0.

4

Import the deployment.

  1. Import the deployment back into Ops Manager.

  2. Edit the deployment in Ops Manager and select the downgraded version under the Version column.

1

Unmanage, but continue to monitor, the deployment.

2

Downgrade the Feature Compatibility Version.

Note

This removes any 5.0 incompatible features and sets the "featureCompatibilityVersion" : "4.4".

3

Import the deployment.

  1. Import the deployment back into Ops Manager.

  2. Edit the deployment in Ops Manager and select the downgraded version under the Version column.

1

Unmanage, but continue to monitor, the deployment.

2

Downgrade the Feature Compatibility Version.

Note

This removes any 4.4 incompatible features and sets the featureCompatibilityVersion to 4.2.

3

Import the deployment.

  1. Import the deployment back into Ops Manager.

  2. Edit the deployment in Ops Manager and select the downgraded version under the Version column.

1

Unmanage, but continue to monitor, the deployment.

2

Downgrade the Feature Compatibility Version.

Note

This removes any 4.2 incompatible features and sets the "featureCompatibilityVersion" : "4.0".

3

Import the deployment.

  1. Import the deployment back into Ops Manager.

  2. Edit the deployment in Ops Manager and select the downgraded version under the Version column.

Procedure

1

Navigate to the Clusters view for your deployment.

  1. If it is not already displayed, select the organization that contains your desired project from the Organizations menu in the navigation bar.

  2. If it is not already displayed, select your desired project from the Projects menu in the navigation bar.

  3. If it is not already displayed, click Deployment in the sidebar.

  1. Click the Clusters view.

2

On the line listing the deployment item, click Modify.

3

Verify the desired version number is in the version list.

In the Cluster Configuration section, the Cluster Settings heading lists the processes with their names, MongoDB versions, data directories and log files.

  1. Scroll to the Cluster Settings heading.

  2. Click the Version arrow for the first MongoDB process in the list.

Note

If you're running in local mode and don't see your desired version, you can Update the Version Manifest Manually.

To learn more, see Local Mode Configuration.

4

Change the version of MongoDB for the deployment.

For each MongoDB process that you want to change:

  1. Click the current version number for the process.

  2. Click the desired version number.

5

(Optional) Update the featureCompatibilityVersion.

If you are upgrading to a new major version, and wish to enable features offered in the new major version, you must also update the featureCompatibilityVersion.

For each MongoDB deployment that you want to change:

  1. Click the current featureCompatibilityVersion for the deployment.

  2. Click the value that matches the desired version number.

6

Click Save.

7

Click Review & Deploy to review your changes.

8

Click Confirm & Deploy to deploy your changes.

Otherwise, click Cancel and you can make additional changes.

Back

MongoDB Versions

Next

Add Custom Build