==========================================================
        Running Apache Maven Unit Tests under BT infrastructure
        ==========================================================


This document describes how to run Apache Maven Unit Tests on Apache
Harmony within Apache Harmony Build&Test infrastructure
Please see BTI's README.txt
for general instructions on BT usage. The following platforms are currently
supported: Windows x86, Linux x86.

---------------
Archive Content
---------------

This archive contains scripts for running maven unit test within BT. The directories structure
within BT trunk directory is as follows:

+<BTI trunk>/
|-+adaptors/                        - scripts connecting test suites to BTI (called "adaptors")
|  |
|  |-+maven_test/                   - maven suite adaptor directory
|     |
|     |--adaptor.xml                - maven suite adaptor
|     |
|     |--MAVEN.BTI.README.txt       - this readme file
|     |
|     |--parameters.xml             - parameters file
|
|-+tests/                           - test suites integrated into BTI
   |
   |-+maven_test/                   - maven scripts directory
      |
      |--alltests.list              - list of all Maven Unit Tests; used by exclude.lists feature
      |
      |--build.xml                  - main maven suite launching script
      |
      |--exclude.list.${os}.${arch} - platform specific exclude.lists
      |
      |--maven.properties           - maven properties (used when running without BTI)


-----------------------------------------------------------------
Running Apache Maven Unit Tests on Harmony JRE under BT infrastructure
-----------------------------------------------------------------

1. Follow instructions from <BTI trunk>/README.txt to satisfy general BTI
   pre-requisites (install necessary software, specify environment variables,
   specify proxy settings if necessary).

2. Unpack this archive to <BTI trunk> directory

3. Perform setup:

     buildtest -Dtest.suites="classlib,drlvm,maven_test" setup

4. Configure BT for maven run:

   * Specify appropriate options for the JRE under test in <BTI trunk>/framework.local.properties
     file by setting maven.parameters.optional.tested.vm.options=<options>. By default,
     maven.parameters.optional.vm.options=""

   * Specify appropriate mail settings in <BTI trunk>/framework.local.properties file
     if you want Cruise Control to send mail notifications.

   * Modify platform specific exclude.list in <BTI trunk>/tests/maven_test if necessary. It should be named
     as exclude.list.${os}.${arch} where ${os}.${arch} can be windows.x86, linux.x86 or linux.x86_64.

5. Build classlib and drlvm and run maven on it:

     buildtest -Dtest.suites="classlib,drlvm,maven_test" run

6. To continuously perform Harmony JRE build (classlib and drlvm) and maven_test run under Cruise Control:

     buildtest -Dtest.suites="classlib,drlvm,maven_test" run-cc

--------------------------------
DISCLAIMER AND LEGAL INFORMATION
--------------------------------
Other brands and names are the property of their respective owners.