Getting Started

Install

Easiest

CoilMQ is available on PyPI; as such, the simple way to get started is:

$ pip install CoilMQ

Still Pretty Easy

Alternatively, If you prefer, you can download a release and build it manually.

$ tar zxvf CoilMQ-0.1.tar.gz
$ cd CoilMQ-0.1
$ python setup.py install

Suggestion: virtualenv

Whether installing the Egg or building from source, it is often a convenient and wise idea to install software into a virtual environment.

Since CoilMQ uses the Distribute setuptools replacement, you will want to use virtualenv >= 1.4 with the --distribute option:

$ virtualenv --distribute --no-site-packages env
$ source env/bin/activate
(env) shell$ easy_install CoilMQ

Start Server

Assuming that your Python scripts install into a location on your path, you should be able to simply type:

$ coilmq

to start a basic STOMP server (using default values). Type coilmq -h to see other options. (See [CommandlineReference] and [ConfigurationReference] for more details on how to configure CoilMQ.)

Start Using

Grab a stomp.py and start interacting with the server!