Simplified Tutorial for New Users

Here you will find a concise and straightforward guide to downloading, installing, and running the Einstein Toolkit. For a more detailed tutorial, view the Tutorial for New Users.

Prerequisites

You will need a number of packages installed in order to download the Einstein Toolkit components, and if you follow the instructions in this tutorial. On a Debian, Linux-Mint or Fedora-based system, install them as follows:

# Debian
su apt-get install build-essential g++ gfortran libmpich2-dev mercurial git subversion curl gnuplot
# Mint13 (likely Ubuntu oneiric ocelot as well)
sudo apt-get install libmpich2-dev gfortran g++ git mercurial subversion curl gnuplot
# Fedora (incomplete)
yum install git wget

Downloading

A script called GetComponents is used to fetch the components of the Einstein Toolkit. You may download it as follows:

curl -O https://github.com/gridaphobe/CRL/raw/ET_2011_05/GetComponents 
chmod a+x GetComponents

GetComponents accepts a thorn list as an argument. To check out the needed components:

./GetComponents --parallel https://svn.einsteintoolkit.org/manifest/branches/ET_2012_05/einsteintoolkit.th

This checks out Cactus, the Einstein Toolkit, and Simulation Factory.

Configuring

You may proceed to configure Simfactory which requires some changes for some OS.

cd Cactus
# for Mint13 (mpich2 needs mpl)
sed '/MPI_LIBS/s/mpich/mpich mpl/' <simfactory/mdb/optionlists/debian.cfg >simfactory/mdb/optionlists/mint.cfg
./simfactory/bin/sim setup --optionlist=mint.cfg
# for Debian
./simfactory/bin/sim setup --optionlist=debian.cfg
# for Fedora
./simfactory/bin/sim setup --optionlist=fedora.cfg

Accept the default values for all options.

Building

Now that you have configured Simfactory, you may build:

./simfactory/bin/sim build --thornlist=manifest/einsteintoolkit.th

This may take a while, as it compiles all the thorns specified in manifest/einsteintoolkit.th.