ActiveMQ Server for Debian
==========================

Disabled features
-----------------
This package doesn't contains (yet) all features provided by upstream
as some dependencies are missing from Debian.
For a list of disabled modules, you can look at
  /usr/share/doc/libactivemq-java/README.Debian

Main ActiveMQ instance
----------------------
Current package provide a default ("main") instance for ActiveMQ.

As of now, this instance only listen on loopback interface (127.0.0.1)
on port 61616, with OpenWire protocol enabled.
Messages storage is handled by kahadb in /var/lib/activemq/main/data/kahadb

You can customize its environnement here :
  cp /usr/share/activemq/activemq-options /etc/activemq/instances-available/main/options

Edit the file /etc/activemq/instances-available/main/options and restart it.

And it's XML configuration can be edited here :
  /etc/activemq/instances-available/main/activemq.xml

Enable it:
 ln -s /etc/activemq/instances-available/main \
 /etc/activemq/instances-enabled/main

Start it :
  invoke-rc.d activemq start


Debug an ActiveMQ instance
--------------------------

You can start any ActiveMQ instance in foreground for debugging.

Start instance `foo` in foreground:

  # /etc/init.d/activemq console foo


Setup a new ActiveMQ instance
-----------------------------

To create a new instance, you have to :
  mkdir /etc/activemq/instances-available/<instancename>

Create your own configuration into
 /etc/activemq/instances-available/<instancename>/activemq.xml

For example, you can copy a sample configuration :
  cp /etc/activemq/instances-available/main/* \
  /etc/activemq/instances-available/<instancename>/

If you need some other Xms / Xmx settings or want to use another JDK:

  cp /usr/share/activemq/activemq-options \
  /etc/activemq/instances-available/<instancename>/options

  In this file, you can modify ACTIVEMQ_BASE if you want to store
  your data elsewhere than /var/lib/activemq/<instancename>/ or
  JAVA_HOME if you want to use another JDK.

Register this instance into enabled:
  ln -s /etc/activemq/instances-available/<instancename> \
  /etc/activemq/instances-enabled/<instancename>

Start it :
  invoke-rc.d activemq start