Shaker tool consists of server and agent modules. The server is executed by shaker command
and is responsible for deployment of instances, execution of tests as specified in the scenario,
for results processing and report generation. The agent is light-weight and polls tasks from
the server and replies with the results. Agents have connectivity to the server, but the server does not
(so it is easy to keep agents behind NAT).

host:port - address of the machine where Shaker is installed and
port is some arbitrary free port to bind the server to;

scenario - file name of the scenario (yaml file);

report - file name where report will be saved.

Shaker verifies connection to OpenStack. The parameters are taken from set of os-* params or from the env (openrc).

Based on accommodation parameter the list of agents is generated.

The topology is deployed with help of Heat. The list of agents is extended with IP addresses and instance names.

Shaker waits for all agents to join. Once all agents are alive it means
that the quorum exists and everyone ready to execute the tests.

Shaker starts tests one by one in order they are listed in the scenario.
Test definition is converted into the actual command that will be
executed by agent. Shaker schedules the command to be started at the same
time on all agents. For networking testing only agents in master role
are involved. Slave agents are used as back-end for corresponding commands
(i.e. they run iperf in server mode).

Agents send their results to the server. Once all replies are received
the test execution meant to be finished. If some agent didn’t make it in
dedicated time it is marked as lost.

Once all tests are executed Shaker can output the raw result in JSON format
(if option --output is set).

Shaker clears the topology by calling Heat.

Shaker calculates statistics and aggregated charts. If there are any
SLA statements they are also evaluated, the result can be stored in subunit format
(if option --subunit is set).