| Table of Contents |
|---|
Installation
As of September 2015 we recommend version 3.0 of MongoDB. The installer in our most recent product releases offers to install that version of MongoDB for you if none is present on your server, and no manual configuration is required. You can definitely continue to use MongoDB 2.4 or 2.6, but 3.0 brings in a number of important performance improvements.
See our Product Compatibility page for details regarding what product releases work best with which MongoDB versions.
Upgrades
For upgrading an existing MongoDB installation we HIGHLY RECOMMEND that you follow the official documentation for MongoDB upgrades - the two most critical aspects are
- that you have to go from 2.4 to 2.6 and cannot go to 3.0 directly,
- and that you will have to 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).
We recommend using MongoDB 2.4. MongoDB 2.6 is currently not covered by our installation and configuration guides as it has a somewhat different authorization infrastructure. The setup instructions below may fail with late versions of MongoDB 2.6.
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.
Debian:
Debian 7.0 (aka Wheezy) ships with a much older version, which should work but very likely won't provide adequate performance. However, the mongodb packages in wheezy-backports are fine, as are the versions in Testing/Jessie and Unstable. First make sure that you have Backports or Testing/Unstable enabled, then use sudo or su to run the following command as root:
...
Download MongoDB from the Website at https://www.mongodb.org/downloads#previous (version 2.2.3 was latest at the time of writing this so the examples are using the 64-bit version of this release)downloads.
| Code Block |
|---|
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 |
...
Opmantek Setup for MongoDB
...
Configuring MongoDB Authentication with setup_mongodb.pl
Since opEvents versions 1.2.3 and opConfig 2.1.0 the relevant applications 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.
To use the tool manually, simply run it as root and follow the prompts (if any):
...
Manual MongoDB Authentication Configuration
Please note that these instructions are applicable only for MongoDB 2.4 and as such are of historic interest only.
Should using the setup_mongodb.pl helper not be an option for you, then you can still prime the database(s) manually for Opmantek use.
...