- Manage Deployments >
- Change the Version of MongoDB
Change the Version of MongoDB¶
On this page
Overview¶
For Ops Manager managed MongoDB, 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.
Considerations¶
Before changing a deployment’s MongoDB version, consult the following documents for any special considerations or application compatibility issues:
- The MongoDB Release Notes
- The documentation for your driver.
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.
To monitor or back up MongoDB 3.0 deployments, you must install Ops Manager 1.6 or higher. To monitor a MongoDB 3.0 deployment, you must also run Monitoring Agent version 2.7.0 or higher.
Procedure¶
Select the Deployment tab and then the Deployment page.¶
Click the first of the two Processes icons.¶
On the line listing the cluster, replica set, or process, click the ellipsis icon and select Modify.¶
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.
Click Review & Deploy.¶
Ops Manager displays your propsed changes.
Click Confirm & Deploy.¶
To view deployment progress, click View Agent Logs and select an agent at the top of the Agent Logs page. To check for updated entries, refresh the page.
If you diagnose an error and need to correct the configuration, click Edit Configuration and then Edit Configuration again. Reconfigure the deployment and click Review & Deploy. If you cannot find a solution, shut down the deployment.