System Requirements

Hawron requires the following software to be already installed in your system:

Java version 1.4 or later.

For building:Ant 1.6 or later

And of course a version of Cocoon.

Binary Dist

XML processing needs often much memory and the usage of Cocoon with the Servlet-plugin jetty and Offline-Processing at the same time will consume very much memory (the windows wrapper 'hawron.exe' uses 256MB as default)

So if you have trouble with the default 64MB of Java-VM you can set the commandline-parameter '-Xmx256m' which allows the Java-VM to use 256MB memory.

On Windows-platforms you can create a simple wrapper-script witch launch Hawron with a double-click. Unfortunately the OpenOffice-Plugin needs then the 'awt.dll'-library the PATH-environment-variable. Look at the following code and change the settings for your need. Save this as 'run.bat' and you can double-click this batch-script.

             REM sample-'run.bat'  simple copy and paste it
             REM change the path-setting to point to 'awt.dll'
             SET PATH=%PATH%;C:\Program Files\j2jre1.4.2_04\bin
             REM allow 256MB or change to your need
             javaw -Xmx256m launcher.jar
          

Cocoon Versions

Look at the table to see which Cocoon versions run out-of-box with Hawron

It is important to use Hawron 0.3, older versions needs a patched Cocoon. This is fixed since 0.3

Cocoon Installer

Hawron comes with an CocoonInstaller. This installer can help you to build a Cocoon distribution. Follow simple the Step-by-Step-process. The installer includes a Block-Editor which helps you to deselect Cocoon-Blocks, which breaks the working with Hawron. The Editor tries to solve all dependencies of blocks.

You can use the CocoonInstaller standalone. Go to the "plugins/cocooninstaller" directory and "java -jar cocooninstaller.jar" should start it (or double-click on the jar under Windows)

The Installer is available via webstart or as separate package (installer.zip; unpack and double-click the cocooninstaller.jar)

Build from Source

CVS-Version

You can get the developer-version via CVS. Try:

           cvs -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/hawron login
       

When prompted for a password for anonymous, simply press the Enter key.

	   cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/hawron co hawron
       

Optional libraries

If you want publish to SMB-shares you must download the jCIFS-library and place the jcifs-xx.jar to the 'lib/optional'-folder. You can use now 'smb://' as publish target.