Installation

DREAM is run on a cluster of machines on a server. lease make sure that you use enough machines to run the queries. As an example, you will need to use 3 machines for the sample files provided. Ensure you have met the following requirements on ALL the machines you plan to run DREAM on.

System Requirements

Operating System

We recommend installing Ubuntu 14.04.3 LTS (Trusty Tahr). You can find instructions on how to do so here: Ubuntu

---

Required Libraries

g++

g++ 4.8 needs to be installed on your machines. You can do this by doing the following:

    sudo apt-get update
    sudo apt-get upgrade
    sudo apt-get install build-essential

Thread Building Blocks (libtbb)

You can install Intel's TBB using:

    sudo apt-get install libtbb-dev

Boost C++ libraries (libboost)

You can install Boost using:

    sudo apt-get install libboost-all-dev

Note that Boost automatically installs Open MPI. We will be using MPICH, so it is important that you install it as directed in the following section, after installing Boost.

MPICH

Since we will be using MPICH-3.1.4, you will have to ensure password-less ssh access between all the machines on your cluster. You can find out how to do this here.

After password-less ssh has been set up on your cluster, follow these steps to install MPICH on each machine.

First, you need to remove the existing Open MPI installation:

    which mpicc  //tells which directory the current mpi installation is in
    cd /usr/bin  //cd into the directory with the current mpi installation
    rm -rf mpi*  //remove the installation

Next, download and install MPICH-3.1.4:

    wget http://www.mpich.org/static/tarballs/3.1.4/mpich-3.1.4.tar.gz
    tar xzf mpich-3.1.4.tar.gz
    cd mpich-3.1.4
	
    ./configure -prefix=/usr/local --disable-fortran
    sudo make install

Any other path may be used for the prefix, as long as the same path is used on all machines. Add the following lines to your ~/.bashrc file:

    export MPICH_HOME=/usr/local/bin/mpich
    export PATH=$PATH:$MPICH_HOME/bin

Run source ~/.bashrc or . ~/.bashrc to load the changes made to ~/.bashrc