[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

3. Compilation and Installation

If you will be using Angora on a 64-bit x86 architecture with the GNU/Linux operating system, you can simply download the binary version (both non-parallel and OpenMPI-based parallel versions available) from the Angora website and start running simulations right away.

If there is no precompiled Angora binary available for your system, you will have to compile it from source. You will require the the following libraries on your system to compile Angora: blitz++, libconfig, hdf5, and boost. If possible, use the package manager for your specific GNU/Linux distribution (such as Synaptic in Ubuntu) to install the libraries directly from the package repository. Most major distributions provide these libraries in their package repositories. If you do not have root access to your system, you can install these libraries in your home directory. The installation instructions for the libraries usually provide detailed information on how to do this. For local installation, the usual trick is to set the installation path by specifying the prefix variable in the Makefiles. This is done either by using the ‘--prefix=local-path’ option when calling the package’s configure script, or customizing make at the final stage with the ‘prefix=local-path’ command option.

Once the dependency libraries are installed, the Angora package is ready for compilation. Extract the package ‘angora-package-version.tar.gz’ using tar, and enter the created directory:

johndoe@mysystem:~$ tar xvf angora-package-version.tar.gz
johndoe@mysystem:~$ cd angora-package-version

Run the configure script in this directory to create the Makefiles required to build the package:

johndoe@mysystem:~/angora-package-version$ ./configure

If any of the dependency libraries was installed in a local directory, then add the option ‘--with-library-name=local-path-to-library’ to the above command line. For example, if the blitz++ library was installed in ‘/home/johndoe/blitz-0.9’, then the option to add is ‘--with-blitz=/home/johndoe/blitz-0.9’. Type ‘./configure --help’ in the directory ‘angora-package-version’ for information on specifying the paths to the other dependency libraries.

After the configure script finishes execution, compile and install Angora using the make command:

johndoe@mysystem:~/angora-package-version$ make

If your system has multiple cores, you can speed up the compilation by executing make in parallel. For example, you can use all 4 cores of your system by typing, instead of the above line,

johndoe@mysystem:~/angora-package-version$ make -j 4

This might take a couple of minutes, depending on your system. After make finishes, the executable angora will be located in the directory ‘angora-package-version’. If you wish to install the package globally so that it can be run from anywhere, type

johndoe@mysystem:~/angora-package-version$ sudo make install

Obviously, this requires super-user privileges on your system. By default, the package is installed in ‘/usr/local’; so the binary will reside in ‘/usr/local/bin’. If you don’t have super-user privileges, you can install Angora in a local directory ‘full-path-to-inst-dir’ by typing

johndoe@mysystem:~/angora-package-version$ make prefix=full-path-to-inst-dir install

The location ‘full-path-to-inst-dir’ should be an absolute path. After this, the binary angora will be located in the directory ‘full-path-to-inst-dir/bin/’.

[ < ] [ > ]   [ << ] [ Up ] [ >> ]

This document was generated by Ilker Rafet Capoglu on December 12, 2012 using texi2html 1.82.