= SDN Tutorial Using GENIDesktop and Adopt-A-GENI =

The [wiki:AAG 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.


=== Goals ===
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

=== Prerequisites ===
 * 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)

=== Tools ===
 * Latest version of Firefox or Google Chrome browser
 * Pop-up blockers and Javascript blockers disabled

== 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 [http://www.openvswitch.org/ 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:
 [[Image(topo.png)]]