This roll bundles AMQP RabbitMQ server and Pika client library, with python helper package implementing a linux daemon listening to an AMQP queue.
For more information about the various packages included in the rabbitmq roll please visit their official web pages:
- http://www.rabbitmq.com/ - RabbitMQ homepage
- http://pika.readthedocs.org/ - pika client library
To build/install this roll you must have root access to a Rocks development machine (e.g., a frontend or development appliance).
If your Rocks development machine does not have Internet access you must
download the appropriate rabbitmq source file(s) using a machine that does
have Internet access and copy them into the src/<package> directories on your
Rocks development machine.
Included in the roll:
- backports.ssl_match_hostname python package
- tornado python package
To build the rabbitmq-roll, execute these instructions on a Rocks development machine (e.g., a frontend or development appliance):
% make default 2>&1 | tee build.log
% grep "RPM build error" build.logIf nothing is returned from the grep command then the roll should have been
created as... rabbitmq-*.iso. If you built the roll on a Rocks frontend then
proceed to the installation step. If you built the roll on a Rocks development
appliance you need to copy the roll to your Rocks frontend before continuing
with installation.
The RabbitMQ server will be installed on a node having the RABBITMQ_Server attribute set up.
After the installation a script will be looking at /opt/rocks/etc waiting for rabbitmq_*.conf files to appear for an hour. Each such file should contain a random-generated password for its user/virtualhost which will be automatically added to RabbitMQ during this hour. The virtual host and user will be created and admin user will be given admin permissions for this virtual host. These files are expected to be on all nodes via 411 for applications to be able to communicate to the server.
Additionaly there will be /opt/rocks/etc/rabbitmq.conf file containing the hostname of the node having RabbitMQ server installed, also distributed via 411. The admin password will be stored in /opt/rocks/etc/rabbitmq-admin.conf file.
To install, execute these instructions on a Rocks frontend:
% rocks set host attr {host} RABBITMQ_Server True
% rocks add roll *.iso
% rocks enable roll rabbitmq
% cd /export/rocks/install
% rocks create distro
% rocks run roll rabbitmq | bash