This document addresses OpenMS users and explains the installation procedure for building OpenMS from its sources. If you only want to use the OpenMS Proteomics Pipeline (TOPP), you are strongly encouraged to download the binary installer (see here), instead of building OpenMS from sources. Be aware though that we do not provide binary installers for every linux distribution. For more information read the install instructions for the TOPP binaries.
This document especially considers the installation of several libraries which are required by OpenMS. Most of these libraries are made available in our "contrib-package" (see below).
If you encounter errors during configuring/compiling our software, have a look at our "Known Issues" section (documentation), maybe the error is already known. If not, please write to the mailing list.
Required applications
In order to compile OpenMS, several applications need to be installed:
If your OpenMS version is a development version from SVN, the following applications are needed in order to create the OpenMS documentation:
Here is a list of package names that might help you (might change with newer distributions).
Fedora | OpenSuse 11.1 | Ubuntu 8.10 and later | Debian (Lenny) |
cmake gcc, gcc-g++ autoconf, autoconf-2.6* qt-devel also look here | cmake gcc-g++ autoconf libqt4-devel | cmake g++ autoconf qt4-dev-tools patch libtool | cmake g++ autoconf qt4-dev-tools patch libtool make |
In order to facilitate the installation of the libraries required for OpenMS, we composed a "contrib-package" containing the libraries Boost, GSL, libSVM, SeqAn, glpk, zlib, libbz2 and Xerces-C.
The contrib package is contained in the OpenMS release package and is available under the path contrib in the OpenMS directory.
If you are using the developer version of OpenMS, you must check out the contrib from Sourceforge SVN repository
> svn co https://open-ms.svn.sourceforge.net/svnroot/open-ms/contrib
CMake is used to check the system and create the contrib libraries.
Go to the contrib directory and execute the following command:
> cmake .
If everything worked, the following sub-directories were created under contrib :
'lib/'
It contains the static libraries needed by OpenMS.
You need to get the OpenMS source package from our website. The latest stable version of OpenMS can be found in the download page. For further (e.g. latest developer version from SVN) info see the download instructions.
If you have not installed thei contrib libraries which OpenMS requires, please refer to the section Installing the contrib package above and install the contrib libraries.
CMake is used to check the system and create the main 'Makefile'.
Go to the OpenMS directory and execute the following command:
> cmake .
You can set CMake variables using the -D VARIABLE=VALUE
option. A full list of the CMake variables is shown when you execute
> ccmake .
This works only after having executing cmake .
.
The most important CMake variables are:
INSTALL_PREFIX | the path where the library is installed. For development, install prefixes are not supported. In this case OpenMS must be built in place! |
CMAKE_FIND_ROOT_PATH | Additional search path for the contrib libraries. If not set the the location is assumed to be <path_to_OpenMS>/contrib . |
QT_QMAKE_EXECUTABLE | Defines the Qt 'qmake' application. The corresponding Qt installation is used. |
CMAKE_BUILD_TYPE | Should be either 'Release' (optimization enabled) or 'Debug' (debug info and precondition/postcondiction checks enabled). The default is 'Release'. |
QT_DB_PLUGIN | Defines the Qt database type. By default MySQL is used. |
CMAKE_CXX_COMPILER | Defines the C++ compiler to use. |
After CMake was executed, you can list the make targets by calling:
> make targets
In order to build the OpenMS library and TOPP tools execute the following command:
> make
If you have chosen to use a install prefix via the INSTALL_PREFIX variable you should install the components using:
> make install
After you have installed OpenMS and TOPP, you should test your installation by executing the following command:
> make test_build > make test
OpenMS / TOPP release 1.9.0 | Documentation generated on Tue May 28 2013 12:41:58 using doxygen 1.8.3.1 |