Install Ops Manager with a deb Package

Download the latest version of the Ops Manager package.

1. Open your preferred browser to visit the MongoDB Download Center on MongoDB.com.

   If you start from MongoDB.com, click Products Ops Manager Try it now.

2. From the Platforms drop-down menu, click Ubuntu 18.04.

3. From the Packages drop-down menu, click DEB for x86_64 architecture.

4. Click Download.

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

Optional: Verify Ops Manager package integrity.

To verify the integrity of the Ops Manager download, see Verify Integrity of Ops Manager Packages.

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

Install the .deb package by issuing the following command, where <version> is the version of the .deb package:

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

When installed, the base directory for the Ops Manager software is /opt/mongodb/mms/. The .deb package creates a new system user mongodb-mms under which the server will run.

Configure the Ops Manager connection to the Ops Manager Application Database.

On a server that is to run the Ops Manager, open /opt/mongodb/mms/conf/conf-mms.properties with root privileges and configure the settings described here, as appropriate.

Configure the following setting to provide the connection string Ops Manager uses to connect to the database:

• mongo.mongoUri

To configure Ops Manager to use the Ops Manager Application Database over TLS, configure the following TLS settings.

• mongo.ssl

• mongodb.ssl.CAFile

• mongodb.ssl.PEMKeyFile

• mongodb.ssl.PEMKeyFilePassword

Ops Manager also uses these settings for TLS connections to Backup Databases

To configure Ops Manager to use Kerberos to manage access to the Ops Manager Application Database, configure the following Kerberos settings:

• jvm.java.security.krb5.conf

• jvm.java.security.krb5.kdc

• jvm.java.security.krb5.realm

• mms.kerberos.principal

• mms.kerberos.keyTab

Start Ops Manager.

Issue the following command:

sudo systemctl start mongodb-mms.service

sudo start mongodb-mms

Open the Ops Manager home page and register the first user.

1. Enter the following URL in a browser, where <host> is the fully qualified domain name of the server:

   http://<OpsManagerHost>:8080

2. Click the Sign Up link and follow the prompts to register the first user and create the first project. The first user is automatically assigned the Global Owner role.

Configure Ops Manager.

Ops Manager walks you through several configuration pages. Required settings are marked with an asterisk. Enter information as appropriate. When configuration is complete, Ops Manager opens the Deployment page.

In addition to the common required settings, the following are required for particular deployment configurations. For more information on a setting, see Ops Manager Configuration Settings.

Copy the gen.key file from the current server to the other servers.

Ops Manager requires an identical gen.key file be stored on both servers running Ops Manager and uses the file to encrypt data at rest in the Ops Manager Application Database and Backup Database.

You must copy the gen.key file from the current server, on which you just installed Ops Manager, to every server that will run Ops Manager. You must copy the gen.key to the other servers before starting Ops Manager on them.

Use scp to copy the gen.key file from the /etc/mongodb-mms/ directory on the current server to the same directory on the other servers.

If you will run multiple Ops Manager Applications behind a load balancer, configure and start the applications.

For each Ops Manager instance, repeat the step to configure the connection to the Ops Manager Application Database and the step to start the application.

For more information on running multiple applications behind a load balancer, see Configure a Highly Available Ops Manager Application.

If you will run Ops Manager Backup, configure the Backup Daemon and Backup Storage.

1. Deploy your backup databases. You can use Ops Manager to manage replica set deployment after you install MongoDB on each host.

2. On each Ops Manager server that you activate as a Backup Daemon, create the directory that will be used as the head directory. The directory must be:

   • dedicated for this purpose on a local disk partition.

   • sized appropriately according to the Ops Manager System Requirements.

   • writable by the mongodb-mms user.

3. Configure the Backup Storage you want to use for your snapshots.

4. Open Ops Manager and verify that you are logged in as the user you registered when installing Ops Manager. This user is the global owner.

5. Click the Admin link at the top right of the page.

6. Click the Backup tab.

7. Follow the prompts to configure the Backup Daemon and Backup Storage. Ops Manager walks you through configuration of the daemon and snapshot storage.

   After you select how to store snapshots, you are prompted to configure the connection string to the Backup Database. If you use filesystem storage for your snapshots, the Backup Database is used only for the oplog store.

   WARNING: Once the connection string is saved, any change to the string requires you to restart all the Ops Manager instances, including those running activated Backup Daemons. Making the change and clicking Save is not sufficient. Ops Manager will continue to use the previous string until you restart the instances.

   <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.
   MongoDB Auth Username and MongoDB Auth Password	Enter the user credentials if the database uses authentication. WARNING: If you did not use the credentialstool to encrypt this password, it is stored as plaintext in the database.
   Encrypted Credentials	Check this if the user credentials use the Ops Manager credentialstool.
   Use SSL	Check this if the database uses SSL. If you select this, you must configure SSL settings Ops Manager. See Ops Manager Configuration Settings.
   Connection Options	To add additional connection options, enter them using the MongoDB Connection String URI Format. This field supports un-escaped values only.