Installation (old page)

Linux
Pre-compiled distribution come as two flavors: rpm (RedHat Package Manager) and deb (Debian) packages, for 32 and 64 bits architectures. You can download the packages individually from the repository (see ), or configure your system to automatically fetch them (debian only).

You can find several type of packages: The last category is equivalent to the .tar.gz distribution. The first one provides the dynamic libraries, and is for using program developed using Bio++ and compiled dynamically. The second category is for developing or compiling a program with Bio++. It provides the static libraries and header files. It depends on the packages of the first category.
 * Packages for compiled program use,
 * Packages for development and compilation of programs,
 * Source packages (rpm only).

RPM packages are then installed using the command and DEB packages using the command You will need root access to execute these commands. To install Bio++ locally, you have to install from sources.

MacOsX
DMG packages are available there (compiled with a MacIntel computer).

Installing Bio++ from source files: the automatic way
This uses an installation file written in bash. start by dowloading it at in a empty directory, and make it executable: The launch it On some systems (Sun for instance), you may need to type instead. The script will check you have all required tools in the right place, download the sources, unpack, configure, compile and install them!

Note: Be sure to have the write access for the installation directory you chosed! In some cases, you will have to run it as super-user.

Installing Bio++ from source files: the manual way
Installation from source files is possible under Linux-like systems (Linux, Unix, MacOS X, CygWin).

Current version using the Version System (Git)
Each library will come in a separate directory.
 * Get yourself into the directory where you want the project files to be.
 * Then retrieve the libraries you need:

Archives from the source distribution (targz)
Archives of Bio++ are distributed via a bundle of source file archives on its website,.


 * Download and copy the distribution (.tar.gz files) into a directory where you have writing rights,
 * Decompress each archive file with the command

Compiling and installing under Linux-like systems
From now, repeat the following steps for each library in the following order:
 * bpp-core
 * bpp-seq
 * bpp-phyl (optional)
 * bpp-popgen (optional)
 * bpp-raa (optional)

The libraries will be installed in /usr/local, a location which requires superuser access rights. An alternative option consists in installing in the user home, for example in a subdirectory called .local. The CMAKE_INSTALL_PREFIX variable specifies where the libraries should be installed. See Note 2 below.
 * to the source directory,
 * build the Makefile with cmake


 * Build the library:
 * Then install it:
 * You can also generate the API documentation by typing

Notes
 * When installing the other libraries, if you have several versions of the libraries on your system (for instance one in /usr/local/ in addition to your own in $HOME/.local, you can tell cmake which version to link to by running


 * If you install lour libraries in a non standard directory, you should tell where the dynamic libraries are. For example, with bash shell, you can add in your .bashrc:

so that new libraries are installed without any compilation of the test programs.
 * If you are updating a library and encounter compatibility problems for test programs, you should add the option -DBUILD_TESTING=OFF


 * Usage of a debugger is possible if the option -DCMAKE_BUILD_TYPE=Debug</tt> is added to the cmake command line.


 * On some 64bits systems, 64-bits libraries have to be installed in lib64 instead of lib. This can be achieved by passing the -DLIB_SUFFIX=64</tt> option to cmake.