Frequently Asked Question

MongoDB upgrade
Last Updated 6 months ago

Symptom

  • MongoDB is a separate software optionally used with N4V.
  • The version of MongoDB installed with N4V may vary depending on the N4V version you installed the first time (full installation).
  • Following the procedure below, you will be able to upgrade the MongoDB instance on your N4V server.

Environment

  • Windows Server
  • Need4Viz : all versions

MongoDB Versions

The MongoDB version installed with the Full setup of N4V depends on the N4V version.

The end of life (EOL) of the MongoDB versions is described here : https://www.mongodb.com/legal/support-policy/lifecycles

  • N4V version
  • N4V version 2023.0.1 -> 2024.3.0 = MongoDB version 4.4.19 (End of life : 02/2024)
  • N4V version >= 2024.3.0 = MongoDB version 7.0.15 (End of life : 08/2026)

MongoDB upgrade principle

You can safely upgrade your MongoDB instance used with N4V following the below procedure.

To avoid any issues during the upgrade, please, respect exactly all the steps of the procedure.

For MongoDB upgrade, you cannot upgrade from any version to another one. You MUST pass through different intermediate upgrades. The complete procedure (all intermediate upgrades) is very fast but all the indicated tasks must be done.

Intermediate upgrades necessary : 4.2 -> 4.4 -> 5.0 -> 6.0 -> 7.0

MongoDB version used

To know which version of MongoDB is used on your N4V server :

  1. Open a CMD window on your N4V server
  2. Goto the \Need4Viz\MongoDB\Server\4.2\bin folder
  3. Run the "mongod --version" command
  4. Retrieve the MongoDB version 
image

MongoDB upgrade from 4.2 to 4.4

This step is mandatory to upgrade from 4.2 to newer version of MongoDB (4.4, 5.0, 6.0, 7.0)

The end of life (EOL) of 4.2 version is April 2023. 

The end of life (EOL) of 4.4 version is February 2024.

Platform Support of MongoDB 4.4 version :

  • Windows Server 2019
  • Windows Server 2016
  • Windows 2012 server is not supported

Upgrade process to MongoDB 4.4 :

  1. Download the Need4Viz_setup_Update_MongoDB_4.4.exe setup from the Download page of our Support site
  2. Launch the upgrade setup of all Need4Viz server (where MongoDB is installed)
  3. The setup should stop MongoDB and N4V on the server, upgrade MongoDB then restart automatically MongoDB and N4V.
  4. Goto \Need4Viz\MongoDB\Server\4.2\bin folder and run "mongosh" (the default connection string should be OK -> mongodb://localhost) : image
  5. Check the MongoDB version is 4.4.19
  6. Run the command : db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )
  7. If the version shown is '4.2', run the command : db.adminCommand( { setFeatureCompatibilityVersion: '4.4' } )
  8. Open a Webi report and update a N4V component to check everything is working well

Once these steps are done, you have successfully updated your MongoDB instance from 4.2 to 4.4 version. You can now go to the next step to continue your update (to version 5.0)

MongoDB upgrade from 4.4 to 5.0

This step is mandatory to upgrade from 4.4 to newer version of MongoDB (5.0, 6.0, 7.0)

The end of life (EOL) of 5.0 version is October 2024.

Platform Support of MongoDB 5.0 version :

  • Windows Server 2019
  • Windows Server 2016

Upgrade process to MongoDB 5.0 :

  1. Download the Need4Viz_setup_Update_MongoDB_5.0.exe setup from the Download page of our Support site
  2. Launch the upgrade setup of all Need4Viz server (where MongoDB is installed)
  3. The setup should stop MongoDB and N4V on the server, upgrade MongoDB then restart automatically MongoDB and N4V.
  4. Goto \Need4Viz\MongoDB\Server\4.2\bin folder and run "mongosh" (the default connection string should be OK -> mongodb://localhost) : image
  5. Check the MongoDB version is 5.0.28
  6. Run the command : db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )
  7. If the version shown is '4.4', run the command : db.adminCommand( { setFeatureCompatibilityVersion: '5.0' } )
  8. Open a Webi report and update a N4V component to check everything is working well

Once these steps are done, you have successfully updated your MongoDB instance from 4.4 to 5.0 version. You can now go to the next step to continue your update (to version 6.0)

MongoDB upgrade from 5.0 to 6.0

This step is mandatory to upgrade from 5.0 to newer version of MongoDB (6.0, 7.0)

The end of life of 6.0 version is July 2025.

Platform Support of MongoDB 6.0 version :

  • Windows Server 2019
  • Windows Server 2016

Upgrade process to MongoDB 6.0 :

  1. Download the Need4Viz_setup_Update_MongoDB_6.0.exe setup from the Download page of our Support site
  2. Launch the upgrade setup of all Need4Viz server (where MongoDB is installed)
  3. The setup should stop MongoDB and N4V on the server, upgrade MongoDB then restart automatically MongoDB and N4V.
  4. Goto \Need4Viz\MongoDB\Server\4.2\bin folder and run "mongosh" (the default connection string should be OK -> mongodb://localhost) : image
  5. Check the MongoDB version is 6.0.16
  6. Run the command : db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )
  7. If the version shown is '5.0', run the command : db.adminCommand( { setFeatureCompatibilityVersion: '6.0' } )
  8. Open a Webi report and update a N4V component to check everything is working well

Once these steps are done, you have successfully updated your MongoDB instance from 5.0 to 6.0 version. You can now go to the next step to continue your update (to version 7.0)

MongoDB upgrade from 6.0 to 7.0

This step is mandatory to upgrade from 6.0 to newer version of MongoDB (7.0)

The end of life (EOL) of 7.0 version is August 2026.

Platform Support of MongoDB 7.0 version :

  • Windows Server 2022
  • Windows Server 2019

Upgrade process to MongoDB 7.0 :

  1. Open the \Need4Viz\MongoDB\Server\4.2\bin\mongod.cfg file. Delete the journal.enabled parameter:
  2.  image => image
  3. Save the mongod.cfg file
  4. Download the Need4Viz_setup_Update_MongoDB_7.0.exe setup from the Download page of our Support site
  5. Launch the upgrade setup of all Need4Viz server (where MongoDB is installed)
  6. The setup should stop MongoDB and N4V on the server, upgrade MongoDB then restart automatically MongoDB and N4V.
  7. Goto \Need4Viz\MongoDB\Server\4.2\bin folder and run "mongosh" (the default connection string should be OK -> mongodb://localhost) : image
  8. Check the MongoDB version is 7.0.15
  9. Run the command : db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )
  10. If the version shown is '6.0', run the command : db.adminCommand( { setFeatureCompatibilityVersion: '7.0' } )
  11. Open a Webi report and update a N4V component to check everything is working well

Once these steps are done, you have successfully updated your MongoDB instance from 6.0 to 7.0 version.


Please Wait!

Please wait... it will take a second!