You need to have Python 2.7.x installed in order to use mtools. Other versions of Python are not currently supported.
To check your Python version, run python --version on the command line.
The easiest way to install mtools is via pip. From the command line, run:
pip install mtools
You need to have pip installed for this to work. If you don't have pip installed yet,
try sudo easy_install pip from the command line first, or follow the instructions provided on the
pip installation page.
Depending on your user rights, pip may complain about not having permissions to install into the system directory.
In that case, you either need to add sudo in front of the pip command to install into a system directory, or append --user to install into your home directory.
Note that some mtools scripts have additional dependencies as listed below.
If pip is not available and you want to install mtools from source, you can get the source code
by cloning the mtools github repository:
git clone git://github.com/rueckstiess/mtools.git
Or download the tarball from https://pypi.python.org/pypi/mtools and extract it with:
tar xzvf mtools-<version>.tar.gz
Then cd into the mtools directory and run:
sudo python setup.py install
This will install mtools into your Python's site-packages folder, create links to the scripts and set everything up. You should now be able to use all the scripts directly from the command line.
If you want to contribute to mtools development or test beta and release candidate versions, you should install mtools from a source checkout in "Development Mode" using either of:
pip(recommended as a convenience for installing additional dependencies)
sudo pip install -e'/path/to/cloned/repo[all]'
setup.py
sudo python setup.py develop
More information about switching to Development Mode can be found on the page mtools Development Mode.
To install all additional dependencies for full feature support, run:
pip install mtools[all]
To install dependencies for a subset of mtools utilities, specify one or more script names as a comma-separated list:
pip install mtools[mlaunch,mloginfo]
required for mlaunch
mlaunch uses psutil to manage starting, stopping, and finding MongoDB processes.
required for mlaunch
pymongo is MongoDB's official Python driver. mlaunch uses this to configure and query local MongoDB deployments.
required for mplotqueries
matplotlib is a python 2D plotting library which produces figures and graphs in a variety of formats and interactive environments across platforms.
required for matplotlib (in mplotqueries)
NumPy is a Python module for scientific computing and numerical calculations.
The full list of requirements (some of which are already included in the Python standard library) can be found in the requirements.txt file.