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.

Install or Update the Backup Agent on Windows

On this page

Overview

The Backup Agent polls the primary MongoDB instance of every backup-enabled replica set and transmits the operations to the Ops Manager service.

The Backup Agent relies on the Ops Manager Monitoring Agent to populate the list of sharded clusters and replica sets eligible for backup. If the appropriate hosts are not added, or the Monitoring Agent is not being correctly run, the lists may be incomplete or out-of-date. If you have not already installed and configured Monitoring, please refer to the Install Monitoring Agent documentation.

Considerations

MongoDB Requirements

Ops Manager only supports backing up replica sets and sharded cluster, and does not support backing up standalone instances.

Ops Manager only supports backup for replica sets that run MongoDB 2.0 or later.

Ops Manager only supports backup for sharded clusters that run MongoDB 2.4 or later.

All backed up replica sets and config servers must be able to maintain oplog entries, by default, for at least 3 hours over the last 24 hour period. This window is configurable with the brs.minimumReplicationOplogWindowHr setting in the conf-mms.properties file for the Ops Manager Application. See Ops Manager Configuration Files for more information.

Agent Architecture

To avoid resource contention, run the agent on a host other than the hosts where the MongoDB instances are running. Be sure the agent can access the MongoDB hosts.

Running on Amazon EC2

If you run the Backup Agent on Amazon EC2, do not use the t1.micro instance type, which has a CPU scheduling policy that does not typically provide sufficient capacity to support a Backup Agent for a production deployment. Use a larger instance type instead.

Prerequisites

Monitoring Agent

Install and configure the Monitoring, as described in the Monitoring Agent documentation.

Firewall

If your MongoDB instances operate within a firewall, configure your network infrastructure to allow outbound connections on port 443 (SSL) to api-backup.mongodb.com.

Access Control

If you use Backup with a MongoDB deployment that uses authentication, before installing the Backup Agent, you must create a user in MongoDB with the appropriate access. See Configure Backup Agent for Access Control.

Backup Directory

After you install the Backup Agent, do not use the agent’s directory location for anything other than the agent itself. The Backup Agent periodically deletes the contents of its root directory.

Procedures

Install the Backup Agent On Windows

1

Download and run the latest version of the Backup Agent MSI file.

To download the 64-bit MSI file, use the following URL, where <mmsUri> is the hostname of the Backup server:

copy 
<mmsUri>/download/agent/backup/mongodb-mms-backup-agent-latest.windows_x86_64.msi

To download the 32-bit MSI file, use the following URL, where <mmsUri> is the hostname of the Backup server:

copy 
<mmsUri>/download/agent/backup/mongodb-mms-backup-agent-latest.windows_i386.msi

During installation, the installer prompts you to specify the folder for storing configuration and log files. It is strongly advised that you encrypt or restrict access to this folder.

2

Retrieve the Ops Manager API key for your Ops Manager group.

In the Administration tab on the Agents page, select your the approriate link for the Backup agent and your operating system. Ops Manager will then display a procedure that includes a step to set your Ops Manager API key. The step displays the actual Ops Manager API key used by your Ops Manager group. Copy the key.

3

Edit the local.config file to include your Ops Manager API key.

In the directory where you installed the Backup Agent, locate and open the local.config file. Enter your API key as the value for the mmsApiKey setting.

4

Edit the local.config file to include the hostname of the Backup server.

In the Backup Agent installation directory, open the local.config file and set the mothership property to hostname of the Backup server.

5

Start the Backup Agent.

In Windows Control Panel, open Administrative Tools, and then open Services.

In the list of services, select the MMS Backup Agent service. Select the Action menu and select Start.

Update the Backup Agent on Windows

1

Stop all currently running Backup Agents.

In Windows Control Panel, open Administrative Tools and then Services. In the list of services, select MMS Backup Agent. Select the Action menu and select Stop.

If you receive a message that your Backup Agent is out of date, make sure you are running an upgradeable version of the Backup Agent. If you are running the version of the Backup Agent named MongoDBBackup, you must remove it before upgrading. To check if you are running MongoDBBackup, issue the following command in an Administrative command prompt:

copy 
sc query MongoDBBackup

If the command returns a result, you must remove the MongoDBBackup agent. To remove it, issue the following:

copy 
sc delete MongoDBBackup
2

Download and run the latest version of the Backup Agent MSI file.

To download the 64-bit MSI file, use the following URL, where <mmsUri> is the hostname of the Backup server:

copy 
<mmsUri>/download/agent/backup/mongodb-mms-backup-agent-latest.windows_x86_64.msi

To download the 32-bit MSI file, use the following URL, where <mmsUri> is the hostname of the Backup server:

copy 
<mmsUri>/download/agent/backup/mongodb-mms-backup-agent-latest.windows_i386.msi

During installation, the installer prompts you to specify the folder for storing configuration and log files. It is strongly advised that you encrypt or restrict access to this folder.

3

Retrieve the Ops Manager API key for your Ops Manager group.

In the Administration tab on the Agents page, select your the approriate link for the Backup agent and your operating system. Ops Manager will then display a procedure that includes a step to set your Ops Manager API key. The step displays the actual Ops Manager API key used by your Ops Manager group. Copy the key.

4

Edit the local.config file to include your Ops Manager API key.

In the directory where you installed the Backup Agent, locate and open the local.config file. Enter your API key as the value for the mmsApiKey setting.

5

Start the Backup Agent.

In Windows Control Panel, open Administrative Tools, and then open Services.

In the list of services, select the MMS Backup Agent service. Select the Action menu and select Start.

Next Steps

After you have successfully installed the Backup Agent, see Activate Backup to enable backup for a replica set.

Additional Information

The README included with the downloaded package also provides information about the Backup Agent.

For details about Backup operations, see Backup FAQs.

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