Install MongoDB

Overview

MongoDB is a recommended dependency of IPLM Cache, but is optional. Using it provides a number of benefits:

  • The ability to expire cache entries

  • Consistency checking of the cache

  • Storing log files in the database where they can be queried

If these features aren’t required, then you do not need to use MongoDB. By default, only the log storage is enabled. Automatic cache expiry and consistency checking is something that must be enabled in the IPLM Cache configuration.

If you don’t want to use MongoDB, you can enable the following configurable in: /etc/mdx/picache.conf

Copy
log-target-backend = syslog

This topic provides instructions for a new installation of MongoDB with your IPLM package installation. If you need to upgrade an existing MongoDB instance, see Migrate from MongoDB 3 to MongoDB 8 for more information.

Considerations

  • Prior to IPLM Core 2025.4, MongoDB used to be provided as the package iplm-backend-mongodb. Read more about this change in MongoDB 8 upgrade and migration overview.

  • Determine if you want to install MongoDB for your IPLM installation. MongoDB is a dependency of IPLM Cache, and needs to be installed and configured before IPLM Cache can be used.

Step 1: Configure MongoDB package repository

Run the following command to configure the repository where the packages are downloaded from:

Copy
[mongodb-org-8.2]
name=MongoDB Repository
baseurl=https://repo.mongodb.org/yum/redhat/8/mongodb-org/8.2/x86_64/
gpgcheck=1
enabled=1
gpgkey=https://pgp.mongodb.com/server-8.0.asc

Step 2: Install MongoDB

Run the following command to install MongoDB:

Copy
sudo dnf install mongodb-org

Step 3: Enable and start MongoDB

Run the following commands to enable and start MongoDB:

Copy
sudo systemctl enable mongod
sudo systemctl start mongod

Next steps

Once you have completed the MongoDB installation, follow the instructions to install IPLM Cache.