Install » History » Version 144

Version 143 (Rogers, Chris, 04 October 2012 09:28) → Version 144/204 (Rogers, Chris, 04 October 2012 09:29)


h1. Introduction

This page will take you through getting the prerequisites of installing MAUS and ensuring that it's working.

If you have issue, please file a new support ticket by clicking "new issue" above. Below are some common known problems:

* Do not have whitespace in your path. Various *DO NOT HAVE WHITESPACE IN DIRECTORY NAME: various third_party packages will break. This is beyond the scope of MAUS. See issue #306.
* If you are at RAL you will need to setup the RAL proxy. Please

*RAL-ONLY NOTE: please
run +export (or equivalent) to setup the RAL proxy*

h1. Supported Distributions

We support recent versions of
* Scientific Linux

Other Linux distributions are supported on a "best effort" basis.

h1. Prerequisites

_Most installation problems are a result of people not reading this section_

You will need a few GBs of free space on your harddrive for Geant4 and ROOT (which will be installed along with MAUS).

h2. Scientific Linux/Redhat/Fedora/Centos

To install the tools required to build software on Scientific Linux, you must run the following commands:

sudo yum groupinstall "Development Tools"
sudo yum groupinstall "Development Libraries"
sudo yum install wget libX11-devel libXft-devel libXext-devel libXpm-devel libX11-devel libpng-devel tcl-devel tkinter

where the *sudo* command means that this is run as the root superuser. If you do not have this access, you must ask your system manager.

> *Scientific Linux 4.8 only*. Please also run:
> <pre>sudo yum install xorg-x11-devel</pre>

> *Optional - for Geant4.9.5.p01*. Please also run:
> <pre>sudo yum install cmake</pre>

h2. Debian or Ubuntu

To install the tools required to build software on Debian-based systems, you must run the following commands:

sudo apt-get install build-essential xorg-dev automake autoconf libtool scons zlibc libssl-dev libblas-dev liblapack-dev libpng-dev

where the *sudo* command means that this is run as the root superuser. If you do not have this access, you must ask your system manager.

> *Optional - for Geant4.9.5.p01*. Please also run:
> <pre>sudo yum install cmake</pre>

> _*RAL ONLY*. For RAL people, you need to create a file called /etc/apt/apt.conf and fill it with:_
> <pre>
http::proxy "";

h2. OpenSUSE

To install the required tools, you must run the following command:

sudo zypper install -t pattern devel_C_C++

where the *sudo* command means that this is run as the root superuser. If you do not have this access, you must ask your system manager.

h2. Other distribution

Please try using "google": to find out how to do it for your specific architecture. If you succeed, then please post those instruction here and continue with these instructions. If you fail, please email the user mailing list (

h1. Getting the code

There are three options for obtaining code.

h2. Using a packaged tarball

Just get the "latest release": or choose a version from the "release page": and click on the Source Code tarball link. You may wish to check that the download was okay, for instance by doing
md5sum -c maus.tar.gz.md5

where @maus.tar.gz.md5@ can be found either by following the _md5_ link or, for the latest release, clicking "here": Then extract the code by doing
tar xvfz maus.tar.gz
You should now have a directory called 'maus'.

h2. Bazaar repository (recommended for developers)

The following command checks out the current source tree for MAUS that is under development. This code branch contains the biweekly stable release.

Bazaar (bzr) is the program we use to maintain the repository. There is a MAUS-specific tutorial of using bzr [[Bzr_usage|here]]. Please "branch": MAUS. The code is hosted on "launchpad": under the "MAUS project": To get the code, you must then run:

bzr branch lp:maus

and you should now have a directory called 'maus'. If you get a 'command not found', you must [[InstallingBzr|install bazaar]]. If you run into connectivity issues, you can check the bazaar server status "here":

*If you want to publish results based on MAUS, please use a release version of the code*.

h1. Dependencies and building MAUS

MAUS will try to help you by installing all of its dependencies for you.

*Be careful about using symbolic links to move to this directory prior to installation, as this may confuse the build system. Always try to follow an absolute path instead.*

You can now run the following command to build all your dependencies, build MAUS, and run the tests for you (*this takes about 1 hour for most machines, and 3 hours for VMs!*):

cd maus

The build output is automatically stored in a log file like @./install_log_std@. Some of the tests check that errors are handled correctly, so we expect some error messages. The tests should end with a line like:

Ran 79 tests in 251.375s

OK (SKIP=20)

Sometimes the test script may skip some tests because a certain library was not available. A test failure looks like

Ran 79 tests in 251.375s

FAILED (errors=1, failures=1)

If you run into issues, please send the output of:

bash run_tests.bash

to us through an issue by clicking 'New Issue' above.

If you are installing multiple copies of maus on the same machine, it is possible to set them to all use the same set of third party libraries, cutting down the installation time to approximately 10 minutes for each extra installation. After setting up the first installation as above, use same command as before but add an argument specifying the root directory of the first maus installation:

./install_build_test.bash /path/to/original/maus

NB: Make sure that you only do this for installations that use the _same version_ of the third party libraries.

You are now ready to run MAUS!

h3. Troubleshooting

If you aren't sure, a sample @install_log_std@ can be found "here":

* *I get an error about Python versions when I run ./configure*: this is normal - you need to install third party libraries (including python 2.7) by doing <pre>bash ${MAUS_ROOT_DIR}/third_party/build_all.bash</pre>
* *I get errors in the test output*: this is normal - if the tests finish with a line like *OK*, then the tests passed. If the tests finish with a line like *FAILED (errors=1, failures=1)* (or worse a segmentation fault), then the tests failed. Some of the tests are actually checking that errors are produced on bad input.
* *I am at RAL and I get an error like* _-bash: nosetests: command not found_ - before you run the build, you need to setup the proxy. Make sure to do <pre>export</pre> before you build.
* *MAUS does not import* - are you using a symbolic link? See #770

h1. Other useful libraries/applications

MAUS doesn't require these libraries to build or run, but they may provide useful functionality for documentation, installation, etc

h2. Documentation

To build the documentation, you will need

* *doxygen* automatic code documentation tool "website"
* *latex* typesetting tool "website"
* *latex2html* for making html documents "website":
* *graphviz* (dot) for making class layouts, etc "website": "documentation":

h2. Other Stuff

* *lcov* C++ code coverage tool (activated by maus_lcov environment variable)
* *bzr* for accessing the repository. As easy as
easy_install bzr</pre>
In ubuntu you may also need to do
sudo apt-get install libbz2-dev
which apparently doesn't come by default.