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 a Simple Test Ops Manager Installation

Warning

This setup is not suitable for a production deployment.

To evaluate Ops Manager, you can install the Ops Manager Application and Ops Manager Application Database on a single host. This setup provides all the functionality of Ops Manager monitoring and automation but provides no failover or high availability.

Considerations

This test installation includes the following caveats:

  • It uses one mongod for the Ops Manager Application database. In production, the database requires a dedicated replica set.
  • It uses MongoDB Community Edition. MongoDB Community doesn’t need additional libraries.
  • It doesn’t include backup functionality.

Procedure

To install and configure an evaluation version of Ops Manager on hosts running Red Hat Enterprise Linux 8.0:

1

Provision an Ops Manager host.

Provision a host for Ops Manager. This host must meet the following requirements:

System Memory 15 GB
Disk Capacity 50 GB in / (The root directory of this host)
Host OS Permissions root
Host OS Red Hat Enterprise Linux 8.0

Cloud-based instances must meet the memory and storage requirements.

To verify the needed capacity, log in to the instance and execute the following commands:

vmstat -S M -s | grep "total memory"

16384 M total memory

This instance has 16 GB of RAM.

df -h | grep "/$"

/dev/sda1        73G   58G   12G  84% /

This instance has 73 GB of storage capacity.

Important

Verify that the ulimit settings meet the minimum requirements.

2

Configure yum to install MongoDB.

Create a /etc/yum.repos.d/mongodb-org-5.0.repo file so that you can install MongoDB directly using yum:

[mongodb-org-5.0]
name=MongoDB Repository
baseurl=https://repo.mongodb.org/yum/redhat/$releasever/mongodb-org/5.0/x86_64/
gpgcheck=1
enabled=1
gpgkey=https://pgp.mongodb.com/server-5.0.asc
3

Install MongoDB.

Invoke the following command to install the latest stable release of MongoDB Community:

sudo yum install -y mongodb-org
4

Optional: Disable the mongod service.

Ops Manager connects to its application database on port 27017. If the host on which you want to install the application database has a running mongod, disable that existing database.

To disable the mongod service, invoke the following command:

sudo systemctl disable mongod
5

Create the Ops Manager Application Database directory.

  1. Invoke the following command to create the data directory:

    sudo mkdir -p /data/appdb
    
  2. Invoke the following command to change ownership of the data directory to MongoDB:

    sudo chown -R mongod:mongod /data
    
6

Update the MongoDB configuration file.

The installer creates a configuration file saved at /etc/mongod.conf.

  1. Open the MongoDB file with your preferred text editor.

  2. Edit the file to make the following changes:

     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    systemLog:
      destination: file
      path: "/data/appdb/mongodb.log"
      logAppend: true
    storage:
      dbPath: "/data/appdb"
      journal:
        enabled: true
      wiredTiger:
        engineConfig:
          cacheSizeGB: 1
    processManagement:
      fork: true
      timeZoneInfo: /usr/share/zoneinfo
      pidFilePath: /var/run/mongodb/mongod.pid
    net:
      bindIp: 127.0.0.1
      port: 27017
    setParameter:
      enableLocalhostAuthBypass: false
    
  3. Save the file when you have made the edits.

7

Start the Ops Manager Application Database mongod instance.

sudo -u mongod mongod -f /etc/mongod.conf
8

Download the Ops Manager package.

  1. Navigate to the Ops Manager Download Center.
  2. From the Platforms drop-down menu, click Red Hat + CentOS 6, 7, 8 / SUSE 12 + 15 / Amazon Linux.
  3. From the Packages drop-down menu, click RPM.
  4. Click Download.

Note

MongoDB names the downloaded package mongodb-mms-<version>.x86_64.rpm. <version> represents the version number for Ops Manager.

9

Optional: Copy the Ops Manager .rpm package to your host.

If you install Ops Manager on a remote host, such as a cloud service provider instance, use scp to copy the installer to your host:

scp -i <keyfile> mongodb-mms-<version>.x86_64.rpm \
       <username>@<public-ip>:~
10

Install Ops Manager.

To install the .rpm package, invoke the following command. <version> represents the Ops Manager version in the .rpm package:

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

This command creates the following artifacts:

Artifact Value
Ops Manager software base directory /opt/mongodb/mms/
New system user that owns the Ops Manager processes mongodb-mms.
Ops Manager configuration file with the connection string to access the Application Database. Don’t change this value defaults from locahost:27017. /opt/mongodb/mms/conf/conf-mms.properties
11

Start Ops Manager.

Invoke the following command:

sudo service mongodb-mms start
12

Get your instance hostname.

If you use an cloud service provider instance, find the hostname following the directions of the relevant provider:

If you don’t have a hostname, use the public IP address. To find your host’s public IP address, paste this URL into your preferred browser:

https://www.google.com/search?q=myip
13

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

  1. In a browser, enter the following URL using the hostname. If do not have a hostname, use the public IP address instead:

    http://<OpsManagerHost>:<Port>
    
  2. Click the Sign Up link.

  3. Follow the console prompts to register the first user and create the first organization and project. Ops Manager assigns the Global Owner role to the first user.

14

Configure Ops Manager.

Ops Manager opens the configuration console. Ops Manager marks required settings with an asterisk.

Enter the information as appropriate. When you finish the configuration, Ops Manager opens the Deployment page.

15

Set up your first deployment.

  1. Click MongoDB Ops Manager in the upper left corner of the page to return to the Deployment page.

  2. Click Add New to deploy a MongoDB instance.