Generating PEtALS from source

Software and Tools

You can find below a list of software and tools used to develop Petals with a integrated environment. This page doesn't provide installation instructions on these packages. Next sections will assume you have these pre-requisites installed and configured in your environment.

  • JDK 1.5.x
  • Maven 2.0.5 (you MUST use maven 2.0.5 or later because previous versions cause some compilation problems)

The Petals project structure

The project is divided into modules:

  • petals-cdk
  • petals-components
  • petals-platform
  • petals-common
  • petals-demos
  • petals-plugins
  • petals-samples
  • petals-tools

Checkout the sources

The instructions for downloading and configuring Petals project to run into Eclipse can be found in this section.

As we use SVN as source content management, you must have a svn client installed on your system. The following commands will checkout the sources into the $PATH/petals directory.

To checkout PEtALS as anonymous:

$ svn checkout svn://svn.forge.objectweb.org/svnroot/petals/trunk petals

To checkout PEtALS as developer:

$ svn checkout svn+ssh://developername@svn.forge.objectweb.org/svnroot/petals/trunk petals

Build PEtALS

To be able to build PEtALS with maven2, you need to download additional libraries that are not available on public maven repositories. Two zip archives are available for download on the PEtALS OW forge:

  • The PEtALS released libraries (petals-maven2-artefacts-X.X.zip)
  • The third party jars (third-party-maven2-artefacts-X.X.zip)
You need to download these two archives and extract them into your M2_REPO directory (~/.m2/repository directory on Linux and Documents and Settings/.m2/repository on Windows).

You also need to define a maven sytem variable to set the memory heap size for compilation purposes: MAVEN_OPTS=-Xmx512m

Now that you have the sources on your hard drive, you can build petals as explained next.

Change to the petals directory.

$ cd petals

Build the required artifacts.

$ mvn -Denv=first

Build the complete PEtALS distribution like this:

$ mvn

or build each module by changing to their directory and simply type

$ mvn
  • Note: You can build modules without the tests :
$ mvn -Dmaven.test.skip

To build the different Petals distributions, just go into petals-platform/petals-standalone and type : 

$ mvn assembly:assembly
  • To build the site of the whole Petals project (this may not generate the cobertura summary report, launch this command Z or 3 times be sure to generate all the cobertura summary):
$ mvn site

You can execute this commands in any project subdirectory to build or install only a precise project.