How to Contribute

Gems

Install the gems you will need:

[sudo] gem install cucumber rspec yaml stomp amqp bunny beanstalk-client

You should be able to run the rspec code examples (specs) without any brokers running with autospec or ‘rake spec’.

To run the cucumber features you will need the a messaging system setup that can speak stomp and AMQP. We have been using the following brokers in testing:

Apache ActiveMQ (for the stomp adapter)

Download the latest version here, and see read the installation and configuration instructions .
The stomp client and features should work with ApacheMQ out of the box. If you are running any ApacheMQ servers in production on your network you will want to disable the multicast autodiscovery in conf/activemq.xml. (Around lines 56 and 98.)

RabbitMQ (for the amqp adapter)

Download the right tar from here and follow the installation directions that comes with it.

Or, if you are on OSx and using macports you can run:

sudo port install rabbitmq-server

Or if you are using homebrew:

brew install rabbitmq

The features rely on a user of ‘rosetta’ being setup with the password of ‘password’ and added to the default virtualhost. You can set them up like so:

  rabbitmqctl add_user rosetta password
  rabbitmqctl map_user_vhost rosetta /