- MongoDB Agent >
- MongoDB Agent Prerequisites
MongoDB Agent Prerequisites¶
On this page
This section describes the requirements for the hosts that run the MongoDB Agent.
Hosts that run MongoDB Agents must run on a 64-bit version of one of the following hardware architectures and operating systems. The following table lists the MongoDB Server versions that you can deploy with the MongoDB Agent on the associated platforms:
Architecture | Distro/OS | 7.0 | 6.0 | 5.0 | 4.4 | 4.2 | 4.0 | 3.6 |
---|---|---|---|---|---|---|---|---|
x86_64 | RHEL/Centos 7 | check circle icon | check circle icon | check circle icon | check circle icon | check circle icon | check circle icon | check circle icon |
RHEL/Centos/Rocky/Alma 8 1 | check circle icon | check circle icon | check circle icon | check circle icon | check circle icon | check circle icon | check circle icon | |
RHEL/Centos/Rocky/Alma 9 1 | check circle icon | check circle icon | check circle icon | |||||
Amazon Linux 2 | check circle icon | check circle icon | check circle icon | check circle icon | check circle icon | check circle icon | check circle icon | |
Amazon Linux 2023 | check circle icon | |||||||
SUSE12 | check circle icon | check circle icon | check circle icon | check circle icon | check circle icon | check circle icon | check circle icon | |
SUSE15 | check circle icon | check circle icon | check circle icon | check circle icon | check circle icon | |||
Debian 8 2 | check circle icon | check circle icon | ||||||
Debian 9 2 | check circle icon | check circle icon | check circle icon | check circle icon | check circle icon | |||
Debian 10 2 | check circle icon | check circle icon | check circle icon | check circle icon | ||||
Debian 11 2 | check circle icon | check circle icon | check circle icon | |||||
Ubuntu 16.x | check circle icon | check circle icon | check circle icon | check circle icon | ||||
Ubuntu 18.x | check circle icon | check circle icon | check circle icon | check circle icon | check circle icon | check circle icon | ||
Ubuntu 20.x | check circle icon | check circle icon | check circle icon | check circle icon | ||||
Ubuntu 22.x 3 | check circle icon | check circle icon | ||||||
Windows | check circle icon | check circle icon | check circle icon | check circle icon | check circle icon | check circle icon | check circle icon | |
ARM | RHEL/Centos 8 | check circle icon | check circle icon | check circle icon | check circle icon | |||
Amazon Linux 2 | check circle icon | check circle icon | check circle icon | check circle icon | check circle icon | |||
Ubuntu 20.x | check circle icon | |||||||
Ubuntu 22.x | check circle icon | |||||||
PowerPC/ ppc64le | RHEL/ Centos 7 | check circle icon | check circle icon | check circle icon | check circle icon | check circle icon | check circle icon | check circle icon |
RHEL/ Centos 8 | check circle icon | check circle icon | check circle icon | check circle icon | check circle icon | |||
zSeries/ 390x | RHEL 7 | check circle icon | check circle icon | check circle icon | check circle icon | check circle icon | check circle icon | check circle icon |
RHEL 8 | check circle icon | check circle icon | check circle icon |
1 The Rocky or Alma Linux OS
must include the redhat-lsb-core
package.
2 The Debian installation must include the
lsb-release
package. To learn more, see lsb-release.
3 MongoDB Connector for BI isn’t supported on Ubuntu 22.04.
Hardware Requirements¶
Use 64-bit Chip Architectures¶
The MongoDB Agent must run on 64-bit architectures.
Provide Sufficient CPU and RAM¶
MongoDB recommends a minimum of 2 CPU cores and 2 GB of RAM for MongoDB Agent hosts.
If you activate backup, all MongoDB Agent hosts require at least an additional 2 CPU cores and 3 GB of RAM beyond basic platform requirements. Each backup job that the MongoDB Agent runs further impacts host performance.
Set Host Network Access¶
The hosts that serve the MongoDB deployments must:
- Have full network access to each other through their Fully Qualified Domain Names (FQDNs). Each host must reach each other host through the FQDN.
- Permit Automation to start
mongod
on a random ephemeral port and connect to that port when restoring your deployment from a backup.
- Windows
- Ubuntu/Debian
- RHEL/CentOS/SLES/AMZ
- Linux
Find the FQDN for each host. Run the following command in Powershell:
Download and install the Windows BIND tools.
Find the FQDN for each host. Run the following command in the shell:
Find the FQDN for each host. Run the following command in the shell:
Find the FQDN for each host. Run the following command in the shell:
Resolve each FQDN to a unique IP address. Run the following command in the shell to resolve the FQDN:
Set the Common Name or Subject Alternative Name value of any SSL certificates to the MongoDB host’s FQDN.
The network configuration must allow each MongoDB Agent to make a direct connection to each MongoDB deployment listed on the Deployment page. Cloud Manager does not support port forwarding.
- Windows
Disable Windows Firewall Stealth Mode
For best performance, Disable Windows Firewall stealth mode on the MongoDB hosts on which you installed the MongoDB Agent.
Set Host Permissions¶
On a Host that Already Runs MongoDB¶
If you install the MongoDB Agent on a host that is running a MongoDB process, the agent must have:
- Permission to stop any MongoDB processes. The MongoDB Agent restarts the process using the Agent’s own set of MongoDB binaries. If you installed MongoDB with a package manager, use the same package manager to install the MongoDB Agent. This gives the MongoDB Agent the same owner as MongoDB.
Read
andWrite
permissions on the MongoDB data directory and log directory.
On a Host Before Installing MongoDB¶
If you deploy the MongoDB Agent to a host that doesn’t have MongoDB
installed, ensure the user that owns the MongoDB Agent has Read
and
Write
permissions on the MongoDB data and log directories you plan
to use.
- Ubuntu/Debian
- RHEL/CentOS/SLES/AMZ
- Linux
Root Access
To install the MongoDB Agent using a deb
package, log in as
root
or a user with sudo
privileges.
To install the MongoDB Agent using a .rpm
package, log in as
root
or a user with sudo
privileges.
To install the MongoDB Agent using a .tar
package, log in as
root
or a user with sudo
privileges.
Acquire an Agent API Key¶
The MongoDB Agent requires one Agent API Key per project to communicate with the Cloud Manager.
If you do not have an existing Agent API Key for your Cloud Manager project, create one:
Click Deployment.
Navigate to Agents.
Click Agent API Keys.
Click plus icon Generate.
Note
This button appears if:
- The current user is the
Project Owner
and - The project has no Agent API Keys other than the Original Group API Key with an exclamation exclamation circle icon next to it. This type of key exists in projects created before the new Agent API Key model. In the new model, you can create multiple Agent API Keys in a project, and any the project’s MongoDB Agents can use any of the keys.
- The current user is the
In the Generate Key modal, provide a description of the new Agent API Key in the Description box.
Click Generate.
Important
When you generate an Agent API Key, Cloud Manager displays it one time only. You must copy this key. Treat it like a password; store it in a secure place. Cloud Manager never displays the full key again.