Page History

...

Build and deploying Roller from source involves three simple steps: get the source, run the build script, follow the installation instructions above to deploy the results.

Before you get started

Make sure you have the Sun Java SE 5 JDK installed on your system. Set the environment variable JAVA_HOME to point to your JDK directory.

Get the Roller source code

...

   % svn checkout https://svn.apache.org/repos/asf/roller/trunk roller_trunk

After you are done getting the source code, you can return here and move on to Step 2.

Run the build

Once you have extracted the Roller source code into a directory on your system, then open up a command prompt and cd to that directory.

HereUnder the roller_trunk directory, here's how the code is layed out:

   apps/weblogger   - Roller Weblogger source code
   apps/planet      - Roller Planet source code
   components/core  - Roller "Core" or shared code
   tools            - Dependencies

Set the environment variable JAVA_HOME to point to your JDK and then build Roller by using either the UNIX or Windows version of the build script. This script sets up the right classpath and calls Roller's Ant build script build.xml. The build shell script invokes the Ant that is in the tools subdirectory that comes with the Roller Subversion tree (or from extracting the tools file you downloaded). If you like to drive Ant from your IDE, you should set up to use the same Ant jar and classpath that is used by the shell script.

After you are done getting the source code, you can return here and move on to Step 2.

Run the build

Once you have extracted the Roller source code into a directory on your system, then open up a command prompt and cd into the Roller Weblogger directory. Run the Ant build script there.

If you don't have Ant then you can use the UNIX build.sh or Windows build.bat build script. It uses the version of Ant that is bundled with the Roller source. For example, to build Roller Weblogger:

...