Metadata-Version: 2.0
Name: pyshaker
Version: 0.0.14
Summary: Distributed data-plane performance testing tool
Home-page: http://www.openstack.org/
Author: OpenStack
Author-email: openstack-dev@lists.openstack.org
License: UNKNOWN
Platform: UNKNOWN
Classifier: Environment :: OpenStack
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Requires-Dist: Jinja2 (>=2.6)
Requires-Dist: PyYAML (>=3.1.0)
Requires-Dist: iso8601 (>=0.1.9)
Requires-Dist: oslo.concurrency (>=2.3.0)
Requires-Dist: oslo.config (>=2.6.0)
Requires-Dist: oslo.i18n (>=1.5.0)
Requires-Dist: oslo.log (>=1.12.0)
Requires-Dist: oslo.serialization (>=1.10.0)
Requires-Dist: oslo.utils (>=2.4.0,!=2.6.0)
Requires-Dist: pbr (>=1.6)
Requires-Dist: psutil (>=1.1.1,<2.0.0)
Requires-Dist: pygal
Requires-Dist: pykwalify
Requires-Dist: python-glanceclient (>=0.18.0)
Requires-Dist: python-heatclient (>=0.6.0)
Requires-Dist: python-keystoneclient (>=1.6.0,!=1.8.0)
Requires-Dist: python-neutronclient (>=2.6.0)
Requires-Dist: python-novaclient (>=2.29.0,!=2.33.0)
Requires-Dist: python-subunit (>=0.0.18)
Requires-Dist: pyzmq (>=15.2.0)
Requires-Dist: six (>=1.9.0)

Shaker
======

**The distributed data-plane testing tool built for OpenStack.**

Shaker wraps around popular system network testing tools like
`iperf <https://iperf.fr/>`_, `iperf3 <https://iperf.fr/>`_
and netperf (with help of `flent <https://flent.org/>`_).
Shaker is able to deploy OpenStack instances and networks in different
topologies. Shaker scenario specifies the deployment and list of tests
to execute. Additionally tests may be tuned dynamically in command-line.

Features:

    * User-defined topology via Heat templates
    * Simultaneously test execution on multiple instances
    * Pluggable tools
    * Interactive report with stats and charts
    * Built-in SLA verification

Requirements:

    * Shaker server routable from OpenStack cloud
    * Admin-user access to OpenStack API

Setup:

 1. ``pip install pyshaker`` - installs the tool and all its python dependencies
 2. ``shaker-image-builder`` - builds shaker image and stores it in Glance


Run:

 ``shaker --server-endpoint <host:port> --scenario <scenario.yaml> --report <report.html>``

 where:
    * ``<host:port>`` - address of machine where Shaker is deployed and any free port
    * ``<scenario.yaml>`` - the scenario to execute; L2, L3 east-west and L3 north-south already included
    * ``<report.html>`` - file to store the report


Links:
 * PyPi - https://pypi.python.org/pypi/pyshaker/
 * Docs - http://pyshaker.readthedocs.org/
 * Bugtracker - https://launchpad.net/shaker/



