Distributed data-plane performance testing tool
Go to file
Ilya Shakhat adf45de45c Update requirements and pin pyzmq
pyzmq version 15.0.0 requires C++ compiler to be present on system;
for Shaker use case it would be enough to use version 14.x.x

image builder templates are also updated, legacy netperf-wrapper
is not installed any longer

Change-Id: I0e2e6ac3cbbb966b0f4430591e3c89107e25db0a
2015-11-12 14:05:16 +03:00
doc/source Change repository from stackforge to openstack 2015-10-18 23:26:34 +05:30
etc Update from the global requirements 2015-08-04 15:57:10 +03:00
shaker Update requirements and pin pyzmq 2015-11-12 14:05:16 +03:00
tools Install the agent from pypi instead of git master 2015-05-12 15:53:36 +03:00
.gitignore Initial commit 2015-01-28 18:56:01 +03:00
.gitreview Update .gitreview for new namespace 2015-10-17 22:38:47 +00:00
.testr.conf Include tests into the package 2015-07-09 11:12:29 +03:00
LICENSE Initial commit 2015-01-28 18:56:01 +03:00
README.rst Add documentation 2015-05-14 19:51:30 +03:00
config-generator.conf Fix config processing for oslo.log 2015-03-03 17:38:25 +03:00
openstack-common.conf Use oslo.log lib instead of incunator code 2015-03-03 16:14:19 +03:00
requirements-agent.txt Update requirements and pin pyzmq 2015-11-12 14:05:16 +03:00
requirements.txt Update requirements and pin pyzmq 2015-11-12 14:05:16 +03:00
setup-agent.cfg Add separate setup config for building pyshaker-agent 2015-04-28 13:05:42 +03:00
setup.cfg Update readme file 2015-03-24 19:21:32 +03:00
setup.py Update requirements and pin pyzmq 2015-11-12 14:05:16 +03:00
test-requirements.txt Update from the global requirements 2015-08-04 15:57:10 +03:00
tox.ini Update from the global requirements 2015-08-04 15:57:10 +03:00

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