- Install Ops Manager >
- Advanced Configuration Options >
- Configure a Highly Available Ops Manager Application
Configure a Highly Available Ops Manager Application¶
On this page
Overview¶
The Ops Manager Application provides high availability through use of multiple Ops Manager Application servers behind a load balancer and through use of a replica set to host the Ops Manager Application Database.
Multiple Ops Manager Application Servers¶
The Ops Manager Application’s components are stateless between requests. Any Ops Manager Application server can handle requests as long as all the servers read from the same Ops Manager Application Database. If one Ops Manager Application becomes unavailable, another fills requests.
To take advantage of this for high availability, configure a load balancer
of your choice to balance between the pool of Ops Manager Application servers.
In Ops Manager, set the URL to Access Ops Manager
property to the load
balancer URL. Set the Load Balancer Remote IP Header
property to
the HTTP header field the load balancer uses to identify the originating
client’s IP address (for example, X-Forwarded-For
).
The Ops Manager Application uses the client’s IP address for auditing,
logging, and white listing for the API.
Replica Set for the Ops Manager Application Database¶
Deploy a replica set rather than a standalone to host the Ops Manager Application Database. Replica sets have automatic failover if the primary becomes unavailable.
If the replica set has members in multiple facilities, ensure that a single facility has enough votes to elect a primary if needed. Choose the facility that hosts the core application systems. Place a majority of voting members and all the members that can become primary in this facility. Otherwise, network partitions could prevent the set from being able to form a majority. For details on how replica sets elect primaries, see Replica Set Elections.
You can create backups of the replica set using file system snapshots. File system snapshots use system-level tools to create copies of the device that holds replica set’s data files.
To deploy the replica set that hosts the Ops Manager Application Database, see backing MongoDB instance.
The gen.key
File¶
gen.key
file is a 24-byte binary file used to encrypt and decrypt
Ops Manager’s backing databases and user credentials. An identical
gen.key
file must be stored on every server that is part of a highly
available Ops Manager deployment.
The gen.key
file can be generated automatically or manually.
- To have Ops Manager generate the file:
- Start one Ops Manager server. Ops Manager will create a
gen.key
file if none exists. - To create the file manually:
Generate a 24-byte binary file. For example, the following creates the
gen.key
file usingopenssl
:Protect the
gen.key
file like any sensitive file. Change the owner to the user running Ops Manager and set the file permission to read and write for the owner only.
Once you have the gen.key
file (either created automatically or
manually), before starting the other Ops Manager servers, copy the file
to the appropriate directory on the current server and to the
appropriate directory on the other Ops Manager servers:
/etc/mongodb-mms/
for RPM or Ubuntu installations<installPath>/.mongodb-mms/
for an archive (.tar
) file installations<installPath>\MMSData\Secrets
for Microsoft Windows Server installations
Important
- Any shared storage resource that stores the
gen.key
file should be configured for high availability so as not to introduce a potential single point of failure. - Any Ops Manager server that does not have the
gen.key
file installed cannot connect to the backing databases and become part of an HA Ops Manager instance. - Once you have generated the
gen.key
for your Ops Manager instance on the first Ops Manager server, back up thegen.key
file to a secure location.
Prerequisites¶
Deploy the replica set that hosts the Ops Manager Application Database. To deploy a replica set, see Deploy a Replica Set in the MongoDB manual.
Procedure¶
The following procedure assumes you will let one of the Ops Manager Applications
create the gen.key
. If you instead create your own gen.key
,
distribute it to the servers before starting any of the Ops Manager Applications.
Important
The load balancer placed in front of the Ops Manager Application servers must not return cached content. The load balancer must have caching turned off.
To configure multiple Ops Manager Applications with load balancing:
Configure a load balancer with the pool of Ops Manager Application servers.¶
Configure the load balancer to perform a health check on each Ops Manager Application login page:
The load balancer must not return cached content.
Configure Ops Manager to use the load balancer.¶
- In Ops Manager, click Admin, then the General tab, and then Ops Manager Config.
- Configure the
URL to Access Ops Manager
property to point to the load balancer URL. - Set the
Load Balancer Remote IP Header
property to the name of the HTTP header field the load balancer uses to identify the client’s IP address.
Update each Ops Manager Application server with the replication hosts information.¶
On each server, edit the conf-mms.properties
file to
set the mongo.mongoUri
property to the connection string of the Ops Manager Application Database. You
must specify at least 3 hosts in the mongo.mongoUri
connection string. For example:
On each server, manually update the mmsBaseUrl property in the Automation Agent configuration file to point to the load balancer.¶
See Automation Agent Configuration for the name and location of the configuration file for your platform.
On each server, manually update the mmsBaseUrl property in the configuration file for the Monitoring Agent to point to the load balancer.¶
Note
Perform this step only for Monitoring Agents that are not managed by the Automation Agent.
See Monitoring Agent Configuration for the name and location of the configuration file for your platform.
On each server, manually update the mothership
property in the configuration file for the Backup Agent to point to the load balancer.¶
Note
Perform this step only for Backup Agents that are not managed by the Automation Agent.
See Backup Agent Configuration for the name and location of the configuration file for your platform.
Start one of the Ops Manager Applications.¶
For example, if you installed the Ops Manager Application with an
rpm
or deb
package, issue the following:
Copy the gen.key
file.¶
The gen.key
file is located in /etc/mongodb-mms/
for
installations from a package manager and in ${HOME}/.mongodb-mms/
for installations from an archive.
Copy the gen.key
file from the running Ops Manager Application’s server to the
appropriate directory on the other Ops Manager Application servers.
Start the remaining Ops Manager Applications.¶
Additional Information¶
For information on making Ops Manager Backup highly available, see Configure a Highly Available Ops Manager Backup Service.