Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents
maxLevel2
minLevel2

Which MongoDB version should be used?

As of 2018 we recommend version 3.4 of MongoDB, and the WiredTiger storage engine.

...

Please see our Product Compatibility page for details regarding what product releases work (best) with which MongoDB versions.

Installation

The installer in our recent product releases offers to install version 3.4 of MongoDB for you if none is present on your server, and no manual configuration should be required.

Upgrades

If you do already have MongoDB 3.x on your system, then the installer (for opmantek application releases after Jan 2018) will offer to upgrade MongoDB to version 3.4 for you.

...

Besides these caveats we've not encountered any major problems with upgrades in our lab tests (tested on CentOS/RedHat 6, Debian 7, Ubuntu 14).

Configuring MongoDB Authentication/Authorization with the setup_mongodb.pl Script

All Opmantek applications that require MongoDB ship with a configuration tool for MongoDB, named bin/setup_mongodb.pl. It's recommended that you use this tool for setting up MongoDB authentication, as it can deal with separate per-product MongoDB instances and simplifies the procedure substantially. The relevant product installers already offer to run the tool during installation and upgrades, hence you rarely need to run it manually.

...

If required the tool will prompt you for database credentials and advise on remote-vs-local operation, as well as authenticated-vs-nonauthenticated modes. The MongoDB setup helper can be run repeatedly with no adverse effects.

Resetting Databases

...

with the setup_mongodb.pl Script

Should you want to reset one or more product databases to their initial empty state, you will need version 2.54 (or newer) of setup_mongodb.pl. With that version you may pass the extra arguments "drop=<dbname1>,<dbname2> confirm=YES", and setup_mongodb will completely empty the named databases. Please note that this is an irrevocable  operation and may lead to substantial data loss if you pick the wrong database to drop!

...

Please note that the database named by the key db_name (default name: "nmis") is shared and used by multiple products and therefore dropping this database would affect multiple products!

Historic Installation Instructions

As of September 2015 the installation instructions below are no longer applicable; the installer will take care of installation and initial configuration of MongoDB for you.

...