- Ops Manager Overview >
- Install a Simple Test Ops Manager Installation
Install a Simple Test Ops Manager Installation¶
On this page
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.
Unlike a production installation, the simple test installation uses only one mongod for the Ops Manager Application database. In production, the database requires a dedicated replica set.
This procedure includes optional instructions to activate the Backup feature, in which case you would install Snapshot Storage on the same server as the other Ops Manager components. The backup database uses only one mongod and not a dedicated replica set, as it would in production.
This tutorial installs the test deployment on servers running either Red Hat Enterprise Linux 7.0.
Procedure¶
Warning
This setup is not suitable for a production deployment.
To install and configure an evaluation version of Ops Manager:
Provision an Ops Manager host.¶
Provision a host for Ops Manager that meets the following requirements:
System Memory | 15 GB |
---|---|
Disk Capacity | 50 GB in / |
Host OS Permissions | root |
Host OS | Red Hat Enterprise Linux 7.0 |
Using AWS
An AWS EC2 m3.xlarge
instance meets the memory requirements.
Change the size of the instance’s root partition to 50 GB. Log
into the instance and execute df -h
to verify the root
partition has 50 GB of space.
Important
Ensure the ulimit
settings meet the minimum requirements.
For more information, see the MongoDB Ulimit Settings.
Configure yum
to install MongoDB.¶
Issue the following command to set up a yum
package management
system repository definition:
Install MongoDB.¶
Issue the following command to install the latest stable release of MongoDB:
Create the Ops Manager Application Database directory.¶
Issue the following two commands to create the data directory and change its ownership:
(Optional) Create the Ops Manager backup data directory.¶
To configure the Backup feature as well, issue the following additional commands for the backup database:
Start the Ops Manager Application Database mongod instance.¶
Start MongoDB as the mongod
user, specifying:
Setting | Command Option | Value |
---|---|---|
Port | --port |
27017 |
Absolute path for MongoDB data files | --dbpath |
/data/appdb |
Absolute file path for MongoDB logs | --logpath |
/data/appdb/mongodb.log |
Amount of cache the WiredTiger storage engine uses for the application database. | --wiredTigerCacheSizeGB |
1 |
Flag to run the mongod in the background and maintain
control of the terminal |
--fork |
The resulting command would resemble this:
(Optional) Start the Ops Manager Backup Database mongod instance.¶
Start MongoDB as the mongod
user, specifying:
Setting | Command Option | Value |
---|---|---|
Port | --port |
27018 |
Absolute path for MongoDB data files | --dbpath |
/data/backup |
Absolute file path for MongoDB logs | --logpath |
/data/backup/mongodb.log |
Amount of cache the WiredTiger storage engine uses for the application database. | --wiredTigerCacheSizeGB |
1 |
Flag to run the mongod in the background and maintain
control of the terminal |
--fork |
The resulting command would resemble this:
Download the Ops Manager package.¶
- Open your preferred browser to visit the MongoDB Download Center.
- Click the Tools tab and then click Ops Manager.
- From the Platforms drop-down menu, click Red Hat + CentOS 6, 7 / SUSE 12 / Amazon Linux.
- From the Packages drop-down menu, click RPM.
- Click Download.
Note
The downloaded package is named
mongodb-mms-<version>.x86_64.rpm
, where <version>
is the
version number.
Install Ops Manager.¶
Install the .rpm
package by issuing the following command, where
<version>
is the version of the Ops Manager .rpm
package:
The install creates the following:
The base directory for the Ops Manager software, which is:
/opt/mongodb/mms/
A new system user,
mongodb-mms
, under which the host runs.The
/opt/mongodb/mms/conf/conf-mms.properties
file, which contains the connection string to access the Application Database. The default islocahost
, port27017
, so no changes are necessary.
Start Ops Manager.¶
Issue the following command:
Get your instance hostname.¶
If you are using an EC2 instance, the hostname is the Public DNS
listed on the EC2 instance’s Description
tab.
If you do not have a hostname, you can instead use the public IP address. To get the public IP address, paste this URL into your preferred browser:
Open the Ops Manager home page and register the first user.¶
In a browser, enter the following URL using the hostname. If do not have a hostname, use the public IP address instead:
Click the Register 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.
(Optional) Configure the backup capabilities.¶
Create a directory to store the head databases.
Important
Do not use this directory for any other purpose:
Make the directory writable by the
mongodb-mms
user:In Ops Manager, while logged in as the user you registered during installation, click the Admin link at the top right of the page.
Click the Backup tab.
Follow the prompts to configure the Backup storage. Ops Manager walks you through the configuration.
For snapshot storage, select either the local filesystem or the backup database. If you use a File System Store, you still need a small MongoDB database for oplog storage. At the prompt to configure the connection string to the backup database, enter your local hostname and port:
Ops Manager automatically prefixes connection strings with
mongodb://
. Your connection string should match the following:
Set up your first deployment.¶
- Click MongoDB Ops Manager in the upper left corner of the page to return to the Deployment page.
- Click Add New to deploy a MongoDB instance.