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.

Upgrade Ops Manager with an rpm Package

This tutorial describes how to upgrade an existing Ops Manager installation using an rpm package.

Upgrade Path

The version of your existing Ops Manager installation determines your upgrade path. The following table lists upgrade paths per version:

Existing Version Upgrade Path
2.0 or later Ops Manager supports direct upgrades from version 2.0.x. Use this tutorial to upgrade directly to 3.4.0.
1.8 or earlier
  1. Follow the appropriate upgrade path to upgrade your version to 2.0. For the specific upgrade path for your version, refer to :v2.0:`v2.0 upgrade documentation </tutorial/nav/upgrade-application-daemon>`.
  2. Once upgraded to 2.0.x, use this tutorial to upgrade to 3.4.0.

There are no supported downgrade paths for Ops Manager.

Important

It is crucial that you back up the existing conf-mms.properties and gen.key files because the upgrade process will delete existing data.

Release Advisories for Ops Manager 3.4

Before upgrading Ops Manager from 2.0.x to 3.4, complete the following actions:

  • Upgrade backing databases to at least MongoDB 3.0.8. MongoDB 2.6 is no longer allowed as a backing store.

  • Ensure the data partitions for the Ops Manager Application Database have at least 50% free disk space.

    Once the Ops Manager upgrade to 3.4 completes, Ops Manager begins migrating of all monitoring data to a new schema in the background. This migration requires significant free disk space.

  • Add necessary IP addresses or CIDR blocks for to the whitelists for any API clients connecting to the Automation configuration endpoints.

  • Back up the mms.conf file in your current installation if you have modified it.

    This is not a regular practice as mms.conf contains platform and network administration settings for Java VM and Ops Manager network port settings. You must use the new mms.conf file the upgrade installs. Reapply any modifications from your backed up copy to the new mms.conf after completing the upgrade.

Prerequisites

Hardware and Software Requirements

Your servers must meet the Ops Manager System Requirements.

Warning

Failure to configure servers according to the Ops Manager System Requirements, including the requirement to read the MongoDB Production Notes, can lead to production failure.

Administrator Privileges
You must have administrator privileges on the servers on which you perform the upgrade.
Download Link
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 http://www.mongodb.com/download.

Procedure

Important

Before you perform the upgrade procedure, ensure that you have a current backup of the Ops Manager backing databases. To perform a full backup, see Shut Down and Back Up Ops Manager.

To upgrade Ops Manager:

Important

If you are running OpsManager 1.8 or earlier, upgrade first to Ops Manager 2.0.x.

1

Stop all existing Ops Manager services.

For platforms that use systemd (RHEL, CentOS, SUSE12):

sudo service mongodb-mms stop

For platforms that use SysVInit (SUSE11, Amazon Linux):

sudo /etc/init.d/mongodb-mms stop
2

Download the latest version of the Ops Manager package.

  1. In a browser, go to http://www.mongodb.com and click on the Download button.
  2. Complete the form.
  3. On the MongoDB Download Center page, click on the Ops Manager tab.
  4. Select RedHat 6+ / CentOS 6+ / SUSE 11+ / Amazon Linux from the Platforms drop-down menu.
  5. Select RPM from the Packages drop-down menu.
  6. Click Download.

Note

The downloaded package is named mongodb-mms-<version>.x86_64.rpm, where <version> is the version number.

3

Install the Ops Manager package on each server being used for Ops Manager services.

Install the .rpm package on each Ops Manager Application server by issuing the following command, where <version> is the version of the .rpm package:

sudo rpm -Uvh mongodb-mms-<version>.x86_64.rpm

The installer preserves the existing conf-mms.properties configuration file and names the new configuration file conf-mms.properties.rpmnew. Both are located in /opt/mongodb/mms/conf/.

4
5

Start Ops Manager on every server.

For platforms that use systemd (RHEL, CentOS, SUSE12):

sudo service mongodb-mms start

For platforms that use SysVInit (SUSE11, Amazon Linux):

sudo /etc/init.d/mongodb-mms start