wiki:Aesop Installation
Last modified 9 years ago Last modified on 10/23/13 17:49:23

NOTE: The instructions below might be out of date.
For the most up to date information, please see the INSTALL file in the source code distribution.
The README from the master branch in the repository can be found here: INSTALL

Steps to run one time in order to prepare your environment

Prerequisites (documentation below will describe how to install necessary packages):

  • ghc >= 7.0
  • at least 2 GiB of memory
  • OpenPA (portable atomics library from ANL)
  • autoconf
  • wget
  • libev

Mac OS X

In order to install Aesop you need to first clone the repository. For anonymous users:

git clone git://

For authenticated users (see Community how to become an authenticated (i.e. commit access) user):

git clone [email protected]:aesop.git

You then need to install the Glaskow Haskell Compiler (ghc). This is available as a provided package in apt for debian and ubuntu.

If you do not have root then you can install the ghc binaries in your home directory. The binary builds can be found here:

You then need to install the wget utility. This should be available as a package on any platform.

The next step is to cd to the aesop/maint/hs/ directory and run the following two scripts (as a user):


And finally, you should install the openpa library. There are two ways to do this. Either install mpich (which includes openpa) or else install openpa itself from this web page:

If you install the standalone openpa package then you should run the following commands from within the openpa source:

./configure --prefix=<some directory in my home directory>
make install

The actual aesop build

First run a script to generate the configure script:


Once a configure script has been generated, you can compile aesop in the source directory if you want, but we usually recommend doing an "out of tree build". To do this, create a build subdirectory inside the aesop directory and then run configure and make from there:

mkdir build
cd build
../configure --prefix=<the directory you would like to install aesop in>

If your openpa installation is in a non-standard location (see previous section) then you can specify --with-openpa=<path> to tell configure where to find the openpa library.

You can then build aesop itself by running make within the build-aesop directory:

make -j 4 

(note: the -j 4 part is optional, but the aesop package does support parallel builds which will speed things up on most systems)

In order to build a collection of aesop test programs you can run the following command

make -j 4 test

To install aesop (including headers, runtime libraries, and the source translator) run the following:

make install