shaker/README.rst

Shaker

The distributed data-plane testing tool for OpenStack.

Features

• User-defined topology via Heat templates
• Simultaneously test execution on multiple instances
• Pluggable tools
• Interactive report with stats and charts

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

• Launchpad - https://launchpad.net/shaker/
• Docs - http://pyshaker.readthedocs.org/
• PyPi - https://pypi.python.org/pypi/pyshaker/