Version 12 (modified by, 7 years ago) (diff)


GENI Desktop Tutorial (Summer Camp 2015 UConn)

1. Introduction

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
A general tutorial for the GENI Desktop
This page is located at

2. 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.

No image "basic_topo2.png" attached to GeniDesktop/Summer_Camp_2015

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

2. Introduction to OpenFlow

A brief introduction to OpenFlow can be found at [ ]

3. Flow Installation and Monitoring

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.

No image "aag_topo2.png" attached to GeniDesktop/Summer_Camp_2015

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

Attachments (5)

Download all attachments as: .zip