Setup

Requirements

There are a few things you need to have installed prior to using Pustefix. See the list below for references.

A unixoid OS

Yes, Java should be platform independent. Unfortunately portions of the build environment and code are unix specific. Although these platform independant portions mainly deal with file system path secifications - they exist. There may be even more places where the thing wouldn't work on win32. Pustefix is developped on Linux but should also work on Mac OS X. Other unixoid operating systems might work as well, but might need a fix or two.

Java 5 SE

You need a Java 5 SE JDK or higher to build Pustefix applications. We are using the SUN JDK, but others might work as well.

Apache Maven

Apache Maven, the Java-based build tool in version 2.0.9 or higher. If you have really large projects consider increasing the memory for the java vm Maven runs in: Set the MAVEN_OPTS environment variable to something like "-Xmx1024m". This variable is evaluated within the mvn start script contained in the Maven distribution.

Pustefix Setup

Starting with Pustefix 0.14.0, there a no Pustefix download files you have to unpack on your machine. Instead, you add the Pustefix Maven Repository to your Maven settings and Maven performs the necessary downloads when needed. The Pustefix Maven Repository hosts all the files that make up Pustefix 0.14+.

Open the file conf/settings.xml in your Maven install directory and add the following before the closing profiles tag near the end of the file:

<profile>
  <id>pustefix</id>
  <activation>
    <activeByDefault>true</activeByDefault>
  </activation>
  <repositories>
    <repository>
      <id>pustefix</id>
      <name>Pustefix Maven Repository</name>
      <url>http://pustefix-framework.org/repository/maven</url>
    </repository>
  </repositories>
  <pluginRepositories>
    <pluginRepository>
      <id>pustefix</id>
      <url>http://pustefix-framework.org/repository/maven/</url>
    </pluginRepository>
  </pluginRepositories> 
</profile>

That's it - Pustefix is now available on your machine.

Development version

Instead of configuring the Pustefix Maven Repository, you can checkout and build the current development version of Pustefix:

svn co https://pustefix.svn.sourceforge.net/svnroot/pustefix/trunk pustefix
cd pustefix
mvn clean install

Old Releases (before 0.14.0)

Pustefix releases can be downloaded from SourceForge. The files to download are shown in the table below.

Filename	Content
pfixcore-skel-<VERSION>.tar.gz	Contains an empty pustefix environment with almost everything you need to develop pustefix applications.
pfixcore-<VERSION>.jar and pfixcore-data-<VERSION>.tar.gz	Contains the pustefix core with all java classes and the necessary XML/XSLT files.Usually, you will download a pustefix environment (the pfixcore-skel stuff above) which includes the core. Download these files if you already have an pustefix environment and want to upgrade it to the latest core.
pfixcore-examples-<VERSION>.tar.gz	Example projects