sdn-cockpit is an open-source teaching framework for Software-defined Networking (SDN) developed by the Institute of Telematics, Karlsruhe Insitute of Technology.
The tool provides an easy-to-use environment for fast pace SDN application development with special support for executing automated evaluation scenarios. It builds on the mininet emulator (https://github.com/mininet/mininet) and the Ryu controller software (https://github.com/osrg/ryu). Vagrant is used for automatic deployment (https://www.vagrantup.com/).
sdn-cockpit supports Linux, macOS and Windows. It depdends on Vagrant and VirtualBox (https://www.virtualbox.org/), which need to be installed beforehand. Install sdn-cockpit with:
git clone https://github.com/KIT-Telematics/sdn-cockpit.git
cd sdn-cockpit
vagrant up
It seems that vagrant.exe ssh is currently not working properly when using git bash on windows. While the login into the virtual machine works, commands are not executed as expected (see hashicorp/vagrant#9143).
The easiest way to avoid this error is calling ssh directly (instead of using '''vagrant ssh'''):
ssh -p 2222 vagrant@127.0.0.1
Password as well as username are set to vagrant. If the above command fails, the port number might be different on your machine. You can see the port number in use (and more helpful information such as the username) by executing vagrant.exe ssh-config.
There is another easy workaround using the putty tool following these instructions: https://github.com/Varying-Vagrant-Vagrants/VVV/wiki/Connect-to-Your-Vagrant-Virtual-Machine-with-PuTTY
There is an issue with windows-style line endings. To fix this, run the following command inside the project folder (outside the VM, on the windows host):
git config core.autocrlf false && git config core.eol lf && git reset --hard
If this doesn't work, the following three executed inside the VM (i.e., after using vagrant ssh or putty) should fix the problem:
sudo apt-get install dos2unix
cd vagrant_data
find ./ -type f -exec dos2unix {} \;
Enter the virtual machine and execute sdn-cockpit:
vagrant ssh
bash run.sh
sdn-cockpit will now present a default view where no task is loaded. To load a task, open the folder sync/local/apps/src/ outside of the virtual machine and edit the corresponding task files with your favorite text editor. It must support unix-style line endings, e.g. Notepad++ (https://notepad-plus-plus.org/) for Windows. Upon saving, sdn-cockpit will automatically load the respective task and start evaluating your current solution.
You can find a comprehensive manual with more detailed installation and usage instructions here. It also includes a guide on writing Ryu-based SDN-applications.