openstack/zaqar
Code Issues Proposed changes

Updates the readme.rst file to add dependencies steps

Browse Source 
This patch adds some directions explaining what are the required
dependencies accordingly to the distribution being used in order
to install Zaqar correctly

Change-Id: Idca091b58316d06cb3482f7ab691a690628617ee
Closes-Bug: #1433247
This commit is contained in:
Akanksha08
2015-03-19 16:28:10 +00:00
parent e2da5768c7
commit a98a9260f2
1 changed files with 18 additions and 13 deletions
Download Patch File Download Diff File Expand all files Collapse all files

31
README.rst
View File

@@ -11,20 +11,29 @@ Running a local Zaqar server with MongoDB
all of these steps are required. It is assumed you have `MongoDB`_ and `tox` all of these steps are required. It is assumed you have `MongoDB`_ and `tox`
(see "Running tests" section below) installed and running. (see "Running tests" section below) installed and running.
1. From your home folder create the ``~/.zaqar`` folder and clone the repo:: 1. Install prerequisites:
# Ubuntu/Debian:
sudo apt-get install gcc python-pip libxml2 libxml2-dev libxslt libxslt-dev
# Fedora/RHEL:
sudo yum install gcc python-pip libxml2 libxml2-devel libxslt libxslt-devel
2. From your home folder create the ``~/.zaqar`` folder and clone the repo::
$ cd $ cd
$ mkdir .zaqar $ mkdir .zaqar
$ git clone https://github.com/openstack/zaqar.git $ git clone https://github.com/openstack/zaqar.git
2. Generate and copy the Zaqar config files to the directory ``~/.zaqar``:: 3. Generate and copy the Zaqar config files to the directory ``~/.zaqar``::
$ pip install tox
$ cd zaqar $ cd zaqar
$ tox -e genconfig $ tox -e genconfig
$ cp etc/zaqar.conf.sample ~/.zaqar/zaqar.conf $ cp etc/zaqar.conf.sample ~/.zaqar/zaqar.conf
$ cp etc/logging.conf.sample ~/.zaqar/logging.conf $ cp etc/logging.conf.sample ~/.zaqar/logging.conf
3. Find ``[drivers]`` section in ``~/.zaqar/zaqar.conf`` 4. Find ``[drivers]`` section in ``~/.zaqar/zaqar.conf``
and specify to use mongodb storage:: and specify to use mongodb storage::
storage = mongodb storage = mongodb
@@ -38,26 +47,26 @@ all of these steps are required. It is assumed you have `MongoDB`_ and `tox`
uri = mongodb://127.0.0.1:27017 uri = mongodb://127.0.0.1:27017
4. For logging, find the ``[DEFAULT]`` section in 5. For logging, find the ``[DEFAULT]`` section in
``~/.zaqar/zaqar.conf`` and modify as desired:: ``~/.zaqar/zaqar.conf`` and modify as desired::
log_file = server.log log_file = server.log
5. Change directories back to your local copy of the repo:: 6. Change directories back to your local copy of the repo::
$ cd ~/zaqar $ cd ~/zaqar
6. Run the following so you can see the results of any changes you 7. 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:: make to the code without having to reinstall the package each time::
$ pip install -e . $ pip install -e .
7. Start the Zaqar server with logging level set to INFO so you can see 8. Start the Zaqar server with logging level set to INFO so you can see
the port on which the server is listening:: the port on which the server is listening::
$ zaqar-server -v $ zaqar-server -v
8. Test out that Zaqar is working by creating a queue:: 9. Test out that Zaqar is working by creating a queue::
$ curl -i -X PUT http://127.0.0.1:8888/v1.1/queues/samplequeue -H $ curl -i -X PUT http://127.0.0.1:8888/v1.1/queues/samplequeue -H
"Content-type: application/json" "Content-type: application/json"
@@ -74,11 +83,7 @@ similar to this::
Running tests Running tests
------------- -------------
First install additional requirements:: Run tests using the following command::
$ pip install tox
And then run tests::
$ tox -e py27 $ tox -e py27