- Install Ops Manager >
- Upgrade Ops Manager >
- Upgrade Ops Manager with
deb
Packages
Upgrade Ops Manager with deb
Packages¶
On this page
Warning
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.
Overview¶
This tutorial describes how to upgrade an existing
Ops Manager Application and Backup Daemon
using deb
packages.
Prerequisite¶
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 http://www.mongodb.com/download.
Procedures¶
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.
Recommended. Take a full backup of the Ops Manager database before beginning the upgrade procedure.¶
Shut down Ops Manager.¶
For example:
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:
Save a copy of your previous configuration file.¶
For example:
Upgrade the package.¶
For example:
Edit the new configuration file.¶
Fill in the new configuration file at
/opt/mongodb/mms/conf/conf-mms.properties
using your old file as a
reference point.
Start Ops Manager.¶
For example:
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.¶
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.
Point the Backup Daemon to the Ops Manager Application database.¶
Open the /opt/mongodb/mms-backup-daemon/conf/conf-daemon.properties
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:
If everything worked the following displays:
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.