[[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 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, runs], [attachment:runc, runc]) to a local directory.
        * Click "Upload File"
        * Highlight two nodes (A and B)
        *
     *  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"
     *  Step 3: Monitor the traffic of the selected interface.
     *  Step 4: Login by ssh to the selected nodes.
 * 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