69c5ec1b93
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
69 lines
2.0 KiB
ReStructuredText
69 lines
2.0 KiB
ReStructuredText
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
|
|
|
|
|
|
.. _`OpenStack` : http://openstack.org/
|
|
.. _`MongoDB` : http://docs.mongodb.org/manual/installation/
|
|
.. _`pyenv` : https://github.com/yyuu/pyenv/
|
|
.. _`virtualenv` : https://pypi.python.org/pypi/virtualenv/
|
|
|