NOTE: All Linux commands in this document are run at root level: you need access to root via su or sudo -i
...
- Prerequisites
- Upgrade Preparation
- Upgrade from MongoDB 4.2 to MongoDB 4.4
- Upgrade from MongoDB 4.4 to MongoDB 5.0
- Upgrade from MongoDB 5.0 to MongoDB 6.0
- Services Restart
- Clean-up
Table of Contents
...
...
...
...
...
...
Prerequisites for Upgrading MongoDB 4.2 to MongoDB 6.0
...
To determine the version of Linux running on your system use the following command in a terminal session:
An example output of this command
Release: 11
Codename: bullseye
|
MongoDB 4.2 Installed and Running
...
This command does not do anything however, the output will show us the running shell and server that is running.
mongo -u <username> -p <password> --authenticationDatabase=admin --eval 'quit()' | grep MongoDB
|
Result will look like below, we are looking for the two version numbers to be 4.2.x
If the versions do not match there may be an issue with your running installation and you should not proceed until this is resolved.
MongoDB shell version v4.2.25
MongoDB server version: 4.2.25
|
MongoDB Storage Engine
Verify storage engine by running
mongo -u <username> -p <password> --authenticationDatabase=admin --quiet --eval 'db.serverStatus().storageEngine'
|
The "name" line should have "wiredTiger" in order to proceed.
{
"name" : "wiredTiger",
"supportsCommittedReads" : true,
"readOnly" : false,
"persistent" : true
}
|
If this mongo cli command does not work you can try the following to determine the storage engine in use
grep -i "active storage" /var/log/mongodb/mongod.log*
|
Example correct log output - notice the log entry declares the storage engine to be using "wiredTiger"
2024-06-19T06:45:27.632+0000 I STORAGE [initandlisten] Detected data files in /var/lib/mongodb created by the 'wiredTiger' storage engine, so setting the active storage engine to 'wiredTiger'.
|
If the system is not using wiredTiger the data migration process should follow a different process. Refer to the following link.
...
An example of the update/upgrade cycle is as follows:
apt-get update && apt-get upgrade -y
|
This command will execute all outstanding upgrades. Check for any errors and address as required.
...
The following commands are used to complete this task
/usr/local/omk/bin/checkomkdaemons.sh stop
systemctl stop nmis9d
# confirm that the daemons have stopped
/usr/local/omk/bin/checkomkdaemons.sh status
systemctl status nmis9d
|
Example Command and Output
user@servername:~/installers
● nmis9d.service - FirstWave NMIS9 Daemon
Loaded: loaded (/etc/systemd/system/nmis9d.service; enabled; vendor preset: enabled)
Active: inactive (dead) since Thu 2024-06-27 17:32:05 AEST; 26s ago
Process: 252049 ExecStartPre=/bin/sh -c sleep 3 (code=exited, status=0/SUCCESS)
Process: 252058 ExecStart=/usr/local/nmis9/bin/nmisd (code=exited, status=0/SUCCESS)
Main PID: 252105 (code=exited, status=0/SUCCESS)
CPU: 1h 23.745s
Jun 27 17:32:04 m6poller1 systemd[1]: Stopping FirstWave NMIS9 Daemon...
Jun 27 17:32:05 m6poller1 systemd[1]: nmis9d.service: Succeeded.
Jun 27 17:32:05 m6poller1 systemd[1]: Stopped FirstWave NMIS9 Daemon.
Jun 27 17:32:05 m6poller1 systemd[1]: nmis9d.service: Consumed 1h 23.745s CPU time.
|
Upgrade from MongoDB 4.2 to MongoDB 4.4
...
Check the database compatibility mode is set to "4.2"
mongo -u $YOUR_USERNAME -p $YOUR_PASSWORD --authenticationDatabase=admin --quiet --eval 'db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )'
|
The result should be as follows ensuring that the value 4.2 is set
{ "featureCompatibilityVersion" : "4.2", "ok" : 1 }
|
If MongoDB is on version 4.2 and the featureCompatibilityVersion is not "4.2" then set this with the following command
mongo -u $YOUR_USERNAME -p $YOUR_PASSWORD --authenticationDatabase=admin --quiet --eval 'db.adminCommand( { setFeatureCompatibilityVersion: "4.2" } )';
|
As before, the check the featureCompatibilityVersion again confirming the correct value
Example Command and Output
mongo -u $YOUR_USERNAME -p $YOUR_PASSWORD --authenticationDatabase=admin --quiet --eval 'db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )'
{ "featureCompatibilityVersion" : "4.2", "ok" : 1 }
|
Debian - Install MongoDB 4.4 Repo and Upgrade
...
Commands summarised here:
systemctl stop mongod
wget -qO - https://www.mongodb.org/static/pgp/server-4.4.asc | sudo apt-key add
echo "deb [ trusted=yes ] http://repo.mongodb.org/apt/debian buster/mongodb-org/4.4 main" | sudo tee /etc/apt/sources.list.d/mongodb-org-4.4.list
sudo apt-get update
sudo apt-get upgrade mongodb-org -y --allow-unauthenticated
mongod --version
systemctl stop mongod
systemctl start mongod
systemctl daemon-reload
systemctl is-active mongod
|
Complete the upgrade with the following commands and retest. If you skip the stop/start sequence above the following command will fail.
mongo -u $YOUR_USERNAME -p $YOUR_PASSWORD --authenticationDatabase=admin --quiet --eval 'db.adminCommand( { setFeatureCompatibilityVersion: "4.4" } )'
mongo -u $YOUR_USERNAME -p $YOUR_PASSWORD --authenticationDatabase=admin --quiet --eval 'db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )'
systemctl stop mongod
systemctl start mongod
|
Upgrade from MongoDB 4.4 to MongoDB 5.0
...
Check the database compatibility mode is set to "4.4"
mongo -u $YOUR_USERNAME -p $YOUR_PASSWORD --authenticationDatabase=admin --quiet --eval 'db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )'
|
The result should be as follows ensuring that the value 4.4 is set
{ "featureCompatibilityVersion" : "4.4", "ok" : 1 }
|
If MongoDB is on version 4.4 and the featureCompatibilityVersion is not "4.4" then set this with the following command
mongo -u $YOUR_USERNAME -p $YOUR_PASSWORD --authenticationDatabase=admin --quiet --eval 'db.adminCommand( { setFeatureCompatibilityVersion: "4.4" } )';
|
As before, the check the featureCompatibilityVersion again confirming the correct value
Example Command and Output
mongo -u $YOUR_USERNAME -p $YOUR_PASSWORD --authenticationDatabase=admin --quiet --eval 'db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )'
{ "featureCompatibilityVersion" : "4.4", "ok" : 1 }
|
Debian - Install MongoDB 5.0 Repo and Upgrade
...
Commands summarised here:
systemctl stop mongod
wget -qO - https://www.mongodb.org/static/pgp/server-5.0.asc | sudo gpg -o /usr/share/keyrings/mongodb-server-5.0.gpg --dearmor
echo "deb [ signed-by=/usr/share/keyrings/mongodb-server-5.0.gpg] http://repo.mongodb.org/apt/debian bullseye/mongodb-org/5.0 main" | sudo tee /etc/apt/sources.list.d/mongodb-org-5.0.list
sudo apt-get update
sudo apt-get upgrade -y mongodb-org
------------------------------------
If you get an error
Errors were encountered while processing:
/var/cache/apt/archives/mongodb-org-database-tools-extra_5.0.27_amd64.deb
Fix it by using: sudo dpkg -i --force-overwrite /var/cache/apt/archives/mongodb-org-database-tools-extra_5.0.27_amd64.deb
then sudo apt-get upgrade -y mongodb-org
and answer N to keep your currently installed version of /etc/mongod.conf -------------------------------------
systemctl stop mongod ; systemctl start mongod ; systemctl daemon-reload ; systemctl is-active mongod ; systemctl status mongod
|
Complete the upgrade with the following commands and retest. If you skip the stop/start sequence above the following command will fail.
mongo -u $YOUR_USERNAME -p $YOUR_PASSWORD --authenticationDatabase=admin --quiet --eval 'db.adminCommand( { setFeatureCompatibilityVersion: "5.0" } )'
mongo -u $YOUR_USERNAME -p $YOUR_PASSWORD --authenticationDatabase=admin --quiet --eval 'db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )'
systemctl stop mongod ; systemctl start mongod ; systemctl status mongod
|
As before, check the featureCompatibilityVersion output from above is "5.0"
Example Command and Output
mongo -u $YOUR_USERNAME -p $YOUR_PASSWORD --authenticationDatabase=admin --quiet --eval 'db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )'
{ "featureCompatibilityVersion" : "5.0", "ok" : 1 }
|
Upgrade from MongoDB 5.0 to MongoDB 6.0
...
Check the database compatibility mode is set to "5.0"
mongo -u $YOUR_USERNAME -p $YOUR_PASSWORD --authenticationDatabase=admin --quiet --eval 'db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )'
|
The result should be as follows ensuring that the value 5.0 is set
{ "featureCompatibilityVersion" : "5.0", "ok" : 1 }
|
If MongoDB is on version 5.0 and the featureCompatibilityVersion is not "5.0" then set this with the following command
mongo -u $YOUR_USERNAME -p $YOUR_PASSWORD --authenticationDatabase=admin --quiet --eval 'db.adminCommand( { setFeatureCompatibilityVersion: "5.0" } )';
|
As before, the check the featureCompatibilityVersion again confirming the correct value
Example Command and Output
mongo -u $YOUR_USERNAME -p $YOUR_PASSWORD --authenticationDatabase=admin --quiet --eval 'db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )'
{ "featureCompatibilityVersion" : "5.0", "ok" : 1 }
|
Debian - Install MongoDB 6.0 Repo and Upgrade
...
Commands summarised here:
systemctl stop mongod
wget -qO - https://www.mongodb.org/static/pgp/server-6.0.asc | sudo gpg -o /usr/share/keyrings/mongodb-server-6.0.gpg --dearmor
echo "deb [ signed-by=/usr/share/keyrings/mongodb-server-6.0.gpg] http://repo.mongodb.org/apt/debian bullseye/mongodb-org/6.0 main" | sudo tee /etc/apt/sources.list.d/mongodb-org-6.0.list
sudo apt-get update
sudo apt-get upgrade -y mongodb-org
and answer N to keep your currently installed version of /etc/mongod.conf
systemctl stop mongod ; systemctl start mongod ; systemctl daemon-reload ; systemctl is-active mongod ; systemctl status mongod
|
Complete the upgrade with the following commands and retest. If you skip the stop/start sequence above the following command will fail.
Note that you must now use the mongosh command instead of mongo
mongosh -u $YOUR_USERNAME -p $YOUR_PASSWORD --authenticationDatabase=admin --quiet --eval 'db.adminCommand( { setFeatureCompatibilityVersion: "6.0" } )'
mongosh -u $YOUR_USERNAME -p $YOUR_PASSWORD --authenticationDatabase=admin --quiet --eval 'db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )'
systemctl stop mongod
systemctl start mongod
|
As before, check the featureCompatibilityVersion output from above is "6.0"
Example Command and Output
mongo -u $YOUR_USERNAME -p $YOUR_PASSWORD --authenticationDatabase=admin --quiet --eval 'db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )'
{ "featureCompatibilityVersion" : "6.0", "ok" : 1 }
|
This completes the in-situ upgrade of MongoDB 4.2 to 6.0 Standalone
...
The following commands are used to complete this task
systemctl start nmis9d
/usr/local/omk/bin/checkomkdaemons.sh start
# confirm that the daemons have started
/usr/local/omk/bin/checkomkdaemons.sh status ; systemctl status nmis9d
|
You can now browse to your instance of NMIS:
...