Version 9 (modified by, 5 years ago) (diff)


SDN Tutorial Using GENIDesktop and Adopt-A-GENI

The Adopt-A-GENI project makes it easy to incorporate SDN network resources into a GENI experiment.

This tutorial will guide you through the automatic process of setting up a Software-Defined Networking experiment using the GENIDesktop. You will perform flow management and monitoring tasks using the GENIDesktop's modules and the topology view of the experiment.


In this experiment you will learn how to do the following tasks:

  • Enable Adopt-A-GENI (AAG) features in the GENI Desktop
  • Setup an SDN experiment using OVS and Floodlight/RYU controller with NO manual configuration
  • Setup and configure shortest path flows for communication between hosts through a graphical module
  • Interact with the topology view of the network to install custom flows
  • Live monitor flow counters present at installed flow rules
  • Distribute a single flow entry to multiple OVS nodes


  • A GENI account, if you don't already have one XXXXXsign-up!
  • Familiarity with reserving GENI resources using JACKS. See Jacks XXXXXA First Experiment Using GENI and Jacks Tool
  • Familiarity with the UNIX command line and networking tools (e.g. ssh, ping, iperf)


  • Latest version of Firefox or Google Chrome browser
  • Pop-up blockers and Javascript blockers disabled

Where to get help:

Tutorial Instructions


  1. Create the Experiment:
    • Login to the GENIDesktop As usual. If you need help see the GENIDesktop Manual Login page.
    • Create a your slice as usual. If you need help see the GENIDesktop Manual Create A Slice page.
    • Allocate Resources for the topology below using JACKS in the GENIDesktop. If you need help see the GENIDesktop Manual JACKS page (but we are not using the topology listed on that page).
  1. Running Experiments: Load and execute code
  2. Viewing Traffic: SSH into nodes, generate and view traffic
  3. GENIDesktop CLI: Perform GENIDesktop operations using a Command Line Interface.

Create Experiment

  1. Login to GENIDesktop

1.1 === Create Slice === 1.2 === Allocate Resources using JACKS and the GENIDesktop ===

1.3 ==== Wait for slice to be allocated and instrumentized ===

In this tutorial we will be using Open vSwitch (OVS) to represent OpenFlow Software Switches and XEN VMs to represent hosts. The controller node is automatically added by the GENIDesktop. The general topology is:

Attachments (9)

Download all attachments as: .zip