How To Install MongoDB on AlmaLinux 9

In this tutorial, we will show you how to install MongoDB on AlmaLinux 9. For those of you who didn’t know, MongoDB is a high-performance, highly scalable document-oriented NoSQL database. Unlike in SQL databases where data is stored in rows and columns inside tables, in MongoDB, data is structured in JSON-like format inside records which are referred to as documents. The open-source attribute of MongoDB as a database software makes it an ideal candidate for almost any database-related project.

This article assumes you have at least basic knowledge of Linux, know how to use the shell, and most importantly, you host your site on your own VPS. The installation is quite simple and assumes you are running in the root account, if not you may need to add ‘sudo‘ to the commands to get root privileges. I will show you the step-by-step installation of the MongoDB NoSQL database on AlmaLinux 9. You can follow the same instructions for CentOS and Rocky Linux.

Prerequisites

• A server running one of the following operating systems: AlmaLinux 9.
• It’s recommended that you use a fresh OS install to prevent any potential issues.
• SSH access to the server (or just open Terminal if you’re on a desktop).
• A non-root sudo user or access to the root user. We recommend acting as a non-root sudo user, however, as you can harm your system if you’re not careful when acting as the root.

Install MongoDB on AlmaLinux 9

Step 1. System Preparation.

To ensure a smooth installation process, it’s crucial to update your AlmaLinux 9 system to the latest available packages. Open your terminal and execute the following commands:

sudo dnf clean all
sudo dnf update

These commands will clean the package cache and update all installed packages to their latest versions, providing a stable and secure foundation for MongoDB.

Step 2. Installing MongoDB 5 on AlmaLinux 9.

By default, MongoDB is not available on the AlmaLinux 9 base repository. Simply add the repository manually MongoDB to your AlmaLinux system with the following command:

sudo tee /etc/yum.repos.d/mongodb-org-6.0.repo <<-EOF
[mongodb-org-6.0]
name=MongoDB Repository
baseurl=https://repo.mongodb.org/yum/redhat/\$releasever/mongodb-org/6.0/x86_64/
gpgcheck=1
enabled=1
gpgkey=https://www.mongodb.org/static/pgp/server-6.0.asc
EOF

Once you’ve added the repository, update the system repositories to sync the newly added MongoDB repository with the system and install it:

sudo dnf install mongodb-org

Alternatively, to install a specific release of MongoDB, specify each component package individually and append the version number to the package name, as in the following example:

sudo dnf install -y mongodb-org-6.0.9 mongodb-org-database-6.0.9 mongodb-org-server-6.0.9 mongodb-org-shell-6.0.9 mongodb-org-mongos-6.0.9 mongodb-org-tools-6.0.9

Next, start the MongoDB service and enable it to automatically start on boot by running the following command:

sudo systemctl enable --now mongod
sudo systemctl start mongod
sudo systemctl status mongod

Step 3. Accessing MongoDB on AlmaLinux.

Like with Rhel-based, to access the MongoDB shell, issue the command:

mongo

Output:

[root@idroot.us ~]# mongo
MongoDB shell version v5.0.9
connecting to: mongodb://127.0.0.1:27017/?compressors=disabled&gssapiServiceName=mongodb
Implicit session: session { "id" : UUID("9e364ff9-53ad-jelita-mega-ff08946b9e1") }
MongoDB server version: 5.0.9
Welcome to the MongoDB shell.
For interactive help, type "help".
...

Step 4. Creating MongoDB Admin User.

First, access MongoDB’s shell:

mongosh

Command to switch to the database admin by running:

> use admin

Next, create an Admin user by running the following command:

> db.createUser(
{
user: "enter-name-user",
pwd: "enter-password-user",
roles: [ { role: "userAdminAnyDatabase", db: "admin" } ]
}
)

Step 5. Troubleshooting Common Issues.

If you encounter any issues during the installation or configuration of MongoDB on AlmaLinux 9, here are a few common problems and their solutions:

• • MongoDB service fails to start: Check the MongoDB log file located at /var/log/mongodb/mongod.log for any error messages. Ensure that the configuration file is properly formatted and contains valid settings.
  • Connection issues: Verify that the MongoDB service is running and listening on the configured port (default is 27017). Check the firewall settings to ensure that the port is open and accessible.
  • Authentication failures: Double-check the username and password used for authentication. Ensure that the user has the necessary privileges to access the desired databases.

Congratulations! You have successfully installed MongoDB. Thanks for using this tutorial for installing MongoDB 5 on your AlmaLinux 9 system. For additional help or useful information, we recommend you check the official MongoDB website.