[[PageOutline]]

= GENI Desktop Tutorial (Summer Camp 2015 UConn) =

[[BR]]
== 1. Introduction ==
[[BR]]

This tutorial consists of three parts:

 * Basic GENI Desktop Operations
 * Brief Introduction to OpenFlow
 * Flow Installation and Monitoring in GENI Desktop

=== Important URLs ===

||  To use the GENI Desktop, go to ||   [https://genidesktop.netlab.uky.edu https://genidesktop.netlab.uky.edu] ||
|| A general tutorial for the GENI Desktop  ||  [http://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/GENIDesktop http://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/GENIDesktop] ||
|| This page is located at ||  [http://groups.geni.net/geni/wiki/GeniDesktop/Summer_Camp_2015 http://groups.geni.net/geni/wiki/GeniDesktop/Summer_Camp_2015] ||


[[BR]]
== 2. Basic GENI Desktop Operations ==
[[BR]]

=== Part I: Setup ===
     *  Follow the instructions of the general GENI Desktop tutorial to create a topology with three Xen nodes as shown below. 

[[Image(basic_topo2.png, 500px)]]

=== Part II: Excute ===

     *  Step 1: Copy a file to the selected nodes.
        * Download these two files (attachment:runs, attachment:runc) to a local directory.
        * Click "File Upload"
        * Click on "Browse" on the upright part of the window, Select both files you downloaded (runs, runc)
        * Click on "Upload Files to GENI Cloud" 
        * Highlight two nodes (A and B) in the topology window (click, then shift-click)
        * Click on "Set Selected Nodes"
        * Click on "Distribute" (The process is done when two green bars show up and then disappear)
        * Close the window for file upload

     *  Step 2: Run a command on the selected nodes. 
        * Click on "Command" 
        * Highlight all three nodes (A, B, and C) 
        * Click on "Set Selection"
        * Type "sudo apt-get install iperf" in the text box. 
        * Click on "Run Command" (The process is finished when green check mark appears)
        * Close the window for run command 

     *  Step 3: Monitor the traffic of the selected interface. 
        * Click on "Passive Graphs" 
        * From the drop-down menu for "Nodes", pick "B"
        * From the drop-down menu for "Graphs", pick "IP Traffic" and "TCP Graph"
        * Click on "LiveUpdate" to make it "LiveUpdate(On)"
        * Click on "ApplyConfig"
        * Scroll to show the traffic figures (IP and/or TCP)
        * Leave the traffic window there (Do not close it)

     *  Step 4: Login by ssh to the selected nodes.
        * Highlight node B
        * Click on "SSH"
        * Click on "Open Browser SSH"
        * Make sure file "runs" is there. Then type "sh runs".
        * Go back to GENI Desktop Tab/Window
        * Make sure the information window is open. 
        * Mouse over the link connecting nodes A and B, and write down the IP address of B. 
        * Highlight node A
        * Click on "SSH"
        * Click on "Open Browser SSH"
        * edit file "runc" and replace "IPaddr" with the IP address of B.
        * Type "sh runc" 
        * Go back to GENI Desktop Tab/Window. Observe the traffic window.
        * You can go to the tab/window for A and type "sh runc" mulitple times. See what happens in the traffic window. 

=== Part III: Finish ===
     *  Teardown experiment 


[[BR]]
== 2. Introduction to OpenFlow ==
[[BR]]

A brief introduction to OpenFlow can be found at [   ]


[[BR]]
== 3. Flow Installation and Monitoring ==
[[BR]]

=== Part I: Setup ===
    Create two slices, one for the controller and one for an experiment using OVS nodes.  
      * Step 1: Create the controller slice
        * Drag one "AAG Ctrl" node to the canvas.
        * Click on the node 
        * Check "Publicly Routable IP" box for the controller node. 
        * You may change the name of the node.
        * Click on "Site X" where X is a number. Choose any InstaGENI rack from the drop-down menu for Aggregate. 
        * Click on "Allocate resources using this RSPEC"
      * Step 2: Create the experiment slice with a topology consisting of of three OVS nodes and two Xen nodes as shown below. 
        * Drag "GD OVS" icon node to the canvas for the three OVS nodes. 
        * Drag "Xen VM" node to the canvas for the two hosts. 
        * Click on "Site X" to select an aggregate as above.
        * Allocate the resources.

[[Image(aag_topo2.png, 500px)]]


=== Part II: Execute ===
    * Step 1: Figure out the public IP address of the controller after the controller slice is created. 
    * Step 2: Run an initialization script "  " on all OVS nodes in the experiment. 
    * Step 3: Install, list, and delete flows on the experiment
      * Click on "Flow Install". Fill in the IP address of the controller.
      * Select a path in the topology and highlight it. 
      * Fill in the form to set the flow. 
      * You can also try list and delete flows. 
    * Step 4: Monitor per-flow performance 
      * Click on "Flow Monitor". 
      * Choose a flow to monitor at a selected node. 
      * Send traffic (ping, iperf, etc) from end host A to end host B in the experiment. 

=== Part III: Finish ===
    * Teardown experiment