Installing the latest revision of ESyS-Particle on Ubuntu-16.04 (and later variants)

Created by Dion Weatherley on on 2011-05-30
Keywords:
install ubuntu 16.04
Last updated by:
Dion Weatherley on on 2017-06-13

[These installation instructions were verified using a fresh installation of xubuntu-16.04.1-amd64]

1) Install the latest version of ubuntu (or your favorite variant) and update all packages:
sudo apt-get update

2) Install MANDATORY dependencies:
sudo apt-get install libtool automake build-essential bzr
sudo apt-get install mpi-default-bin mpi-default-dev libboost-all-dev

3) Install POVray (ver 3.6) [OPTIONAL]
POVray (ver. 3.6) source code is available from:
http://www.povray.org/download/index-3.6.php

3a) tar xfz povray-3.6.tar.gz
3b) cd povray-3.6.1
3c) ./configure COMPILED_BY="your name <email@address>"
3d) make check
3e) sudo make install

4) Install OPTIONAL dependencies
sudo apt-get install libvtk5-dev python-epydoc

5) Configure bazaar:
5a) bzr whoami "Your Name <name@example.com>"
5b) ssh-keygen -t rsa
5c) upload the public key to launchpad -- instructions are available here:
https://help.launchpad.net/YourAccount/CreatingAnSSHKeyPair
5d) bzr launchpad-login launchpad-username

6) Obtain and install the latest development version of ESyS-Particle:
bzr co lp:esys-particle
sh autogen.sh
./configure CC=mpicc CXX=mpic++
make
sudo make install

7) Set up environment variables
export PATH=/usr/local/bin/:$PATH
export LD_LIBRARY_PATH=/usr/local/lib/:$LD_LIBRARY_PATH
export LIBRARY_PATH=/usr/local/lib/:$LIBRARY_PATH
export PYTHONPATH=/usr/local/lib/python2.7/dist-packages/:$PYTHONPATH

[OPTIONALLY, append these 'export' lines to the end of ~/.bashrc]

8) run a test script e.g. bingle_output.py from the ESyS-Particle Tutorial
mpirun -np 2 esysparticle bingle_output.py

9) Have fun!