[[PageOutline]]

= GENI Desktop Tutorial (Summer Camp 2015 UConn) =

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] ||


== I. Basic GENI Desktop Operations ==

 * 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


== II. Introduction to OpenFlow ==

A brief introduction to OpenFlow can be found at [   ]


== III. Flow Installation and Monitoring ==

 * Part I: Setup
    * Step 1: Create two slices, one for the controller and one for an experiment using OVS nodes.
      * For the controller slice, drag one "AAG Controller" node to the canvas.
        Check "Public IP address" box for the controller node.
      * For the experiment slice with OVS nodes, create a topology consisting of of three OVS nodes and two Xen nodes as shown below.
    * Step 2: Figure out the public IP address of the controller after the controller slice is created.
    * Step 3: Run an initialization script "  " on all OVS nodes in the experiment.

 * Part II: Execute
    * Step 1: 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 2: 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