NAME

Alien::ActiveMQ - Manages installs of versions of Apache ActiveMQ, and provides a standard way to start an MQ server from perl.

SYNOPSIS

use Alien::ActiveMQ;

{
    my $mq = Alien::ActiveMQ->run_server
    
    # Apache MQ is now running on the default port, you
    # can now test your Net::Stomp based code
}
# And Apache MQ shuts down once $mq goes out of scope here

DESCRIPTION

This module, along with the bundled install-apachemq script, helps to manage installations of the Apache ActiveMQ message queueing software, from http://activemq.apache.org.

CLASS METHODS

run_server ([ $version ])

Runs an ActiveMQ server instance for you.

Returns a value which you must keep in scope until you want the ActiveMQ server to shutdown.

get_version_dir ([ $version ])

Returns a Path::Class::Dir object to where a particular version of ActiveMQ is installed.

If a version is not provided, then the latest available version at the time of writing (5.2.0) is used.

is_version_installed ([ $version ])

Returns true if the version directory for the supplied version exists.

get_license_file ([ $version ])

Returns a Path::Class::File object representing the text file containing the license for a particular version of Apache ActiveMQ.

TODO

This is the first release of this code, and as such, it is very light on features, and probably full of bugs.

Please see comments in the code for features planned and changes needed.

Patches (or forks on github) are, as always, welcome.

LINKS

http://activemq.apache.org/ - Apache ActiveMQ project homepage.

Net::STOMP - Interface to the Streamed Text Oriented Message Protocol in perl.

Catalyst::Engine::STOMP - Use the power of Catalyst dispatch to route job requests.

AUTHORS

Tomas Doran (t0m) <bobtfish@bobtfish.net>
Zac Stevens (zts) <zts@cryptocracy.com>

COPYRIGHT AND LICENSE

This software is copyright (c) 2009 by Tomas Doran.

This is free software; you can redistribute it and/or modify it under the same terms as perl itself.

Note that the Apache MQ code which is installed by this software is licensed under the Apache 2.0 license, which is included in the installed software.