To get started install these softwares on your host machine:

1. Install Vagrant, it is a wrapper around virtualization softwares like VirtualBox, VMWare etc.: http://www.vagrantup.com/downloads

2. Install VirtualBox, this would be your VM provider: https://www.virtualbox.org/wiki/Downloads

3. Install Git, it is a distributed version control system: https://git-scm.com/downloads

4. Install X Server and SSH capable terminal

   • For Windows install Xming and Putty.
   • For MAC OS install XQuartz and Terminal.app (builtin)
   • Linux comes pre-installed with X server and Gnome terminal + SSH (buitlin)

• Clone this repository from Github and enter its directory.

• Now run the vagrant up command. This will read the Vagrantfile from the current directory and provision the VM accordingly:

$ vagrant up

• Access the VM through ssh - user: vagrant, password: vagrant

• Clone the supercharged_sdx repository from Github into the VM:

$ git clone https://github.com/nsg-ethz/SIDR.git

The provisioning scripts will install all the required software (and their dependencies) to run the SDX demo. Specifically it will install:

• Ryu
• Quagga
• [MiniNExT](https://github.com/USC-NSL/miniNExT.git miniNExT/)
• Exabgp

• Make sure that the following two directories exist: /home/vagrant/SIDR/xctrl/loop_detection/cibs and /home/vagrant/SIDR/xctrl/route_server/ribs.

There are multiple examples in the examples directory.