|
|
(112 intermediate revisions by 15 users not shown) |
Line 1: |
Line 1: |
− | 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]].
| + | Please see https://github.com/nds-org/jupyter-et/blob/master/CactusTutorial.ipynb for build instructions on Linux, OSX and Windows. |
− | | |
− | ==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.
| |
− | | |
− | ==Running==
| |
− | The example files provided at for the most part too large to run on a single machine. You can try however to run the static_tov example which is smallest and requires about 1.3GB of RAM to run.
| |
− | | |
− | ./simfactory/bin/sim submit static_tov --parfile=par/static_tov.par --procs=1 --walltime=8:0:0
| |
− | ./simfactory/bin/sim show-output --follow static_tov
| |
− | | |
− | TODO: create smaller parameter file
| |
− | TODO: measure how long simulation runs
| |