performance-docs/doc/source/test_plans/tenant_networking/shaker.rst

Shaker

This section describes how to perform openstack_tenant_networking_test_plan with Shaker tool.

Test environment preparation

To run tests you will need a machine located outside of the cloud. This machine must be routable from OpenStack instances and need to have one open port to accept connections from Shaker agents. See more details in Shaker deployment guide.

Shaker is distributed as Python package and available through PyPi (https://pypi.python.org/pypi/pyshaker/). It is recommended to be installed inside virtualenv.

$ virtualenv venv
$ . venv/bin/activate
$ pip install pyshaker

The connection to OpenStack can be configured using standard openrc file. (Refer to http://docs.openstack.org/cli-reference/content/cli_openrc.html on how to retrieve it). Alternatively the configuration can be passed to Shaker via set of CLI parameters --os-tenant-name, --os-username, --os-password, --os-auth-url and --os-region-name. Connection to SSL endpoints is configured by parameters --os-cacert and --os-insecure. Note that it is highly recommended to run Shaker with admin user. Use of non-admin user is also possible though, see Running Shaker by non-admin user.

Before starting tests a master image must be built. The process downloads Ubuntu cloud image, installs all necessary packages and stores snapshot into Glance. This snapshot is used by shaker to boot instances.

$ shaker-image-builder

Running shaker tool starts a server that accepts connections from agents located on instances. In order to work user needs to specify host address and port number. The result may be stored in raw format (--json), in ReST (--book) or as interactive HTML report (--report).

Test Case 1: L2 instance-to-instance performance

Test case specification: openstack_tenant_networking_test_plan_l2

Execution:

shaker --server-endpoint <host:port> --scenario openstack/perf_l2 --book <report folder>

Test Case 2: L2 concurrent performance

Test case specification: openstack_tenant_networking_test_plan_l2_concurrent

Execution:

shaker --server-endpoint <host:port> --scenario openstack/full_l2 --book <report folder>

Test Case 3: L3 east-west instance-to-instance performance

Test case specification: openstack_tenant_networking_test_plan_l3_east_west

Execution:

shaker --server-endpoint <host:port> --scenario openstack/perf_l3_east_west --book <report folder>

Test Case 4: L3 east-west concurrent performance

Test case specification: openstack_tenant_networking_test_plan_l3_east_west_concurrent

Execution:

shaker --server-endpoint <host:port> --scenario openstack/full_l3_east_west --book <report folder>

Test Case 5: L3 north-south instance-to-instance performance

Test case specification: openstack_tenant_networking_test_plan_l3_north_south

Execution:

shaker --server-endpoint <host:port> --scenario openstack/perf_l3_north_south --book <report folder>

Test Case 6: L3 north_south concurrent performance

Test case specification: openstack_tenant_networking_test_plan_l3_north_south_concurrent

Execution:

shaker --server-endpoint <host:port> --scenario openstack/full_l3_north_south --book <report folder>

Test Case 7: Neutron QoS testing

Test case specification: openstack_tenant_networking_test_plan_qos

Execution:

shaker --server-endpoint <host:port> --scenario openstack/qos/perf_l2 --book <report folder>