See http://ucb-sts.github.com/sts/ for an html version of this file.
Ever had to painstakingly dig through logs to find the one or two inputs that lead your controller software to break? sts seeks to eliminate this need, freeing you to debug the problematic code itself.
sts is intended for distributed SDN control software such as Floodlight. sts simulates the devices of your network, allowing fine-grained control over the inputs to your unmodified controller(s).
Besides troubleshooting, sts can be used to programmatically generate integration tests and replayable execution traces.
sts depends on pox. To install sts, you'll just need to clone both repositories:
$ git clone git://github.com/ucb-sts/sts.git
$ cd sts
$ git clone -b debugger git://github.com/noxrepo/pox.git pox/
Take sts for a test drive with:
$ ./simulator.py
This will boot up pox, generate a FatTree network with 16 hosts, and begin feeding in random inputs.
You can also run sts interactively:
$ ./simulator.py -c config.interactive
Finally, you can use sts to replay previous executions of your controller and automatically identify fault-inducing inputs:
$ ./simulator.py -c config.troubleshoot_pox_l2_learning
The config/ directory contains sample configurations. You can specify your own config file by specifying its path:
$ ./simulator.py -c config/my_config.py
See config/README for more information.
sts requires python 2.7+
To use the replay features of sts, you will need to install and make two dependencies:
$ sudo pip install pytrie
$ cd sts/headerspace/hassel-c && make -j
If your controller supports OpenFlow 1.0, sts works out of the box. You'll only need to change one line in the config file to instruct sts how to launch your controller process(es).
For more information about the research behind sts, see our paper draft.
Send questions or feedback to: sts-dev@googlegroups.com