How To Install MongoDB 4.x on CentOS 7 / Fedora 30/29/28

Welcome to our guide on how to install MongoDB 4 on CentOS 7 / Fedora 30/29/28. MongoDB is an open source NoSQL database system written in C++. It is designed for high scalability, performance, and availability.

Step 1: Add DNF/YUM MongoDB Repositories

The first step in the installation of MongoDB 4 on CentOS 7 / Fedora 30/29/28 is to add the repositories to the system.

Add MongoDB 4 repository.

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

Step 2: Install MongoDB 4.0 on CentOS 7 / Fedora 30/29/28

Next is to install mongodb-org package on CentOS 7 / Fedora 30/29/28.

Install MongoDB 4 on Fedora 30/29/28.

sudo dnf -y install mongodb-org

Install MongoDB 4 on CentOS 7:

sudo yum -y install mongodb-org

You can check the version of MongoDB installed using the following command:

$ mongo -version
MongoDB shell version v4.0.9
git version: fc525e2d9b0e4bceff5c2201457e564362909765
OpenSSL version: OpenSSL 1.0.1e-fips 11 Feb 2013
allocator: tcmalloc
modules: none
build environment:
    distmod: rhel70
    distarch: x86_64
    target_arch: x86_64

The installation of mongodb-org package will install:

mongodb-org-server – This provides MongoDB daemon mongod
mongodb-org-mongos – This is a MongoDB Shard daemon
mongodb-org-shell – This provides a shell to MongoDB
mongodb-org-tools – MongoDB tools used for export, dump, import e.t.c

Step 3: Configure MongoDB (Optional)

You can customize MongoDB installation before starting the service.

Label MongoDB port

If you have SELinux in enforcing mode, you may need to label port 27017

sudo semanage port -a -t mongod_port_t -p tcp 27017

Allow MongoDB Port on the firewall

If you have an active firewalld service on your server and would like MongoDB service to be accessible over the network, allow port 27017/tcp:

sudo firewall-cmd --add-port=27017/tcp --permanent
sudo firewall-cmd --reload

You can also limit access based on source address

sudo firewall-cmd --permanent --add-rich-rule "rule family="ipv4" \
source address="192.168.5.0/24" port protocol="tcp" port="27017" accept"

Using secondary disk for MongoDB data (Optional)

You can choose to use a dedicated disk to store MongoDB data.

Step 1: Partition secondary disk for MongoDB data:

$ lsblk  | grep vdb
vdb             252:16   0  50G  0 disk

Step 2: Create a GPT partition table for the secondary disk, it can be more than one disk:

sudo parted -s -a optimal -- /dev/vdb mklabel gpt
sudo parted -s -a optimal -- /dev/vdb mkpart primary 0% 100%
sudo parted -s -- /dev/vdb align-check optimal 1

Step 3: Create LVM volume, this will make it easy to extend the partition:

sudo pvcreate  /dev/vdb1
sudo vgcreate vg0 /dev/vdb1
sudo lvcreate -n mongo -l 100%FREE vg0

Step 4: Create XFS filesystem on the Logical Volume created.

$ sudo mkfs.xfs /dev/mapper/vg0-mongo
meta-data=/dev/mapper/vg0-mongo isize=512    agcount=4, agsize=6553344 blks
         =                       sectsz=512   attr=2, projid32bit=1
         =                       crc=1        finobt=0, sparse=0
data     =                       bsize=4096   blocks=26213376, imaxpct=25
         =                       sunit=0      swidth=0 blks
naming   =version 2              bsize=4096   ascii-ci=0 ftype=1
log      =internal log           bsize=4096   blocks=12799, version=2
         =                       sectsz=512   sunit=0 blks, lazy-count=1
realtime =none                   extsz=4096   blocks=0, rtextents=0

Step 5: Create a mount point and mount the partition

echo "/dev/mapper/vg0-mongo /var/lib/mongo xfs defaults 0 0" | sudo tee -a /etc/fstab
sudo mount -a
sudo chown -R mongod:mongod /var/lib/mongo
sudo chmod -R 775 /data/mongo

Step 7: Confirm that the partition mount was successful:

$ df -hT | grep  /var/lib/mongo
/dev/mapper/vg0-mongo xfs        50G   33M   50G   1% /var/lib/mongo

Step 8: Set MongoDB data store location

$ sudo vim /etc/mongod.conf
 storage:
 dbPath: /var/lib/mongo 
 journal:
   enabled: true

Step 4: Start & Enable MongoDB Service

The last step is to start and enable MongoDB service to start on boot

sudo systemctl start mongod.service
sudo systemctl enable mongod.service

Check status by running:

sudo systemctl status mongod.service

For Authentication, check our guide on How to configure MongoDB 4 authentication.