diff --git a/.coveragerc b/.coveragerc index 97f08df7c..2aab3963c 100644 --- a/.coveragerc +++ b/.coveragerc @@ -1,8 +1,8 @@ [run] branch = True -omit = *marconi/openstack* +omit = *zaqar/openstack* [report] exclude_lines = - if __MARCONI_SETUP__: + if _ZAQAR_SETUP__: raise NotImplementedError diff --git a/HACKING.rst b/HACKING.rst index bd9648902..c705839ec 100644 --- a/HACKING.rst +++ b/HACKING.rst @@ -1,9 +1,9 @@ -Marconi Style Commandments -========================== +Zaqar Style Commandments +======================== - Step 1: Read the OpenStack Style Commandments http://docs.openstack.org/developer/hacking/ -- Step 2: Read on for Marconi specific commandments +- Step 2: Read on for Zaqar specific commandments General ------- @@ -74,11 +74,11 @@ More Import Examples **INCORRECT** :: - import marconi.queues.transport.wsgi as wsgi + import zaqar.queues.transport.wsgi as wsgi **CORRECT** :: - from marconi.queues.transport import wsgi + from zaqar.queues.transport import wsgi Docstrings ---------- diff --git a/README.rst b/README.rst index 23e467744..e713a3ac4 100644 --- a/README.rst +++ b/README.rst @@ -1,28 +1,28 @@ -Marconi -======= +Zaqar +===== Message queuing service for `OpenStack`_. To find more information read our `wiki`_. -Running a local Marconi server with MongoDB -------------------------------------------- +Running a local Zaqar server with MongoDB +----------------------------------------- -**Note:** These instructions are for running a local instance of Marconi and +**Note:** These instructions are for running a local instance of Zaqar 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:: +1. From your home folder create the ``~/.zaqar`` folder and clone the repo:: $ cd - $ mkdir .marconi - $ git clone https://github.com/openstack/marconi.git + $ mkdir .zaqar + $ git clone https://github.com/openstack/zaqar.git -2. Copy the Marconi config files to the directory ``~/.marconi``:: +2. Copy the Zaqar config files to the directory ``~/.zaqar``:: - $ cp marconi/etc/marconi.conf.sample ~/.marconi/marconi.conf - $ cp marconi/etc/logging.conf.sample ~/.marconi/logging.conf + $ cp zaqar/etc/zaqar.conf.sample ~/.zaqar/zaqar.conf + $ cp zaqar/etc/logging.conf.sample ~/.zaqar/logging.conf -3. Find ``[drivers]`` section in ``~/.marconi/marconi.conf`` +3. Find ``[drivers]`` section in ``~/.zaqar/zaqar.conf`` and specify to use mongodb storage:: storage = mongodb @@ -37,25 +37,25 @@ installed and running. uri = mongodb://127.0.0.1:27017 4. For logging, find the ``[DEFAULT]`` section in - ``~/.marconi/marconi.conf`` and modify as desired:: + ``~/.zaqar/zaqar.conf`` and modify as desired:: log_file = server.log 5. Change directories back to your local copy of the repo:: - $ cd marconi + $ cd zaqar 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 +7. Start the Zaqar server with logging level set to INFO so you can see the port on which the server is listening:: - $ marconi-server -v + $ zaqar-server -v -8. Test out that Marconi is working by creating a queue:: +8. Test out that Zaqar is working by creating a queue:: $ curl -i -X PUT http://127.0.0.1:8888/v1/queues/samplequeue -H "Content-type: application/json" @@ -86,6 +86,6 @@ You can read more about running functional tests in separate `TESTS_README`_. .. _`MongoDB` : http://docs.mongodb.org/manual/installation/ .. _`pyenv` : https://github.com/yyuu/pyenv/ .. _`virtualenv` : https://pypi.python.org/pypi/virtualenv/ -.. _`wiki` : https://wiki.openstack.org/wiki/Marconi -.. _`TESTS_README` : https://github.com/openstack/marconi/blob/master/tests/functional/README.rst +.. _`wiki` : https://wiki.openstack.org/wiki/Zaqar +.. _`TESTS_README` : https://github.com/openstack/zaqar/blob/master/tests/functional/README.rst diff --git a/bench-requirements.txt b/bench-requirements.txt index 14347ef8f..939afe982 100644 --- a/bench-requirements.txt +++ b/bench-requirements.txt @@ -2,4 +2,4 @@ argparse>=1.2.1 gevent>=1.0.1 marktime>=0.2.0 psutil>=2.1.1 -python-marconiclient>=0.0.2 +python-zaqarclient>=0.0.2 diff --git a/doc-test.conf b/doc-test.conf index 1e32a2dba..3245f4c87 100644 --- a/doc-test.conf +++ b/doc-test.conf @@ -1,6 +1,6 @@ [DEFAULT] -repo_name = marconi +repo_name = zaqar api_site=True file_exception = includewars.xml diff --git a/doc/pom.xml b/doc/pom.xml index b5350a368..79e34c8b0 100644 --- a/doc/pom.xml +++ b/doc/pom.xml @@ -7,8 +7,8 @@ 1.0.0-SNAPSHOT pom - marconi-api-ref - marconi-get-started + zaqar-api-ref + zaqar-get-started diff --git a/doc/source/api.rst b/doc/source/api.rst index 213443d0b..c59d74a1d 100644 --- a/doc/source/api.rst +++ b/doc/source/api.rst @@ -11,20 +11,20 @@ License for the specific language governing permissions and limitations under the License. -Using Marconi's Public APIs -=========================== +Using Zaqar's Public APIs +========================= -Marconi fully implements version 1.0 of the OpenStack Messaging API by now. -Generally, you can use any HTTP client to talk with Marconi public REST API, -though Marconi client is the recommended approach. +Zaqar fully implements version 1.0 of the OpenStack Messaging API by now. +Generally, you can use any HTTP client to talk with Zaqar public REST API, +though Zaqar client is the recommended approach. -Marconi Client +Zaqar Client ############################################ -We can easily access the Marconi REST API via Marconi client. Below is an example +We can easily access the Zaqar REST API via Zaqar client. Below is an example to create a queue, post messages to it and finally delete it:: - from marconiclient.queues.v1 import client + from zaqarclient.queues.v1 import client URL = 'http://localhost:8888' messages = [{'body': {'id': idx}, 'ttl': 360} for idx in range(20)] diff --git a/doc/source/conf.py b/doc/source/conf.py index 5730feea5..bc03247e9 100644 --- a/doc/source/conf.py +++ b/doc/source/conf.py @@ -1,6 +1,6 @@ # -*- coding: utf-8 -*- # -# Marconi documentation build configuration file, created by +# Zaqar documentation build configuration file, created by # sphinx-quickstart on Sat May 1 15:17:47 2010. # # This file is execfile()d with the current directory set @@ -63,14 +63,14 @@ source_suffix = '.rst' master_doc = 'index' # General information about the project. -project = u'marconi' +project = u'zaqar' copyright = u'2010-present, OpenStack Foundation' # The version info for the project you're documenting, acts as replacement for # |version| and |release|, also used in various other places throughout the # built documents. # -from marconi.version import version_info +from zaqar.version import version_info # The full version, including alpha/beta/rc tags. release = version_info.release_string() # The short X.Y version. @@ -115,7 +115,7 @@ show_authors = False pygments_style = 'sphinx' # A list of ignored prefixes for module index sorting. -modindex_common_prefix = ['marconi.'] +modindex_common_prefix = ['zaqar.'] # -- Options for man page output ---------------------------------------------- @@ -196,7 +196,7 @@ html_last_updated_fmt = os.popen(git_cmd).read() #html_file_suffix = '' # Output file base name for HTML help builder. -htmlhelp_basename = 'marconidoc' +htmlhelp_basename = 'zaqardoc' # -- Options for LaTeX output ------------------------------------------------- @@ -211,7 +211,7 @@ htmlhelp_basename = 'marconidoc' # (source start file, target name, title, author, documentclass # [howto/manual]). latex_documents = [ - ('index', 'Marconi.tex', u'Marconi Documentation', + ('index', 'Zaqar.tex', u'Zaqar Documentation', u'Anso Labs, LLC', 'manual'), ] diff --git a/doc/source/index.rst b/doc/source/index.rst index c1c766b69..0227fcdcf 100644 --- a/doc/source/index.rst +++ b/doc/source/index.rst @@ -11,12 +11,12 @@ License for the specific language governing permissions and limitations under the License. -Welcome to Marconi's documentation! -=================================== +Welcome to Zaqar's documentation! +================================= -Marconi is an OpenStack project to provide "Messaging as a service". +Zaqar is an OpenStack project to provide "Messaging as a service". -Marconi, as with all OpenStack projects, is written with the following design +Zaqar, as with all OpenStack projects, is written with the following design guidelines in mind: * **Component based architecture**: Quickly add new behaviors @@ -26,7 +26,7 @@ guidelines in mind: * **Open standards**: Be a reference implementation for a community-driven api This documentation is generated by the Sphinx toolkit and lives in the source -tree. Additional draft and project documentation on Marconi and other components of OpenStack can +tree. Additional draft and project documentation on Zaqar and other components of OpenStack can be found on the `OpenStack wiki`_. Cloud administrators, refer to `docs.openstack.org`_. .. _`OpenStack wiki`: http://wiki.openstack.org @@ -40,26 +40,26 @@ Concepts glossary -Installing/Configuring Marconi -============================== +Installing/Configuring Zaqar +============================ .. toctree:: :maxdepth: 1 installing -Operating Marconi -================= +Operating Zaqar +=============== .. toctree:: :maxdepth: 1 ha -Using Marconi -============= +Using Zaqar +=========== .. toctree:: :maxdepth: 1 - api \ No newline at end of file + api diff --git a/doc/source/installing.rst b/doc/source/installing.rst index 155a84fa6..bed1d04c8 100644 --- a/doc/source/installing.rst +++ b/doc/source/installing.rst @@ -115,39 +115,39 @@ Install uwsgi on web servers:: web# yum -y install python-pip web# pip install uwsgi -Configure OpenStack Marconi -########################### +Configure OpenStack Zaqar +######################### On the web servers run these commands:: - web# git clone https://github.com/openstack/marconi.git . - web# pip install . -r ./requirements.txt --upgrade --log /tmp/marconi-pip.log + web# git clone https://git.openstack.org/openstack/zaqar.git . + web# pip install . -r ./requirements.txt --upgrade --log /tmp/zaqar-pip.log -Create ``/srv/marconi`` folder to store related configuration files. +Create ``/srv/zaqar`` folder to store related configuration files. -Create ``/srv/marconi/marconi_uwsgi.py`` with the following content:: +Create ``/srv/zaqar/zaqar_uwsgi.py`` with the following content:: from keystoneclient.middleware import auth_token - from marconi.transport.wsgi import app + from zaqar.transport.wsgi import app app = auth_token.AuthProtocol(app.app, {}) -Create ``/srv/marconi/uwsgi.ini`` file with the following content:: +Create ``/srv/zaqar/uwsgi.ini`` file with the following content:: [uwsgi] http = 192.168.192.168:80 - daemonize = /var/log/marconi.log - pidfile = /var/run/marconi.pid + daemonize = /var/log/zaqar.log + pidfile = /var/run/zaqar.pid gevent = 2000 gevent-monkey-patch = true listen = 1024 enable-threads = true - module = marconi_uwsgi:app + module = zaqar_uwsgi:app workers = 4 The uwsgi configuration options above can be modified for different performance requirements. -Create a Marconi configuration file ``/etc/marconi.conf`` with the following content:: +Create a Zaqar configuration file ``/etc/zaqar.conf`` with the following content:: [DEFAULT] # Show more verbose log output (sets INFO log level output) @@ -161,7 +161,7 @@ Create a Marconi configuration file ``/etc/marconi.conf`` with the following con admin_mode = True # Log to this file! - log_file = /var/log/marconi-queues.log + log_file = /var/log/zaqar-queues.log debug = False verbose = False @@ -192,7 +192,7 @@ Create a Marconi configuration file ``/etc/marconi.conf`` with the following con [drivers:storage:mongodb] uri = mongodb://mydb0,mydb1,mydb2:27017/?replicaSet=catalog&w=2&readPreference=secondaryPreferred - database = marconi + database = zaqar partitions = 8 # Maximum number of times to retry a failed operation. Currently @@ -236,7 +236,7 @@ Create a Marconi configuration file ``/etc/marconi.conf`` with the following con Start the queuing service:: - #/usr/bin/uwsgi --ini /srv/marconi/uwsgi.ini + #/usr/bin/uwsgi --ini /srv/zaqar/uwsgi.ini Configure Pools diff --git a/doc/wadl/os-marconi-apiRef.wadl b/doc/wadl/os-zaqar-apiRef.wadl similarity index 99% rename from doc/wadl/os-marconi-apiRef.wadl rename to doc/wadl/os-zaqar-apiRef.wadl index 6ff504113..f8889c13f 100644 --- a/doc/wadl/os-marconi-apiRef.wadl +++ b/doc/wadl/os-zaqar-apiRef.wadl @@ -23,7 +23,7 @@ + xml:id="os-zaqar-v1">