• Manage Deployments >
• MongoDB Versions >
• Change the Version of MongoDB

Change the Version of MongoDB

Overview

Ops Manager supports safe automatic MongoDB version upgrades and downgrades of managed MongoDB deployments while maximizing the availability of your deployment. Ops Manager can upgrade and downgrade sharded clusters, replica sets, and standalone MongoDB instances.

Configure Available MongoDB Versions describes how to choose which versions of MongoDB are available to Ops Manager.

If Ops Manager does not manage your deployment, you need to change the version of MongoDB manually. The MongoDB Manual provides upgrade tutorials with each release.

Considerations

• Check the following documents for any considerations or compatibility issues before changing a deployment’s MongoDB version:
  • The MongoDB Release Notes
  • The documentation for your driver.
  • MongoDB Compatibility Matrix
• Plan the version change during a predefined maintenance window.
• Change the MongoDB version on a staging environment before changing a production environment. Your staging environment should mirror your production environment. This can help avoid compatibility issues that may result in downtime for your production deployment.
• Follow the MongoDB release notes when performing manual upgrades of replica sets and sharded clusters.

Downgrading Limitations

You cannot downgrade a MongoDB deployment:

• From version 3.6 to any version before 3.4.0
• From version 3.4 to any version before 3.2.8

Prerequisites

Enable Desired MongoDB Versions

If the drop-down menu does not include the desired MongoDB version, you must first enable it in the Version Manager.

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.

• 3.6 to 3.4
• 3.4 to 3.2

1. Unmanage the deployment.

2. Downgrade the deployment item manually.

   • Downgrade 3.6 Standalone to 3.4
   • Downgrade 3.6 Replica Set to 3.4
   • Downgrade 3.6 Sharded Cluster to 3.4

   Note

   This removes any 3.6 incompatible features and sets the "featureCompatibilityVersion" : "3.4".

3. Import the deployment back into Ops Manager.

Limitations when Downgrading from 3.4

1. Unmanage the deployment.

2. Downgrade the deployment manually:

   • Downgrade 3.4 Standalone to 3.2
   • Downgrade 3.4 Replica Set to 3.2
   • Downgrade 3.4 Sharded Cluster to 3.2

   Note

   This removes any 3.4 incompatible features and sets the "featureCompatibilityVersion" : "3.2".

3. Import the deployment back into Ops Manager.

Procedure

1

Click Deployment, then the Processes tab, then the Topology view.

2

On the line listing the deployment item, click Modify.

3

Change the MongoDB version.

1. From the Version menu, click the version you want to use to downgrade or upgrade the MongoDB deployment item.
2. Click Apply.

4

Click Review & Deploy to review your changes.

5

Click Confirm & Deploy to deploy your changes.

Otherwise, click Cancel and you can make additional changes.

←   MongoDB Versions Configure Available MongoDB Versions  →

© MongoDB, Inc 2008-present. MongoDB, Mongo, and the leaf logo are registered trademarks of MongoDB, Inc.