Runing the JOnAS Test Suite


Aim

This document aims to provide a guide for thoses who want to run the JOnAS test suite on their own.

Pre-requisites

In order to run the test suite, some software needs to be installed first:

Compile OW2 JOnAS

Before running the test suite, the developper needs to obtain a valid JOnAS Root directory (JONAS_ROOT).

Get the sources

# Anonymous checkout
svn checkout svn://svn.forge.objectweb.org/svnroot/jonas/jonas/trunk/jonas

That will checkout the sources in a new jonas/ folder.

Compile

The compilation process will produce a JONAS_ROOT that will be used for testing.

cd jonas
mvn clean install

JOnAS Root

The JOnAS archive has been installed in the local Maven repository:
$HOME/.m2/repository/org/ow2/jonas/assemblies/profiles/jonas-full/{version}/jonas-full-{version}-bin.zip

This archive will be used by the test suite.

Run the suite

Get the sources

# Anonymous checkout
svn checkout svn://svn.forge.objectweb.org/svnroot/jonas/jonas/trunk/jonas_tests

That will checkout the sources in a new jonas_tests/ folder.

Execution

Some environment variables needs to be set prior to the execution:
export JONAS_ROOT={an-empty-directory}
export JONAS_BASE={an-empty-directory}
export HTTP_PORT=9000 # default HTTP port
export HTTPUNIT_HOME={http-unit-home}
export XMLUNIT_HOME={xml-unit-home}

JONAS_ROOT and JONAS_BASE should point to empty directories (they will be filled during the test preparation).

ant run_nightly

HTTP Proxy

If the suite needs to run behind a proxy, provide a *proxy.properties* file in $HOME:
proxyHost proxy.example.org
proxyPort 8080
proxySet true

Reports

The JUnit reports have been aggregated in the report/ directory.