Page Comparison

...

MongoDB is a free and open-source big-data document database that stores data in flexible, JSON-like documents. Opmantek FirstWave chose MongoDB as our back-end database because it is fast and reliable, all with relatively low overhead.

Which MongoDB version should be used?

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

It is possible to continue to use MongoDB 2.6 for certain products, but the 3.x versions bring in a number of important performance improvements and some products strictly require these capabilities. MongoDB 3.6 is not supported by our applications at this time. Version 2.4 is no longer supported.

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

Installing MongoDB

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

Upgrading MongoDB

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.

If you have MongoDB 2.x, then you will have to upgrade manually; we HIGHLY RECOMMEND that you follow the official documentation for MongoDB upgrades

(for upgrades to 3.0,  for upgrades to 3.2 and finally for upgrades to 3.4)  - the two most critical aspects are

• that you cannot skip major versions for  upgrades (i.e. from 2.4 you must upgrade to 2.6 first, then to 3.0, then to 3.2 and finally to 3.4) ,
• and that you must upgrade the MongoDB authorization scheme before 3.0 will work, as documented on this page.

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).Step by step procedures for upgrading MongoDB from 3.4 to 4.2 are available Upgrading to MongoDB 4.2

Step by step procedures for upgrading MongoDB from 4.2 to 6.0 are available Upgrading to MongoDB 6.0

Configuring MongoDB Authentication/Authorization with the setup_mongodb.pl Script

All Opmantek FirstWave 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.

See how authentication is enabled in this mongod.conf on the NMIS9 VM that we ship.
See 'security:' >>' authorization: enabled':

net:
  bindIp: 127.0.0.1
  port: 27017
processManagement:
  fork: true
  pidFilePath: /var/run/mongodb/mongod.pid
security:
  authorization: enabled
storage:
  dbPath: /data/mongo
  journal:
    enabled: true
  wiredTiger:
    engineConfig:
      cacheSizeGB: 1.7
systemLog:
  destination: file
  logAppend: true
  logRotate: reopen
  path: /var/log/mongodb/mongod.log 

See paragraph Setting cacheSizeGB appropriately when MongoDB table type is wiredtiger (the default)
in this wiki page:
Reducing a Server's Memory Footprint when OMK applications are installed
for the calculation we use to calculate 'cacheSizeGB: 1.7' in the above mongod.conf file.

Resetting Databases with the setup_mongodb.pl Script

...

apt-get install mongodb-clients mongodb-server

apt-get install mongodb-clients mongodb-server

curl http://fastdl.mongodb.org/linux/mongodb-linux-x86_64-2.2.3.tgz -o mongodb-linux-x86_64-2.2.3.tgz
tar xvf mongodb-linux-x86_64-2.2.3.tgz
mv mongodb-linux-x86_64-2.2.3 /usr/local/
cd /usr/local/
ln -s mongodb-linux-x86_64-2.2.3 mongodb
ln -s mongodb/bin/mongo bin/mongo 

vi /usr/local/omk/install/mongod.init.d

### you will see 
### two suggestions provided

mongodbpath=/var/mongodb
## mongodbpath=/data/mongodb   

# as root
cp /usr/local/omk/install/mongod.init.d /etc/init.d/mongod
chkconfig mongod on
service mongod start

#use su or sudo to become root
service mongodb restart
# or /etc/init.d/mongodb restart
# or invoke-rc.d mongodb restart

mongo 

use admin;
db.addUser("opUserRW","op42flow42");
db.auth("opUserRW","op42flow42"); 

use nmis;
db.addUser("opUserRW","op42flow42");
db.auth("opUserRW","op42flow42"); 
   

'database' => {
 'db_server' => 'localhost',
 'db_port' => '27017',
 'db_name' => 'nmis',
 'db_username' => 'opUserRW',
 'db_password' => 'op42flow42'
 },

# to disable authentication
 'db_username' => '', 

...