Running the JBoss AS Integration Testsuite

Note: the steps described in this document refer to JBoss AS 5.0. In future, the document will be extended to include JBoss 4.x too.

This document assumes that the location of your JBoss 5 head workarea is given by the value of the $JBOSS_WORKAREA environment variable. The location of the runnable JBoss instance resulted from compilation is referred as $JBOSS_HOME. Its value is $JBOSS_WORKAREA/build/output/jboss-5.0.0.Beta2 at the time of the writing.

1. Update JBoss 5.0 head from repository and build it

If you want to run the integration test suite with a specific tag/branch, update the corresponding tag/branch workarea instead of the head.

Note: You must compile with Java 5.

      cd $JBOSS_WORKAREA
      ./build/build.sh clean
      rm -rf thirdparty
      svn update
      ./build/build.sh

This should create a default JBoss 5.0 installation, with JBoss Messaging pre-installed as default JMS provider.

2. Adjust JBoss Messaging configuration for the integration testsuite

2.1 Configure destinations

Edit $JBOSS_HOME/server/default/deploy/messaging/destinations-service.xml and remove all destination declarations, except DLQ.

2.2 Configure security

Edit $JBOSS_HOME/server/default/conf/props/messaging-users.properties and add a new john/needle test user:

#
# user=password
#
guest=guest
john=needle

Edit $JBOSS_HOME/server/default/conf/props/messaging-roles.properties and give john new roles:

#
# user=role1,role2,...
#
guest=guest
john=producer,durpublisher

3. Start the test JBoss instance

Note: In case your JBOSS_HOME environment variable points towards something else than $JBOSS_WORKAREA/build/output/jboss-5.0.0.Beta2, unset it, otherwise you won't start the correct JBoss instance.

      cd $JBOSS_WORKAREA/build/output/jboss-5.0.0.Beta2/bin
      ./run.sh

Note: you could optionally bind to specific addresses, such in:

      ./run.sh -b 10.16.6.135 -u 239.11.12.13

4. Build the integration testsuite

Note: You must use Java 5 to build the integration testsuite.

      cd $JBOSS_WORKAREA/testsuite
      ./build.sh

5. Run messaging integration tests

      cd $JBOSS_WORKAREA/testsuite
      ./build.sh -Dnojars=true tests-jbossmessaging

Note: you could optionally use to specific addresses when running the testsuite, such in:

      ./build.sh -Dnode0=10.16.6.135 -Dnode1=10.16.6.136 -DudpGroup=239.11.12.13 -Dnojars=true tests-jbossmessaging

6. Generate the HTML report

       ./build.sh tests-report

The HTML report will be available in $JBOSS_WORKAREA/testsuite/output/report/html/index.html

TODO

• We need to define default clientIDs (user based I guess) or define it on the ConnectionFactory.