Commvault uses MongoDB as a core infrastructure component to provide better performance for its API server. Commvault uses the following methods to define the version of MongoDB that is used:
When a new Commvault Platform Release (for example, 2024 [11.34]) is available, Commvault uses the latest stable major version of MongoDB. The major version of MongoDB associated with a Platform Release is fixed and cannot be changed.
While Commvault does not upgrade the MongoDB minor version packaged with a given Platform Release, we encourage our customers to use the following steps to upgrade their MongoDB minor version, for example, from v6.0.2 to v6.0.16.
You can use this article to manually upgrade to a newer minor version of MongoDB (for example, MongoDB 4.2.2 to MongoDB 4.2.3). You cannot manually upgrade to a newer major version of MongoDB (for example, MongoDB 4.0 to MongoDB 4.2)
For a list of minor versions in each supported MongoDB major version, go to MongoDB Release Notes on the MongoDB website.
Important: Each Commvault release supports a specific MongoDB release. To ensure compatibility, do not upgrade your MongoDB instance to a version that Commvault does not support. Before beginning an upgrade, carefully read all the steps in this article. If you encounter a problem, contact Commvault Customer Support.
Upgrading the minor MongoDB version from version A.B.X to version A.B.Y (where Y > X)
Navigate to the Commvault installation folder that contains the current MongoDB binaries. They are in the following location:
<commvault_installation_directory>\MongoDB\Server\Latest\bin
Verify the current MongoDB version by starting mongo/mongosh, and then execute the command: db.version();
If the current minor version is lower than the target minor version, you can use the following steps to get the latest minor version.
Under Community Server, click Select Package.
The window displays the version selection information.
From the Version list, select the correct version, and from the Platform list, select the correct platform type.
From the Package list, make sure you download the raw binaries instead of the installer. For Windows, choose zip, and for Linux, choose tgz.
Click Download to download and save the binaries to your file system.
Open the Commvault Process Manager and shut down Commvault MongoDB(InstanceXYZ).
Navigate to the Commvault installation folder that contains the current (older) MongoDB binaries. They are in the following location:
<commvault_installation_directory>\MongoDB\Server\Latest\bin
Make a backup copy of the contents of the bin directory.
Replace the existing binaries with the new binaries that you just downloaded.
Open the Commvault Process Manager, and then start the Commvault MongoDB(InstanceXYZ) process.
Verify that MongoDB is running the new correct version by using the instructions in steps 1 and 2.
