Chapter 4. Download Software

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

The recommended download location is the JBoss Labs Messaging Project download zone: http://labs.jboss.com/portal/jbossmessaging/downloads We also maintain an alternate download location on sourceforge.net: http://sourceforge.net/project/showfiles.php?group_id=22866&package_id=157261

4.1. The JBoss Messaging Release Bundle

The JBoss Messaging release bundle (jboss-messaging-1.2.x.zip) will expand in a jboss-messaging-1.2.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, JBoss Messaging Non-Clustered 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.

    Note

    This is an important note on the Messaging client jar. JBoss Messaging has an extensive tree of dependencies and bundling all right dependencies in one easy to use archive, so no wrong versions inadvertently get in the class path is, as experience shows, extremely convenient. However, this could cause problems if a different version of a dependency is required by the user's client code.

    If, for example, the log4j.jar bundled with the release causes problems for being too old, one could just simply build the client-side class path so a newer version of log4j.jar precedes jboss-messaging-client.jar in that class path. This approach may work, but is not guaranteed to work, because we did not run the full test suite with any other log4j.jar version except the one we bundle with the release. Soon we will providing an ant task that creates a slimmed down client jar without the extra dependencies bundled.

    A list of required dependencies for a specific release can be found in the build-thirdpary.xml file that is part of the companion source bundle that ships with each release. It can also be looked up online in http://fisheye.jboss.org.

  • util - a collection of ant configuration files used to automate installation and release management procedures. See Chapter 5, JBoss Messaging Non-Clustered Installation 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, as well as clustering use cases. The examples/config sub-directory contains various configuration file examples.
  • docs - this user's guide.
  • src/jboss-messaging-1.2.x-src.zip - the zipped source directory. The file can be directly installed into and used with a debugger.
  • 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 and are bundled here for reference.
  • api - the Messaging API javadoc.
  • README.html - The release intro document that contains pointers to various other resources, including this Guide.

4.2. SVN Access

If you want to experiment with the latest developments you may checkout the latest code from the Messaging SVN trunk. Be aware that the information provided in this manual might then not be accurate. For the latest instructions on how to check out and build source code, please go to Messaging Development wiki page, specifically "Building and Running JBoss Messaging" section.