Building Clerezza

The following instructions describes how to build Clerezza. If you don't want to build Clerezza yourself, you can download a launcher from here.

In order to build Clerezza you must have installed:

  • Apache Maven (version >= 2.2)
  • Java JDK 1.6
  1. svn co http://svn.apache.org/repos/asf/incubator/clerezza/
  2. Change working directory to parent (i.e. cd trunk/parent)
  3. mvn clean install -Dmaven.test.skip=true
    Skipping tests because of the pending issue CLEREZZA-326.

How to launch Clerezza is described on the Clerezza usage page.

Troubleshooting

Build fails due to stack overflow (on Platform Account Control Panel Core)

There is a pending issue with the Scala compiler having a too low stack size (CLEREZZA-612). There is currently no way to increase the Scala compiler's stack size via command line options. Using a 64bit operating system as well as using a machine with more system memory may help to resolve this problem. Alternatively edit the parent pom.xml file (POM file that is the highest in the folder hierarchy) to change the maven Scala plugin configuration in the following manner:

<project>
  ...
      <plugin>
        <groupId>org.scala-tools</groupId>
        <artifactId>maven-scala-plugin</artifactId>
        ...
        <configuration>
          <jvmArgs>
            <jvmArg>-Xss2048k</jvmArg>
          </jvmArgs>
        </configuration>
        ...
      </plugin>
  ...
</project>

Build fails due to OutOfMemory error

Set the environment variable MAVEN_OPTS to "-XX:MaxPermSize=256m" before starting the Maven build.

On Linux:
export MAVEN_OPTS="-XX:MaxPermSize=256m"
On Windows: see Maven Installation Instructions in the section "Windows 2000/XP".