OpenStack Messaging (Zaqar)

Go to file

Flavio Percoco e43e7e7101 Deprecate sqlite in favor of sqlalchemy Since the default engine used by the new sqlalchemy driver is sqlite, it doesn't make sense to keep the sqlite driver around. This patch replaces all usages of `sqlite` with `sqlalchemy`. Although sqlite is being deprecated, the patch keeps the entry point for backwards compatibility so that environments currently using the sqlite backend won't be suddenly broken. Implement blueprint: sql-storage-driver Change-Id: Ib7e32fa56ab0c6621dc9a888feb6b0e4981b4e91		2014-03-04 09:15:50 +01:00
etc	feat(sql/driver): expose ControlDriver, more config	2014-02-17 17:01:25 +02:00
marconi	Deprecate sqlite in favor of sqlalchemy	2014-03-04 09:15:50 +01:00
tests	Deprecate sqlite in favor of sqlalchemy	2014-03-04 09:15:50 +01: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
.testr.conf	Use testr instead of nosetest	2014-01-17 15:43:49 +01: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	Sync oslo-cache from oslo-incubator	2014-01-23 11:44:54 +01:00
README.rst	doc(README): Have the user pass '-v' when starting marconi-server	2014-02-17 15:41:09 -06:00
requirements.txt	Updated from global requirements	2014-02-26 23:28:20 +00:00
setup.cfg	Deprecate sqlite in favor of sqlalchemy	2014-03-04 09:15:50 +01:00
setup.py	Update pbr and requirements to be current	2013-09-18 07:55:39 -07:00
test-requirements.txt	Updated from global requirements	2014-02-23 09:25:56 +00:00
tox.ini	chore: Add pylint envs	2014-01-23 12:21:07 -06: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.conf-sample ~/.marconi/marconi.conf
$ cp marconi/etc/logging.conf-sample ~/.marconi/logging.conf

Find the [drivers:storage:mongodb] section in ~/.marconi/marconi.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.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 with logging level set to INFO so you can see the port on which the server is listening:
```
$ marconi-server -v
```

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