Complete Guide to Checking and Upgrading MongoDB Version on Ubuntu

Keywords: MongoDB | Ubuntu | version_check | software_update | apt-get

Abstract: This article provides a comprehensive guide to checking MongoDB versions on Ubuntu systems, covering multiple methods including the mongod --version command and db.version() function in mongo shell. It addresses the common issue where apt-get fails to update MongoDB and offers a complete solution for installing the latest MongoDB-10gen through official repositories. The article also compares different version checking approaches and their appropriate use cases.

Multiple Methods for Checking MongoDB Version

There are several approaches to check MongoDB version on Ubuntu systems, each with specific use cases and output information. Understanding these differences is crucial for beginners.

Using mongod Command for Version Check

The most direct method is using the mongod --version command. Executing this command in the terminal displays detailed version information of the MongoDB database server:

$ mongod --version
db version v1.2.2, pdfile version 4.5
Wed Oct 16 10:28:22 git version: nogitversion

This approach is suitable for quickly checking the currently installed MongoDB server version, particularly when you need to confirm system-level installation status.

Checking Version Through mongo Shell

Another method is through MongoDB's interactive shell. First start the mongo shell:

$ mongo

Then execute the db.version() command at the shell prompt:

> db.version()
1.2.2

This method not only displays the version number but also shows client and server version information upon connection:

MongoDB shell version v3.4.0-rc2
connecting to: mongodb://127.0.0.1:27017
MongoDB server version: 3.4.0-rc2

This is particularly useful for verifying whether client and server versions match.

Solving the apt-get MongoDB Update Issue

A common issue many Ubuntu users encounter is that MongoDB version doesn't update even after executing sudo apt-get update && sudo apt-get install mongodb. This typically occurs because Ubuntu's default repositories contain older MongoDB versions.

Problem Analysis

When users execute standard update commands, the system might display:

sudo apt-get install mongodb
Reading package lists... Done
Building dependency tree       
Reading state information... Done
mongodb is already the newest version.
0 upgraded, 0 newly installed, 0 to remove and 179 not upgraded.

This indicates the system believes the latest version is already installed, but in reality, the MongoDB version in Ubuntu's official repositories may be outdated.

Adding MongoDB Official Repository

To install the latest MongoDB version, you need to add MongoDB's official repository. Here's the complete installation process:

Import MongoDB Public Key: First, add MongoDB's GPG key to ensure package authenticity:
```
$ sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 7F0CEB10
```

Add Repository Source: Create MongoDB's software source list file:

$ echo 'deb http://downloads-distro.mongodb.org/repo/ubuntu-upstart dist 10gen' | sudo tee /etc/apt/sources.list.d/mongodb.list

Update Package List:
```
$ sudo apt-get update
```
Install MongoDB-10gen:
```
$ sudo apt-get install mongodb-10gen
```

Installing Specific Versions

If you need to install a specific MongoDB version, you can specify the version number in the installation command:

$ sudo apt-get install mongodb-10gen=2.4.6

Important Note: Replace 2.4.6 with the specific version number you need to install. The latest version numbers can be found on the MongoDB official website.

Preventing Accidental Upgrades

After installation, to prevent automatic upgrades to incompatible versions, you can set the package to "hold" status:

$ echo "mongodb-10gen hold" | sudo dpkg --set-selections

Starting MongoDB Service

After installation, start the MongoDB service:

$ sudo service mongodb start

Version Verification and Best Practices

After installation, use the mongod --version command to verify successful installation:

$ mongod --version
db version v2.4.6
Wed Oct 16 12:21:39.938 git version: b9925db5eac369d77a3a5f5d98a145eaaacd9673

Best Practices for Version Checking

Development Environment: Recommended to use db.version() in mongo shell for checking, as this verifies both client and server compatibility.
Production Environment: Use mongod --version command to check server version, ensuring consistency with documentation and application requirements.
Troubleshooting: When encountering connection issues, checking both client and server versions helps diagnose compatibility problems.

Conclusion

Managing MongoDB versions on Ubuntu systems requires understanding the appropriate scenarios for different checking methods and knowing how to properly configure software sources to obtain the latest versions. By adding MongoDB's official repository, users can bypass outdated versions in Ubuntu's default repositories and directly install and maintain the latest MongoDB releases. Regularly checking versions and maintaining updates are essential measures for ensuring database system security and stability.

Copyright Notice: All rights in this article are reserved by the operators of DevGex. Reasonable sharing and citation are welcome; any reproduction, excerpting, or re-publication without prior permission is prohibited.