Clarens logo
Installation Guide
Build Instructions
User Guide
JClarens Installations
JClarens Javadoc
Clarens Home Page
Developers' Guide
Development Team



The prerequisites for building JClarens from source are:
1. Java development Kit 1.4.2
2. Jakarta Tomcat 5.0.28 and above
3. Apache Ant 1.5 and above
4. MySQL, SQL Server or other ODBC-compliant database (if HSQLDB is not desired)

Build Procedure

1. Download the code from the CVS repository using the commands:
cvs login
cvs -z3 co jclarens

CVS for Windows and Linux can be obtained from

2. Modify in the downloaded jclarens directory to point to your tomcat location.

In case of Linux, give the absolute path to TOMCAT_HOME.

In case of Windows, the path to TOMCAT_HOME should be specified with double backslashes ("\\") instead of single backslashes ("\"). For example, the path C:\src\jakarta-tomcat-5.0.28 should be specified as c:\\src\\jakarta-tomcat-5.0.28.

3. Modify to set the correct values for your hostKeyFile and hostCertFile. (By default, the sample JClarens' server certificate and key in located in $TOMCAT_HOME/webapps/jclarens/etc/grid-security). Again, for Windows, the path should be specified with double backslashes as in step 3.

4. To build the JClarens binaries, browse to the downloaded jclarens directory and run ant install. This builds the web application archive and installs it into the tomcat webapps directory.

Note: To run ant, you will need to set the ANT_HOME environment variable to point to the directory where ant is installed, and $ANT_HOME/bin must be added to the PATH environment variable. In addition, junit.jar must be placed in $ANT_HOME/lib.

5. Start tomcat by going to $TOMCAT_HOME/bin and running Tomcat's startup script, startup.bat (Windows) or (Linux).

6. To test the complete installed features of JClarens, go to $TOMCAT_HOME/webapps/jclarens and run ant with one of the following targets:

# ant test
Runs the unit tests against the local tomcat server.

# ant -Dclarens.url=http://host:port/url test
# ant -Dclarens.url=http://host:port/url visual-test
Run the client tests against a remote clarens server:

# ant -Dclarens.client.certificate=/path/to/newcert.pem -Dclarens.client.privateKey=/path/to/newreq.pem test
Run the client tests using a new client certificate and key

SSL Settings

1. To configure Tomcat and JClarens for operation over SSL connections, go to $TOMCAT_HOME\conf\server.xml. Uncomment the SSL Connector configuration, and modify it as shown below:

<Connector port="8443"







maxThreads="150" minSpareThreads="25" maxSpareThreads="75"

enableLookups="false" disableUploadTimeout="true" acceptCount="100" debug="0" scheme="https" secure="true"

clientAuth="true" sslProtocol="TLS" />

JClarens' sample server certificate and private key is located in jclarens/etc/grid-security/hostcert.pem and jclarens/etc/grid-security/hostkey.pem respectively.