BuildOpenCmsFromSource

The following steps show how to build opencms from scratch just using ant.

Prerequesites

• JDK 5
• 1.6.x or later, Installation directory referred to as %ANT_HOME%

Folder structure

First download the source distribution of your choice from OpenCms website or check it out from cvs. Create a new folder (referred to as %BUILD_ROOT%) and another folder in it (referred to as %SOURCE_ROOT%) and unzip the downloaded sources in it (the build process will create folders above the %SOURCE_ROOT% folder).

Modifications in build.xml

Change to %SOURCE_ROOT% and edit the file build.xml

Navigate to the line beginning with

<property name="opencms.input.externlibs" 

and change it to

<property name="opencms.input.externlibs" location="${opencms.input.webinf}/lib" />

This way you can put the external jars required in the same dir as the other libs.

Required libs

Download the oracle driver classes (ojdbc14.jar) from here: [1] (need to sign in) and place it in %SOURCE_ROOT%/webapp/WEB-INF/lib.

Read the file src-components/ant-opencms-config.txt and copy the libs mentioned there from %SOURCE_ROOT%/webapp/WEB-INF/lib/ to %ANT_HOME%/lib

Building

To build the complete distribution go the directory where build.xml is located and call ant bindist.

The web archive can be found at %BUILD_ROOT%/BuildCms/build/opencms.war