Skip to content
forked from ucb-sts/sts

Software-Defined Networking Troubleshooting Simulator

Notifications You must be signed in to change notification settings

colin-scott/sts

 
 

Repository files navigation

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).

sts architecture

Besides troubleshooting, sts can be used to programmatically generate integration tests and replayable execution traces.

Installation

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/

Running

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.

Dependencies

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

Will I need to modify my controller to use sts?

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).

Research

For more information about the research behind sts, see our paper draft.

Questions?

Send questions or feedback to: sts-dev@googlegroups.com

About

Software-Defined Networking Troubleshooting Simulator

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 86.7%
  • C 13.3%