Manually Upgrading MongoDB Versions

Article ID: 54441

Article Type: Technical Reference

Last Modified:

Commvault uses MongoDB for some functionality. When a new version of Commvault is released, the most recent version of MongoDB is used. However, when a previously released version of Commvault is updated, the version of MongoDB that the existing version of Commvault uses is not updated.

Using this article, you can manually upgrade a minor version of MongoDB (for example, MongoDB 4.2.2 to MongoDB 4.2.3). You cannot manually upgrade to a new 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, see MongoDB Release Notes.

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 from MongoDB 3.0.x to 4.0.4 (for Service Pack 14 to Service Pack 18)

Note: We do not support MongoDB 4.0 version on Service Pack 13 and earlier releases. Do not upgrade to MongoDB 4.0 on these service packs. If the Commvault software is installed with Service Pack 14, 15, 16, 17 or 18, and the MongoDB instance is at MongoDB 3.0.x, use the Software Store utility to manually upgrade to **MongoDB **4.0.4.

  1. Verify that the MongoDB version is currently at **MongoDB **3.0.x.
    1. Open the command prompt in the administrator mode, and go to the folder that contains the MongoDB executable. You can obtain the path information from the "Path to executable" field under Windows service properties for the Commvault MongoDb(InstanceXXX) instance.
    2. Start the MongoDB client console and then enter the following command: db.version();
    3. Verify that the output version is **MongoDB **3.0.x.
  2. Open Windows Service Manager [services.msc], and then shut down the Commvault MongoDB service Commvault MongoDB(InstanceXXX).
  3. Download and execute the MONGO_UPGRADE.exe utility from the Commvault Store. This utility upgrades your MongoDB instance to MongoDB 4.0.4. The upgrade process should take about 2 minutes. Note: If MongoDB is not installed on the default instance (Instance001), you can pass the instance number by using the parameter -Instance InstanceXXX to the utility.
  4. After the utility has successfully completed, open the Windows services manager and verify that the service Commvault MongoDB(InstanceXXX) is already running.
  5. To verify the installation, open the InstallMongoDB.log file from the Log Files folder, and then verify that MongoDB is running with version **MongoDB **4.0.4.

Upgrading minor versions for MongoDB 4.0 and higher major versions (for example, 4.2 and 6.0)

  1. Verify the current version of MongoDB by starting the MongoDB client (mongo.exe/mongo) from the mongodb binary location and then executing the following command: db.version();
  2. Open Commvault Process Manager and then shut down the MongoDB service Commvault MongoDB(InstanceXXX).
  3. Download the target MongoDB binaries from the MongoDB website (
  4. Go to the MongoDB installation directory that contains the current MongoDB binaries : <commvault_installation_directory>\MongoDB\Server\Latest\bin
  5. Make a backup copy of the contents of the bin folder.
  6. Replace the existing binaries with the binaries that you just downloaded.
  7. Open Commvault Process Manager and then start the Commvault MongoDB service Commvault MongoDB(InstanceXXX) that you shut down in Step 2, above.
  8. To verify that MongoDB is running the target minor version, start the MongoDB client and then enter the following command: db.version();
1 Commvault Way, Tinton Falls, NJ 07724 Sitemap | Legal Notices | Trademarks | Privacy Policy
Copyright © 2022 Commvault | All Rights Reserved.