Article ID: 63440
Article Type: Troubleshooting
Last Modified:
You can perform a health check on a client that has MongoDB installed by using the Client Readiness Check or the Dashboard Health Report. When you run the health check it may result in displaying errors that you can resolve using the information in this article.
Note: You can only perform a health check on a MongoDB database installed as part of the Commvault software package. Do not use it on a MongoDB database that is backed up using the MongoDB agent.
When performing the health check on a client that has the MongoDB installed, you might see one of the following errors:
- 587207202 - MongoDB Authentication issue
- 587207203 - MongoDB Connection timeout
- 587207204 - MongoDB Connection failure
- 587207205 - MongoDB Configuration issue
- 587203847 - Other issues
See the Resolution section of this article for the list of error codes and causes.
| Error code | Summary | Cause | Resolution |
|---|---|---|---|
| 587207202 | MongoDB Authentication Exception | o MongoDB credentials stored in the CommServe database are incorrect. o Another CommServe database is staged on the existing CommServe instance. o A CommServe failover/live sync operation failed to migrate MongoDB credentials. o A CommServe hardware refresh operation failed to refresh MongoDB credentials. |
Run the MongoDB Repair Tool by running the Commvault installer and then selecting the "Repair" option. |
| 587207203 | MongoDB unresponsive/unreachable | o Either MongoDB is not running or is inaccessible over the network. o The cvmongod.cfg file contains incorrect bindIP or port values. o The cvmongod.cfg file or mongodb binaries are missing or out-of-sync. o The cvmongod.cfg binaries contain incorrect values. |
o Verify MongoDB is up and running and that *webserver* connections to MongoDB are not blocked by a firewall. o For network issues, you can consider configuring a network gateway between the Webserver and the default MongoDB instance. |
| 587207204 | MongoDB Connection Exception | Either MongoDB is not running or is inaccessible over the network. | Verify MongoDB is up and running |
| 587207205 | MongoDB Config Exception | The cvmongod.cfg file contains incorrect configuration values for the MongoDB instance. | Run the MongoDB Repair Tool by running the Commvault installer and then selecting the "Repair" option. |
| 587203847 | Generic Exception | This indicates an exception that is not covered by other error codes, and requires looking at the MongoDB logs for investigation. | Check the MongoDB log cvmongod.log in the Commvault log file folder. |
For information about how to set up MongoDB with the Commvault software, see MongoDB Utility – Frequently Asked Questions.