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.

Upgrade Ops Manager with deb Packages


To use Ops Manager 1.6 Automation to manage MongoDB Enterprise deployments, you must first install the MongoDB Enterprise dependencies to each server that runs MongoDB Enterprise. You must install the dependencies to the servers before using Automation.

Note that Automation does not yet support use of the MongoDB Enterprise advanced security features (SSL, LDAP, Kerberos, and auditing). Automation will support these features in the next major Ops Manager release.

To run MongoDB Enterprise with advanced security now, deploy MongoDB Enterprise manually (not through Automation) and use Ops Manager only for Monitoring and Backup.


This tutorial describes how to upgrade an existing Ops Manager Application and Backup Daemon using deb packages.


You must have administrative access on the machines on which you perform the upgrade.

You must have the download link available on the customer downloads page provided to you by MongoDB. If you do not have this link, you can access the download page for evaluation at


If your version is earlier than 1.3, please see instead Upgrade from Version 1.2 and Earlier.

Upgrade the Ops Manager Application from Version 1.3 and Later

If you have an existing Ops Manager Application, use the following procedure to upgrade to the latest release. There are no supported downgrade paths for Ops Manager.


Shut down Ops Manager.

For example:

sudo service mongodb-mms stop

If you are running Ops Manager Backup, shutdown the Ops Manager Backup Daemon.

The daemon may be installed on a different server. It is critical that this is also shut down. To shut down, issue a command similar to the following:

sudo service mongodb-mms-backup-daemon stop

Save a copy of your previous configuration file.

For example:

sudo cp /opt/mongodb/mms/conf/ ~/.

Upgrade the package.

For example:

sudo dpkg -i mongodb-mms_<version>_x86_64.deb

Edit the new configuration file.

Fill in the new configuration file at /opt/mongodb/mms/conf/ using your old file as a reference point.


Start Ops Manager.

For example:

sudo service mongodb-mms start

Update all Monitoring Agents.

See Install Monitoring Agent for more information.


Update the Backup Daemon and any Backup Agent, as appropriate.

If you are running Backup, update the Backup Daemon package and any Backup Agent.

See Install Backup Agent for more information.

Upgrade the Backup Daemon


Stop the currently running instance.

sudo service mongodb-mms-backup-daemon stop

Download the latest version of the Backup Daemon.

Download the new version of the Backup Daemon package by issuing a curl command with the download link available on the customer downloads page provided to you by MongoDB.

curl -OL <link-address-for-backup-deb-package>

Point the Backup Daemon to the Ops Manager Application database.

Open the /opt/mongodb/mms-backup-daemon/conf/ file with root privileges and set the mongo.mongoUri value to the servers and ports hosting the Ops Manager Application database. For example:


Synchronize the gen.key file

Synchronize the /etc/mongodb-mms/gen.key file from an Ops Manager Application server. This is only required if the Backup Daemon was installed on a different server than the Ops Manager Application.


Start the back-end software package.

To start the Backup Daemon run:

sudo service mongodb-mms-backup-daemon start

If everything worked the following displays:

Start Backup Daemon                                        [  OK  ]

If you run into any problems, the log files are at /opt/mongodb/mms-backup-daemon/logs.


Open Ops Manager and access the Backup configuration page.

Open the Ops Manager home page and log in as the user you first registered when installing the Ops Manager Application. (This user is the global owner.) Then click the Admin link at the top right of the page. Then click the Backup tab.


Enter configuration information for the Backup database.

Enter the configuration information described below, and then click Save. Ops Manager uses this information to create the connection string URI used to connect to the database.

<hostname>:<port>: Enter a comma-separated list of the fully qualified domain names and port numbers for all replica set members for the Backup database.

MongoDD Auth Username and MongoDB Auth Password: Enter the user credentials if the database uses authentication.

Encrypted Credentials: Check this if the user credentials use the Ops Manager credentialstool. For more information, see Encrypt MongoDB User Credentials.

Use SSL: Check this if the MongoDB database uses SSL. If you select this, you must configure SSL settings for both the Ops Manager Application and Backup Daemon. See Ops Manager Configuration Files.

Connection Options: To add additional connection options, enter them using the MongoDB Connection String URI Format.