Menu

Management plugin – preview release

The previously mentioned management plugin is now in a state where it's worth looking at and testing. In order to make this easy, I've made a special once-only binary release just for the management plugin (in future we'll make binary releases of it just like the other plugins). Download all the .ez files from here and install them as described here, then let us know what you think. (Update 2010-09-22: Note that the plugins referenced in this blog post are for version 2.0.0 of RabbitMQ. We've now released 2.1.0 - for this and subsequent versions you can get the management plugin from here).

After installation, point your browser at http://server-name:55672/mgmt/. You will need to authenticate as a RabbitMQ user (on a fresh installation the user "guest" is created with password "guest"). From here you can manage exchanges, queues, bindings, virtual hosts, users and permissions. Hopefully the UI is fairly self-explanatory.

The management UI is implemented as a single static HTML page which makes background queries to the HTTP API. As such it makes heavy use of Javascript. It has been tested with recent versions of Firefox, Chromium and Safari, and with versions of Microsoft Internet Explorer back to 6.0. Lynx users should use the HTTP API directly :)

The management plugin will create an HTTP-based API at http://server-name:55672/api/. Browse to that location for more information on the API. For convenience the documentation can also be obtained from our Mercurial server.

WARNING: The management plugin is still at an early stage of development. You should be aware of the following limitations:

  • Permissions are only enforced sporadically. If a user can authenticate with the HTTP API, they can do anything.
  • Installing the management plugin will turn on fine-grained statistics in the server. This can slow a CPU-bound server by 5-10%.
  • All sorts of other features may be missing or buggy. See the TODO file for more information.

Note: if you want to build the plugin yourself, you should be aware that right now the Erlang client does not work in the default branch, so you need a mix of versions. The following commands should work:

hg clone http://hg.rabbitmq.com/rabbitmq-public-umbrella
cd rabbitmq-public-umbrella
make checkout
hg update -r rabbitmq_v2_0_0 -R rabbitmq-server
hg update -r rabbitmq_v2_0_0 -R rabbitmq-codegen
hg update -r rabbitmq_v2_0_0 -R rabbitmq-erlang-client
hg clone http://hg.rabbitmq.com/rabbitmq-management
make
cd rabbitmq-management
make

Of course this will be fixed soon. (Ignore the above, this is fixed.)

Finally, this post would not be complete without some screenshots...

Tags: , , , ,

8 Responses to “Management plugin – preview release”

  1. links for 2010-09-07 – Chris Dalby Untangles Networks Says:

    [...] RabbitMQ » Blog Archive » Management plugin – preview release – Messaging that just wo... Management plugin for rabbitmq (tags: rabbitmq) [...]

  2. Twitter Trackbacks for RabbitMQ » Blog Archive » Management plugin - preview release - Messaging that just works [rabbitmq.com] on Topsy.com Says:

    [...] RabbitMQ » Blog Archive » Management plugin - preview release - Messaging that just works rabbitmq.com/blog/2010/09/07/management-plugin-preview-release/ – view page – cached RabbitMQ is a complete and highly reliable enterprise messaging system based on the emerging AMQP standard Tweets about this link [...]

  3. joe Says:

    I've got two users configured with full permissions ( development and guest ) and I can't for the life of me get either to work with this plugin. I've got it installed, rabbitmq is running fine, I'm getting the following error no matter if I use curl or the web interface:

    {error,{badrecord,user},
    [{rabbitmgmtutil,isauthorized,2},
    {webmachine
    resource,resourcecall,3},
    {webmachine
    resource,do,3},
    {webmachinedecisioncore,resourcecall,1},
    {webmachine
    decisioncore,decision,1},
    {webmachine
    decisioncore,handlerequest,2},
    {webmachinemochiweb,loop,1},
    {mochiweb
    http,headers,5}]}

    Any thoughts?

    Further info -
    list_users:
    Listing users ...
    development true
    guest true
    ...done.

    Listing permissions in vhost "/" ...
    development .* .* .* all
    guest .* .* .* all
    ...done.

  4. Simon MacMullen Says:

    Hi Joe. This looks like you're running the preview release linked here against 2.1.0 - is that accurate? If you're running 2.1.0 (or later) you need to get the plugin and its dependencies from the plugins page here. I've updated the blog post to make this clearer.

  5. joe Says:

    That was the problem Simon. Thanks for the quick response and helping me out. All works fine now. = ]

  6. Steve J Says:

    The new management plugin looks fantasic. One thing I don't see is the ability to purge a queue. Did I miss it? If it's not there, it would be nice to have feature.

    Thanks :-)

  7. Simon MacMullen Says:

    Steve: no queue purge as yet, but it's heading towards the top of the todo list.

  8. Steve J Says:

    Thanks, Simon. Looking forward to it.