openstack
/
zaqar
Code Issues Proposed changes
OpenStack Messaging (Zaqar)
609 Commits 9 Branches 41 Tags 45 MiB
Python 96.5%
PHP 1.4%
Shell 1.1%
HTML 0.7%
Lua 0.2%
Go to file
kgriffs 69c5ec1b93 doc(README): Have the user pass '-v' when starting marconi-server 
Users sometimes get confused when maconi-server doesn't print out anything
about which IP and port it is listening on. Recommend passing '-v' so they
learn this trick right off the bat.

Change-Id: I49cd29566b18506fad4f9450ba46159f0a75590d
 		2014-02-17 15:41:09 -06:00
etc fix(wsgi): Cleanup limit config options 2014-02-11 20:33:10 +00:00
marconi Merge "Fix two small typos in marconi/queues/storage/sharding.py" 2014-02-17 17:40:31 +00:00
tests Merge "Use six.moves.urllib.parse instead of urlparse" 2014-02-17 14:10:41 +00: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
README.rst doc(README): Have the user pass '-v' when starting marconi-server 2014-02-17 15:41:09 -06:00
openstack-common.conf Sync oslo-cache from oslo-incubator 2014-01-23 11:44:54 +01:00
requirements.txt Merge "chore: Sync local (marconi) requirements with global reqs" 2014-01-09 18:00:12 +00:00
setup.cfg Add a _config_options function to Marconi 2014-01-23 19:31:58 +01:00
setup.py Update pbr and requirements to be current 2013-09-18 07:55:39 -07:00
test-requirements.txt fix(testtools): 0.9.35 is not compatible with subunit 0.0.17 2014-01-29 12:50:00 -06: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.

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

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

  2. 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

  3. 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

  4. For logging, find the [DEFAULT] section in ~/.marconi/marconi.conf and modify as desired:

    log_file = server.log

  5. Change directories back to your local copy of the repo:

    $ cd marconi

  6. 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 .

  7. 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

  8. 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