AMQP server: RabbitMQ

RabbitMQ is an excellent low-level messaging server. You can use it with different technologies.

Requirements

You need PostgreSQL + Python

apt-get install postgresql python3
apt-get install python3-amqplib

Installation

Add repository

You must add a new repository for RabbitMQ.

• Even though the name is "testing" it's actually the latest stable version
• They use "testing" as this is not in the "main" Ubuntu repo yet.

[source: http://www.rabbitmq.com/install-debian.html]

vim /etc/apt/sources.list

Add the new repository

deb http://www.rabbitmq.com/debian/ testing main

Add repo key

wget http://www.rabbitmq.com/rabbitmq-signing-key-public.asc
sudo apt-key add rabbitmq-signing-key-public.asc

Update package list

sudo apt-get update

Binary installation

apt-get install rabbitmq-server amqp-tools

Enable plugins

Enable RabbitMQ command line client

rabbitmq-plugins enable amqp_client

Enable web console

rabbitmq-plugins enable rabbitmq_management

Restart server to take on your changes

service rabbitmq-server restart

Now you can access RabbitMQ using the default ports:

• Web console: TCP 15672, http://localhost:15672/
• AMQP Messages: TCP 5672

Create administration user

Create new user, replace rtd by your username.

rabbitmqctl add_user rtd  strong_password

Set user rights

rabbitmqctl set_user_tags rtd administrator
rabbitmqctl set_permissions -p / rtd ".*" ".*" ".*"

Remove default guest user

rabbitmqctl delete_user guest

Restart service to take on your changes

service rabbitmq-server restart

Advanced configuration

Change port number

source: https://www.rabbitmq.com/configure.html

If activeMq is install, stop it

service activemq stop

Create or update the configuration file:

vim /etc/rabbitmq/rabbitmq-env.conf

Add the following at the beginning of the file

NODE_PORT=5673

Restart server

service rabbitmq-server restart

Firewall

You must let the OUTPUT unfiltered because RabbitMQ port is dynamic.

You have to open Input TCP 5672 (messages), TCP 15672 (web interface).

vi /etc/init.d/firewall

Add this rules

#rabbitMq
$IPT -A INPUT -p tcp --dport 15672 -j ACCEPT
$IPT -A INPUT -p tcp --dport 5672 -j ACCEPT

Update startup

The server should start at every reboot. The following hack is only required if your installation is old or buggy.

cd /etc/init.d/
update-rc.d rabbitmq-server defaults

Apache 2 proxy

You can put RabbitMQ behind a proxy using the following configuration:

Edit your Apache2 configuration:

vim /etc/apache2/sites-enabled/mySuperSite.conf

Set the following settings:

# Enable proxy
ProxyVia On
ProxyPreserveHost On
ProxyRequests Off
ProxyErrorOverride Off
<Proxy *>
    AddDefaultCharset off
    Order deny,allow
    Allow from all
    Satisfy Any
</Proxy>

## Proxy to RabbitMQ
<Location /rabbitmq/>
   ProxyPass http://smartcard-mq:15672/
   ProxyPassReverse http://smartcard-mq:15672/
   Order deny,allow
   Deny from all
   Allow from 127.0.0.1 172.16.50.0/24 192.168.1.0/24
</Location>

References

• https://www.rabbitmq.com/management-cli.html
• https://www.rabbitmq.com/configure.html
• https://www.rabbitmq.com/tutorials/tutorial-two-python.html