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 on Microsoft Windows Server

Overview

This tutorial describes how to upgrade an existing Ops Manager installation on Microsoft Windows. Ops Manager supports direct upgrades from version 1.6 and later.

Considerations

Backup Database
There are data migrations that touch the various backup data stores that make up the Backup Data Storage. The data stores must all be online when you upgrade. Any data stores that are no longer in use should be deleted through the Ops Manager UI before upgrading.
Backup Daemon

Beginning with Ops Manager 2.0, there is no separate Backup Daemon package. The Ops Manager package also installs the Backup Daemon. When started, the Ops Manager package automatically starts two services: the Ops Manager Application and the Backup Daemon. You choose on which servers to “activate” the Backup Daemon. The daemon always runs, but it performs no operations unless activated.

After upgrade, a server that runs only the Ops Manager Application continues to do so but now also runs a “dormant” Backup Daemon service. The Backup Daemon remains dormant as long as you do not activate it.

A server that runs only a Backup Daemon runs Ops Manager with an “activated” Backup Daemon and a “dormant” Ops Manager Application. The Ops Manager Application remains dormant as long as you do not direct HTTP traffic to it.

Backup HTTP Service

Beginning with Ops Manager 2.0, there is no Backup HTTP Service on port 8081. Any Backup Agents that are managed by Automation will be automatically updated to use the new port, 8080. For Backup Agents that were installed manually, you must edit the agent’s configuration file, as described in the procedure below. You must have access to the servers running any manually installed Backup Agents.

Warning

You must configure the new port for any manually installed Backup Agents, or the agents will have no access to Ops Manager.

Agent Updates
Do not update the agents before upgrade. If you use Automation, Ops Manager prompts you to update the agents after you upgrade. Follow the prompts to update the agents through the Ops Manager UI. Do not update the agents manually.
conf-mms.properties
Beginning in 2.0, Ops Manager stores global configuration settings in the Ops Manager Application Database and stores only local settings in the Ops Manager server’s conf-mms.properties file. The upgrade procedure uses the existing conf-mms.properties file to connect to the Ops Manager Application Database before replacing the existing file with the new, smaller 2.0 file.
Restore properties

The following properties no longer apply and are replaced by settings specified when initiating a restore:

  • mms.backup.restore.linkExpirationHours
  • mms.backup.restore.linkUnlimitedUses
mms.conf
If you have modified the mms.conf file in your current installation (which is not typical), back up the file. You must use the new mms.conf file installed by the upgrade. You can redo any modifications once the upgrade is complete.

Prerequisite

Hardware and Software Requirements

Your servers must meet the Ops Manager Hardware and Software Requirements.

Warning

Failure to configure servers according to the Ops Manager Hardware and Software 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

There are no supported downgrade paths for Ops Manager.

Important

It is crucial that you back up the existing configuration because the upgrade process will delete existing data.

To upgrade Ops Manager:

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.

1

Shut down Ops Manager.

To shutdown Ops Manager:

  1. Click the Start button.
  2. Click Administrative Tools.
  3. Click Services.
  4. Right-click the MongoDB Ops Manager HTTP Service and select Stop.
  5. Right-click the MongoDB Ops Manager Backup Daemon Service and select Stop.
  6. Right-click the MongoDB Ops Manager Backup HTTP Service and select Stop. (Pre-2.0 only)
2

Uninstall the Backup Daemon package. (Pre-2.0 only)

Do the following on every server where the Backup Daemon is installed:

  1. Create a backup copy of each conf-daemon.properties file to preserve the existing configuration.
  2. Uninstall the Backup Daemon package.

Important

If you are prompted to restart the Windows server after uninstalling Ops Manager, restart the server before installing the new version of Ops Manager.

3

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 Windows Server 2008 R2+ from the Platforms drop-down menu.
  5. Select MSI from the Packages drop-down menu.
  6. Click Download.

Note

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

4

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

Important

On servers where there was only a Backup Daemon service, this will be a new install of Ops Manager package.

To install:

  1. Double click the MSI package.
  2. Follow the instructions in the Setup Wizard.
  3. During setup, the Configuration/Log Folder step prompts you to specify a folder where the configuration and log files will be stored.

The installation restricts access to the folder to users with the Administrator access privileges only.

5

Copy the connection string to the new Ops Manager instances.

  1. Copy the mongo.mongoUri string from the conf-mms.properties file of the server that was upgraded to the current version of Ops Manager.

  2. Replace the mongo.mongoUri string in each conf-mms.properties file in each servers which previously only hosted a Backup Daemon.

    Note

    The former Backup Daemon only servers used a different config file, but the upgrade to Ops Manager on those servers created a conf-mms.properties file. For these new instances to properly connect to the databases, this string must be replaced.

6

Start Ops Manager on every server.

  1. To start the service, click the Start button.
  2. Click Administrative Tools.
  3. Click Services.
  4. In the Services list, right-click the MongoDB Ops Manager HTTP Service and select Start.
7

Log into Ops Manager as a user with the Global Owner role.

Ops Manager displays a setup wizard for entering the Ops Manager configuration in the Application Database.

8

Complete the Ops Manager configuration setup.

The setup wizard walks you through several pages to configure the Application Database. Refer to your existing conf-mms.properties file as needed.

See also

Ops Manager Configuration for the mapping of conf-mms.properties parameters to setup wizard fields.

Important

Make sure you click Save on each tab, even if you do not make any changes.

9

Restart all Ops Manager services.

10

For any Backup Agents that were installed manually, update their configurations to use port 8080.

Beginning with Ops Manager 2.0, Backup Agents access Ops Manager through port 8080. The Automation Agent automatically updates the ports on managed Backup Agents. For any Backup Agents that were installed manually, you must edit the agent’s configuration file and set the mothership property to access Ops Manager on port 8080.