Initial commit
diff --git a/README.rst b/README.rst
new file mode 100644
index 0000000..7bacebe
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,142 @@
+=========================
+RabbitMQ messaging system
+=========================
+
+RabbitMQ is a complete and highly reliable enterprise messaging system based on the emerging AMQP standard.
+
+Sample pillars
+==============
+
+Standalone Broker
+-----------------
+
+RabbitMQ as AMQP broker with admin user and vhosts
+
+.. code-block:: yaml
+
+ rabbitmq:
+ server:
+ enabled: true
+ bind:
+ address: 0.0.0.0
+ port: 5672
+ secret_key: rabbit_master_cookie
+ admin:
+ name: adminuser
+ password: pwd
+ plugins:
+ - amqp_client
+ - rabbitmq_management
+ virtual_hosts:
+ - enabled: true
+ host: '/monitor'
+ user: 'monitor'
+ password: 'password'
+
+RabbitMQ as a Stomp broker
+
+.. code-block:: yaml
+
+ rabbitmq:
+ server:
+ enabled: true
+ secret_key: rabbit_master_cookie
+ bind:
+ address: 0.0.0.0
+ port: 5672
+ virtual_hosts:
+ - enabled: true
+ host: '/monitor'
+ user: 'monitor'
+ password: 'password'
+ plugins:
+ - rabbitmq_stomp
+
+RabbitMQ cluster
+----------------
+
+RabbitMQ as base cluster node
+
+.. code-block:: yaml
+
+ rabbitmq:
+ server:
+ enabled: true
+ bind:
+ address: 0.0.0.0
+ port: 5672
+ secret_key: rabbit_master_cookie
+ admin:
+ name: adminuser
+ password: pwd
+ cluster:
+ enabled: true
+ role: master
+ mode: disc
+ members:
+ - name: openstack1
+ host: 10.10.10.212
+ - name: openstack2
+ host: 10.10.10.213
+
+HA Queues definition
+
+.. code-block:: yaml
+
+ rabbitmq:
+ server:
+ enabled: true
+ ...
+ virtual_hosts:
+ - enabled: true
+ host: '/monitor'
+ user: 'monitor'
+ password: 'password'
+ policies:
+ - name: HA
+ pattern: '^(?!amq\.).*'
+ definition: '{"ha-mode": "all"}'
+
+Usage
+=====
+
+Check cluster status, example shows running cluster with 3 nodes: ctl-1, ctl-2, ctl-3
+
+.. code-block:: yaml
+
+ > rabbitmqctl cluster_status
+
+ Cluster status of node 'rabbit@ctl-1' ...
+ [{nodes,[{disc,['rabbit@ctl-1','rabbit@ctl-2','rabbit@ctl-3']}]},
+ {running_nodes,['rabbit@ctl-3','rabbit@ctl-2','rabbit@ctl-1']},
+ {partitions,[]}]
+ ...done.
+
+Setup management user.
+
+.. code-block:: yaml
+
+ > rabbitmqctl add_vhost vhost
+ > rabbitmqctl add_user user alive
+ > rabbitmqctl set_permissions -p vhost user ".*" ".*" ".*"
+ > rabbitmqctl set_user_tags user management
+
+EPD process is Erlang Port Mapper Daemon. It's a feature of the Erlang runtime that helps Erlang nodes to find each other. It's a pretty tiny thing and doesn't contain much state (other than "what Erlang nodes are running on this system?") so it's not a huge deal for it to still be running.
+Although it's running as user rabbitmq, it was started automatically by the Erlang VM when we started. We've considered adding "epmd -kill" to our shutdown script - but that would break any other Erlang apps running on the system; it's more "global" than RabbitMQ.
+
+Read more
+=========
+
+* http://www.rabbitmq.com/admin-guide.html
+* https://github.com/saltstack/salt-contrib/blob/master/states/rabbitmq_plugins.py
+* http://docs.saltstack.com/ref/states/all/salt.states.rabbitmq_user.html
+* http://stackoverflow.com/questions/14699873/how-to-reset-user-for-rabbitmq-management
+* http://www.rabbitmq.com/memory.html
+
+Clustering
+==========
+
+* http://www.rabbitmq.com/clustering.html#auto-config
+* https://github.com/jesusaurus/hpcs-salt-state/tree/master/rabbitmq
+* http://gigisayfan.blogspot.cz/2012/06/rabbit-mq-clustering-python-fabric.html
+* http://docwiki.cisco.com/wiki/OpenStack_Havana_Release:_High-Availability_Manual_Deployment_Guide#RabbitMQ_Installation