OpenStack Messaging (Zaqar)

Go to file

kgriffs ecce97fd03 chore: Pass cache into drivers This patch plumbs storage drivers so they all get a cache instance they can use at their discretion. I decided to make cache a required param to the initializers, since any deployment of Marconi of any significance would likely opt to enable caching anyway, and the cache library has a default in-memory backend that can be used for simple deployments. Note also that both data- and control-plane drivers receive a cache instance, even though the sharding controllers will not use it (caching will be done in the sharding data driver instead.) I thought it would be better to pass cache in both cases so we can share test code and avoid complicating utils.load_storage_driver(). Also, the control driver may eventually support operations other than sharding; cache may come in handy then. Change-Id: I647791af0d7a5914c30cb2489033ec650a455370 Signed-off-by: kgriffs <kurt.griffiths@rackspace.com>		2013-12-03 11:55:24 -06:00
etc	Cleans up marconi-queues and marconi-proxy config files	2013-11-21 13:14:57 -06:00
marconi	chore: Pass cache into drivers	2013-12-03 11:55:24 -06:00
tests	chore: Pass cache into drivers	2013-12-03 11:55:24 -06:00
.coveragerc	Suppress some Coverage report output	2013-03-29 16:07:20 -04:00
.gitignore	Ignore *.egg dirs	2013-08-14 16:10:08 -05:00
.gitreview	Update .gitreview for incubation org move	2013-09-14 17:44:26 +00:00
AUTHORS.rst	refactor: Rename AUTHORS so that it doesn't keep getting overwritten	2013-03-19 16:33:43 -04:00
HACKING.rst	Update HACKING file with the new structure	2013-09-18 13:53:27 +02:00
MANIFEST.in	Initial import.	2012-11-01 09:52:20 +01:00
openstack-common.conf	chore: Update openstack.common, add lockutils	2013-08-29 14:49:36 -05:00
README.rst	Update the Marconi readme with more detailed installation instructions	2013-10-25 10:47:04 -05:00
requirements.txt	Merge "refactor: drop simplejson requirement"	2013-11-27 16:48:50 +00:00
setup.cfg	Merge "Revert "Support building wheels (PEP-427)""	2013-11-21 17:38:54 +00:00
setup.py	Update pbr and requirements to be current	2013-09-18 07:55:39 -07:00
test-requirements.txt	feat: split proxy API into admin and public apps	2013-10-01 17:31:40 -04:00
tox.ini	Update pbr and requirements to be current	2013-09-18 07:55:39 -07:00

README.rst

Marconi

Message queuing service for OpenStack

Running a local Marconi server with MongoDB

Note: These instructions are for running a local instance of Marconi and not all of these steps are required. It is assumed you have MongoDB installed and running.

From your home folder create the ~/.marconi folder and clone the repo:

$ cd
$ mkdir .marconi
$ git clone https://github.com/openstack/marconi.git

Copy the Marconi config files to the directory ~/.marconi:

$ cp marconi/etc/marconi-proxy.conf-sample ~/.marconi/marconi-proxy.conf
$ cp marconi/etc/marconi-queues.conf-sample ~/.marconi/marconi-queues.conf
$ cp marconi/etc/logging.conf-sample ~/.marconi/logging.conf

Find the [drivers:storage:mongodb] section in ~/.marconi/marconi-queues.conf and modify the URI to point to your local mongod instance:
```
uri = mongodb://$MONGODB_HOST:$MONGODB_PORT
```
For logging, find the [DEFAULT] section in ~/.marconi/marconi-queues.conf and modify as desired:
```
log_file = server.log
```
Change directories back to your local copy of the repo:
```
$ cd marconi
```
Run the following so you can see the results of any changes you make to the code without having to reinstall the package each time:
```
$ pip install -e .
```
Start the Marconi server:
```
$ marconi-server
```

Test out that Marconi is working by creating a queue:

$ curl -i -X PUT http://127.0.0.1:8888/v1/queues/samplequeue -H
"Content-type: application/json" -d '{"metadata": "Sample Queue"}'

You should get an HTTP 201 along with some headers that will look similar to this:

HTTP/1.0 201 Created
Date: Fri, 25 Oct 2013 15:34:37 GMT
Server: WSGIServer/0.1 Python/2.7.3
Content-Length: 0
Location: /v1/queues/samplequeue