Chapter 3. Download Software

The official releases of JBoss Messaging are available as a free download from the JBoss Messaging project landing page.

3.1. The JBoss Messaging Release Bundle

The JBoss Messaging release bundle (jboss-messaging-1.0.x.zip) will expand in a jboss-messaging-1.0.x directory that contains:

  • jboss-messaging-scoped.sar - the scoped JBoss service archive that contains JBoss Messaging and its dependencies.

    Warning

    Do not simply attempt to copy the archive under a JBoss instance deploy directory, since additional steps (such as un-installing JBossMQ and various other configurations tasks) are required for a successful installation. See Chapter 5, Installation for more details.
  • jboss-messaging-client.jar - the client-side library that need to be in the classpath of the client that opens a remote connection to the Messaging server.
  • util - a collection of ant configuration files used to automate installation and release management procedures. See the Installation chapter for more details.
  • examples - a collection of examples that should run out of the box and help you validate the installation. Detailed instructions are provided with each example, which range from very simple JMS queue and topic examples to relatively sophisticated use cases in which EJBs and JCA JMS ConnectionFactories are involved. The examples/config sub-directory contains various configuration file examples.
  • docs - this user's guide.
  • src/jboss-messaging-1.0.x-src.zip - the zipped source directory. The file can be directly installed into and used with a debugger.

    Note

    JBoss Messaging cannot be built using exclusively this source snapshot, which is provided for reference only.
  • src/jboss-messaging-tests-1.0.x-src.zip - the functional testsuite source archive.
  • test-results - the output of the functional testsuite, stress and smoke test runs for this release. All these files have been generated during the release procedure.
  • api - the Messaging API javadoc.
  • README.html - The release intro document that contains pointers to various other resources, including this Guide.

3.2. CVS Access

If you want to experiment with the latest developments you may checkout the latest code from the 5.0 head branch. Be aware that the information provided in this manual might then not be accurate. For the latest instructions, check out the Messaging Development wiki page .