-MQ admin notes
-========================================
+# MQ admin notes
-The design is resilient
+## The design is resilient
* There are two hosts, rapoport and rainier.
* The service will stay up if either is up.
* Individual connections will break, but the clients know how to reconnect
* All queues and exchanges configured to be created as durable by default
-The design is reasonably secure
+## The design is reasonably secure
* All connections are over SSL, using the autoca host certs
* The default guest account has been removed
* All d.o machines have autogenerated passwords
-Admin tools
+## Admin tools
* Web consoles
* https://rainier.debian.org:15672
* https://rapoport.debian.org:15672
* https://rapoport.debian.org:15672/cli/
* Download the rabbitmqadmin tool and put in ~/bin
* set up ~/.rabbitmqadmin.conf. Passwords on handel
-[rainier]
-hostname = rainier.debian.org
-port = 15672
-username = admin
-password = XXX
-ssl = True
-
-[rapoport]
-hostname = rapoport.debian.org
-port = 15672
-username = admin
-password = XX
-ssl = True
-
-A word about terminology:
+
+Sample `.rabbitmqadmin.conf`:
+
+ [rainier]
+ hostname = rainier.debian.org
+ port = 15671
+ username = admin
+ password = XXX
+ ssl = True
+
+ [rapoport]
+ hostname = rapoport.debian.org
+ port = 15671
+ username = admin
+ password = XX
+ ssl = True
+
+## A word about terminology:
pubsub messaging involves a sender and a receiver.
The sender connects to an exchange, and publishes a message. The sender