Chapter 4. Installation

4.1. Prerequisites

Note

JBoss Messaging only runs on Java 5 or later. We highly recommend to use Java
6.

By default, JBoss Messaging server is run with 1GB of memory. If your computer has less
memory, modify the value in bin/run.sh accordingly.

For persistence, JBoss Messaging uses its own fast journal file, which you can configure
to use libaio (which is the default when running on Linux) or Java NIO. In order to use the
libaio module on Linux, it's required to install libaio.

If you're not running on Linux then you don't need to worry about this.

You can install libaio using the following steps:

Using yum, (e.g. on Fedora or Red Hat Enterprise Linux):

sudo yum install libaio

Using aptitude, (e.g. on Ubuntu or Debian system):

sudo apt-get install libaio

Apache Ant is required to create the
profiles for JBoss AS 5 and run the examples.

4.2. Standalone JBoss Messaging Server

After downloading the distribution, unzip it into your chosen directory. At this point
it should be possible to run straight out of the
box, the following describes the directory structure:

config -- configuration files needed to configure JBoss
Messaging. This contains configurations to run JBoss Messaging either in stand-alone
or inside JBoss AS 5. Please refer to the reference guide for details on
configuration.

docs -- guides and javadocs for JBoss Messaging

examples -- JMS and Java EE examples. Please refer to the
'running examples' chapter for details on how to run them.