Navigation
This version of the documentation is archived and no longer supported. To learn how to upgrade your version of MongoDB Ops Manager, refer to the upgrade documentation.
You were redirected from a different version of the documentation. Click here to go back.

Change the Version of MongoDB

On this page

Overview

For MongoDB deployments managed by Ops Manager, Ops Manager supports safe automatic upgrade and downgrade operations between releases of MongoDB while maximizing the availability of your deployment. Ops Manager supports upgrade and downgrade operations for 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 your deployment is not managed by Ops Manager, you will need to manually change the version of MongoDB. The MongoDB Manual provides upgrade tutorials with each release. For example, see: Upgrade MongoDB to 3.0 for upgrading to MongoDB 3.0 from an earlier version.

Considerations

Before changing a deployment’s MongoDB version, consult the following documents for any special considerations or application compatibility issues:

Plan the version change during a predefined maintenance window.

Before applying the change to a production environment, change the MongoDB version on a staging environment that reproduces your production environment. This can help avoid discovering compatibility issues that may result in downtime for your production deployment.

If you downgrade to an earlier version of MongoDB and your MongoDB configuration file includes options that are not part of the earlier MongoDB version, you must perform the downgrade in two phases. First, remove the configuration settings that are specific to the newer MongoDB version, and deploy those changes. Then, update the MongoDB version and deploy that change.

For example, if you are running MongoDB version 3.0 with the engine option set to mmapv1, and you wish to downgrade to MongoDB 2.6, you must first remove the engine option as MongoDB 2.6 does not include that option.

Procedure

1

Click the Deployment tab, then click the Deployment page.

2

Click the first of the two Processes icons.

3

On the line listing the deployment item, click the wrench icon.

4

In the Version field select the version. Then click Apply.

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

5

Click Review & Deploy to review your changes.

6

Review and approve your changes.

Ops Manager displays your proposed changes.

  1. If they are acceptable, click Confirm & Deploy.
  2. If they are unacceptable, click Cancel and you can make additional changes.

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