1. Check out a repository snapshot

To check out the HEAD

           svn co  --username  <your-username> https://svn.jboss.org/repos/messaging/trunk messaging-head

Note that you have to be registered on the JBoss website in order to be able to check out from the development SVN repository. If you prefer to check out from the anonymous repository, which is periodically synchronized with the development repository, you can use this command:

           svn co http://anonsvn.jboss.org/repos/messaging/trunk messaging-head

Be aware there is a certain lag (about 10 minutes) between the developer's SVN and the anonymous SVN, so if you use anonymous access, it is possible to miss newly checked in files.

To check out a specific branch

           svn co  --username  <your-username> https://svn.jboss.org/repos/messaging/branches/Branch_1_0 messaging-Branch_1_0

To check out a specific tag (release)

           svn co  --username  <your-username> https://svn.jboss.org/repos/messaging/tags/JBossMessaging_1_0_1_GA messaging-1.0.1.GA

*Note*

*Note*

The directory you used to check out Messaging in will be henceforth referred as $MESSAGING_HOME.

2. Build

           cd $MESSAGING_HOME
           ant

*Note*

*Note*

The first build will take a while (about 2 minutes, on a machine with broadband internet connection), since the build process connects to http://repository.jboss.com and download all required depencies. The dependencies are cached so subsequent builds will be a lot faster, unless $MESSAGING_HOME/build-thirparty.xml is modified or the thirdparty directory is deleted.

3. Run functional tests on JBoss Messaging

JBoss Messaging 2 doesn't require any extra step to run the testsuite besides being able to build it, i.e. all you need is java, ant and svn.

If you just go to $MESSAGING_HOME and type:

1. To run the entire testsuite

ant all-tests

1. To run just the unit-tests portion

ant unit-tests

1. To run just the the jms-tests portion

ant jms-tests

1. To run any specific test:

ant -Dtest-mask=

jms-tests | unit-tests

5. Install Messaging within a JBoss AS instance

At the time this page has been updated, JBoss Messaging Alpha didn't have instructions to install JBM 2 Alpha on the application server as this wasn't supported on Alpha. Look at the current userguide and feel free to change this paragraph if this has changed.

6. Start the Messaging server Standalone

It is possible to run JBoss Messaging 2 in standalone mode. If you go to Messaging-Distro/bin, and if you start run.sh you will have JBM 2 up and running.

UserJoe@joesBox:/downloads/messaging-2.0.0.alpha1/bin$ ./run.sh
java -XX:+UseParallelGC -Xms512M -Xmx1024M -Dorg.jboss.logging.Logger.pluginClass=org.jboss.messaging.core.logging.JBMLoggerPlugin -Djava.library.path=. -classpath ../lib/xercesImpl.jar:../lib/trove.jar:../lib/slf4j-log4j12.jar:../lib/slf4j-api-1.4.3.jar:../lib/mina-core-2.0.0-M2-20080520.004618-19.jar:../lib/log4j.jar:../lib/jnpserver.jar:../lib/jgroups.jar:../lib/jboss-xml-binding.jar:../lib/jbossts-common.jar:../lib/jboss-transaction-spi.jar:../lib/jbosssx-client.jar:../lib/jboss-security-spi.jar:../lib/jboss-messaging.jar:../lib/jboss-messaging-client.jar:../lib/jboss-kernel.jar:../lib/jbossjta.jar:../lib/jbossjta-integration.jar:../lib/jboss-javaee.jar:../lib/jboss-jaspi-api.jar:../lib/jboss-dependency.jar:../lib/jboss-container.jar:../lib/jboss-common-logging-spi.jar:../lib/jboss-common-core.jar:../lib/jboss-aop-mc-int.jar:../lib/jboss-aop-jdk50.jar:../lib/javassist.jar:../lib/concurrent.jar:../lib/commons-logging.jar:../config/ org.jboss.jms.server.microcontainer.JBMBootstrapServer jbm-standalone-beans.xml
libJBMLibAIO32.so libJBMLibAIO64.so run.sh
08:40:11,557 INFO  @main [JournalStorageManager] Directory data/bindings does not already exists
08:40:11,558 INFO  @main [JournalStorageManager] Creating it
08:40:11,567 INFO  @main [JournalStorageManager] Directory data/journal does not already exists
08:40:11,567 INFO  @main [JournalStorageManager] Creating it
08:40:11,567 INFO  @main [JournalStorageManager] AIO journal selected
08:40:11,576 INFO  @main [JournalStorageManager] AIO loaded successfully
08:40:11,750 INFO  @main [MinaService] Registering:tcp://localhost:5400
...

More information on docs

Look at the User Manual for more information.