<commit_before>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::

    $ marconi-server

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<commit_msg>doc(README): Have the user pass '-v' when starting marconi-server<commit_after>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
{'fraction_non_alphanumeric': 0.12853185595567868, 'fraction_numerical': 0.02437673130193906, 'mean_word_length': 3.0211581291759466, 'pattern_counts': {'":': 2, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 2, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 2, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '5118656', 'n_tokens_mistral': 1215, 'n_tokens_neox': 1130, 'n_words': 448}