Running a single test package
------------------------------

1. copy tp.properties.sample -> tp.properties and adapt

2. run a testpackage, e.g.

>  ant tp.functional

3. look into the result.xml



Running the batch test
----------------------

1   build the jaas version of the slide webapp (target is webapp-jaas-dist)

2   install tomcat - tomcat 6.0.x works

3   copy slide.war to $CATALINA_HOME/webapps

4   create jaas.config in $CATALINA_HOME/conf
    see http://jakarta.apache.org/slide/howto-jaas.html

5   set the environment variable CATALINA_OPTS to
    -Djava.security.auth.login.config=$CATALINA_HOME/conf/jaas.config

6   start tomcat once, access the slide webapp from a web browser so that
    it unpacks itself

7   now, edit $CATALINA_HOME/webapps/slide/WEB-INF/web.xml
    set the startup parameter lockdiscoveryIncludesPrincipalURL to true
    this parameter is documented here : http://jakarta.apache.org/slide/howto-acl.html
    (link security of the Administrator's Guide)

8   shutdown and restart tomcat

9   to build the testsuite, from this directory run

    ant make

10. Optionally
    adapt testsuite/junit/testconfigs/_default/test_properties.xml
  - in particular the first line (server name ant port where the tomcat
    is running, user name and password of the user that can run the 
    manager app)

11. Optionally
    in batchtest.properties:
  - configure which test configurations shall be executed.
  - configure which test package (ant target) shall be executed for
    what configuration


12  to run the tp.functional suite, run

    ant tp.functional 


13  results :
    as of March 27th, I got 232/237 tests running successfully in tp.functional
    failing tests are :

       functional/multiplestores/code/copy.xml
       functional/multiplestores/code/copyFile.xml
       functional/multiplestores/code/move.xml
       functional/multiplestores/code/moveFile.xml
       functional/osx/basicUpload.xml