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

BUILD INSTRUCTIONS

Prerequisites

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 -d:pserver:anonymous@clarens.cvs.sourceforge.net:/cvsroot/clarens login
cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/clarens co jclarens

CVS for Windows and Linux can be obtained from https://ccvs.cvshome.org/servlets/ProjectDocumentList.

2. Modify build.properties 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 xmlrpc_handlers.properties 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 startup.sh (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"

sSLImplementation="org.glite.security.trustmanager.tomcat.TMSSLImplementation"

sslCAFiles="/path/to/etc/grid-security/certificates/*.0"

crlFiles="/path/to/etc/grid-security/certificates/*.crl_url"

sslCertFile="/path/to//etc/grid-security/hostcert.pem"

sslKey="/path/to/etc/grid-security/hostkey.pem"

log4jConfFile="/path/to/jakarta-tomcat-5.0.28/conf/log4j-trustmanager.properties"

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.