openstack
/
zaqar
Code Issues Proposed changes
OpenStack Messaging (Zaqar)
757 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
Andreas Jaeger ec6c6ea0f9 Prepare marconi for localization 
Setup configuration for localization and add
initial translation template like it's done for all other OpenStack
projects. Once this is in, we can add the usual translation bot job to
sync translations with transifex.

Change-Id: Ia3be79e8ddfa9d68474e5a2bb2c7928ec5beca96
 		2014-06-04 22:31:55 +02:00
doc Fixing some spelling, grammar, etc in docs 2014-05-08 15:01:43 -05:00
etc Add a help text for auth_strategy 2014-03-28 09:23:19 +01:00
marconi Prepare marconi for localization 2014-06-04 22:31:55 +02:00
tests Merge "Fix sqlalchemy storage driver for Python 3" 2014-06-03 09:56:41 +00:00
tools/config Add keystone_authtoken to our config generator 2014-03-26 09:29:59 +01:00
.coveragerc Suppress some Coverage report output 2013-03-29 16:07:20 -04:00
.gitignore adds docs directory with dev guide 2014-03-18 14:48:54 -04: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 Dedup HACKING.rst and remove any pep8 or OpenStack hacking rules 2014-04-02 16:36:16 -07:00
LICENSE Include full license text 2014-03-21 10:16:28 +01:00
MANIFEST.in Initial import. 2012-11-01 09:52:20 +01:00
README.rst Add default mongod URI to README 2014-03-19 22:19:36 -04:00
babel.cfg Prepare marconi for localization 2014-06-04 22:31:55 +02:00
doc-test.conf adds docs directory with dev guide 2014-03-18 14:48:54 -04:00
openstack-common.conf Synced jsonutils from oslo-incubator 2014-05-27 12:16:28 +02:00
requirements-py3.txt Updated from global requirements 2014-05-30 16:26:31 +00:00
requirements.txt Updated from global requirements 2014-05-30 16:26:31 +00:00
setup.cfg Prepare marconi for localization 2014-06-04 22:31:55 +02:00
setup.py Updated from global requirements 2014-04-30 02:40:38 +00:00
test-requirements-py3.txt Updated from global requirements 2014-05-30 16:26:31 +00:00
test-requirements.txt Updated from global requirements 2014-05-30 16:26:31 +00:00
tox.ini Removed now unnecesary workaround for PyPy 2014-06-04 13:24:14 +00:00

README.rst

Marconi

Message queuing service for OpenStack. To find more information read our wiki.

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 [drivers] section in ~/.marconi/marconi.conf and specify to use mongodb storage:

    storage = mongodb

    Then find the [drivers:storage:mongodb] section and modify the URI to point to your local mongod instance:

    uri = mongodb://$MONGODB_HOST:$MONGODB_PORT

    By default, you will have:

    uri = mongodb://127.0.0.1:27017

  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"

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

Running tests

First install additional requirements:

pip install tox

And then run tests:

tox -e py27

You can read more about running functional tests in separate TESTS_README.