Nagios-ActiveMQ binding configuration details

Table of Contents

No need for habit changes !

The related configuration script has been written in a way to feed from existing definition files to build ActiveMQs configuration. Of course you need to provide some specific information, but you don't need to change anything in older configuration habits (ie. you define message handlers in the same way as before). Furthermore, you can very easily customise the new configuration file as it is YAML formated.

Check the diagrams to get a picture of how the new configuration is built.

Author : JulienPerrochet - 2009-08-28

ActiveMQ :

Call this script when you have set everything in the configuration files. A sub-script will generate the activemq.xml configuration file and it will then move it to /etc/activemq/activemq.xml. The called subscript is It will feed from the following files to generate ActiveMQs configuration. A precise description of each file can be found below.

Once the new file has been generated, ActiveMQ has to be restarted. This is generally done by $ service activemq restart . If ActiveMQ refuses to start, it can be a sign that something is wrong inside the configuration file.


  • configs/activemq_raw_xml.xml The model for the ActiveMQ configuration file. It holds some static configurations and variables that will be replaced during parsing.
  • configs/activemq-configurator.cfg Some variables that will be put into the ActiveMQ configuration file can be set here.
  • /etc/msg-to-queue/msg-to-queue.conf This file holds the definitions of the message handlers. Part of the variables in the raw configuration file will be determined by the content of these files.

File Descriptions

This is a basic ActiveMQ XML configuration file. It already has the correct structure to fit ActiveMQs needs, but holds some variables that are defined with the following syntax :
See the activemq_raw_xml.xml sample files to get an idea.
This is a YAML formatted configuration file that holds variables such as the backbone broker address.

You fix variables in an easy =variable : 'value' = fashion.

Look at the activemq-configurator.cfg sample file and to the YAML website if you want to know more about it :

Here are the definitions for the message handlers. You can also put an include statement in it, and anything included will be loaded as well. Just check a sample definition to get an idea : msg-to-queue.conf

msg-to-handler (formerly msg-to-queue) old and new scheme

Backbone Bridging
Queues and topics from the backbone are all bridged to separate local queues on the local broker. Any wildcard character " * " or " > " will be replaced by " WC " in the local queue. So, for example, if the following have to be subscribed to on the backbone :

  • /queue/probe.job.return
  • /topic/global.*.output
  • /topic/global.>

They will be bridged to the following on the local broker :

  • /queue/probe.job.return
  • /queue/global.WC.output
  • /queue/global.WC

Basically, topics and queues become only topics on the local broker.


  • Previous local incoming message architecture:

  • New local incoming message architecture:
Topic attachments
I Attachment History Action Size Date Who Comment
Unknown file formatcfg activemq-configurator.cfg r1 manage 1.3 K 2009-08-28 - 16:05 JulienPerrochet2 activemq-configurator sample file.
XMLxml activemq_raw_xml.xml r1 manage 4.2 K 2009-08-28 - 16:06 JulienPerrochet2 Raw XML file used by the activemq-configurator
Unknown file formatconf msg-to-queue.conf r1 manage 1.4 K 2009-08-31 - 09:21 JulienPerrochet2 Sample message handler definition file
JPEGjpg new_arch.jpg r2 r1 manage 204.8 K 2009-08-28 - 15:55 JulienPerrochet2 New local incoming message architecture
JPEGjpg old_arch.jpg r1 manage 106.5 K 2009-08-28 - 15:51 JulienPerrochet2 Previous local incoming message architecture
Edit | Attach | Watch | Print version | History: r4 < r3 < r2 < r1 | Backlinks | Raw View | WYSIWYG | More topic actions
Topic revision: r4 - 2009-09-15 - unknown
    • Cern Search Icon Cern Search
    • TWiki Search Icon TWiki Search
    • Google Search Icon Google Search

    EGEE All webs login

This site is powered by the TWiki collaboration platform Powered by Perl This site is powered by the TWiki collaboration platformCopyright & by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Ask a support question or Send feedback