1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90
|
DEPENDENCIES
============
In order to build Pegasus from source you will need the following software:
* Linux or Mac OS X (not Windows)
* Ant v1.6 or later
* Java v1.5 or later
* Python 2.4 or later (not Python 3 or later)
* Perl 5 or so
* A C compiler (gcc or clang)
* A C++ compiler (gcc or clang)
* Make
* Typical UNIX tools such as tar and sed
If you want to build the documentation you will also need:
* asciidoc
* xsltproc
* docbook XSL stylesheets
* fop
If you want to build Pegasus-MPI-Cluster you will need:
* An MPI implementation (e.g. mpich2) and an MPI C++ compiler wrapper (mpicxx)
To run Pegasus you will also need:
* A recent version of Condor
GETTING THE CODE
================
To get the source code, either clone the git repository from GitHub:
$ git clone https://github.com/pegasus-isi/pegasus.git
or untar the source tarball:
$ tar xzf pegasus-source.*.tar.gz
You will end up with a directory with the source code, which this guide refers
to as PEGASUS_HOME.
BUILDING PEGASUS
================
Once you have the source code you can compile it using Ant. There are many
different build targets in the Ant build.xml file. You can get a list of these
targets and a brief description by running:
$ ant -p
from the PEGASUS_HOME directory. You can execute the build by running:
$ ant TARGET
from the PEGASUS_HOME directory, where TARGET is one of the available targets.
The most useful targets will be the ones beginning with "dist". You can build
a few different package artifacts using these "dist" targets, which will
generate .tar.gz files in the PEGASUS_HOME/dist directory. These dist
targets include:
* dist - Generates a binary package without documentation
* dist-release - Generates a binary package with documentation
* dist-worker - Generates a worker package
The recommended, and default, target is "dist".
You can also run the unit tests using the targets that begin with "test". For
example, "test-java" runs the Java unit tests.
INSTALLING PEGASUS
==================
Once you have the package you want in the PEGASUS_HOME/dist directory, you
can move it to where you want to install Pegasus, extract the tarball, and
set your PATH to include the pegasus-VERSION/bin directory extracted from
the tar file. Run 'pegasus-version' to make sure it works.
MORE INFORMATION
================
More information is available via these sources:
Website : http://pegasus.isi.edu
Support email : pegasus-support@isi.edu
Git repository : https://github.com/pegasus-isi/pegasus
Bug tracker : https://jira.pegasus.isi.edu
|