[[PageOutline]]

= Tutorial:  Experimentation in a Multi-site GENI WiMAX Network using Orbit Management Framework (OMF) =

At TridentCom 2012, June 11, 2012  [[BR]]

Presenters: [[BR]]
Ivan Seskar (Rutgers WINLAB, North Brunswick, NJ, USA) [[BR]]
Fraida Fund (Polytechnic Institute of New York University, New York, USA)  [[BR]] 
Abhimanyu Gosain (GENI Project Office, Cambridge, USA)  [[BR]]
Harry Mussman (GENI Project Office, Cambridge, USA) [[br]]

Abstract:  [[BR]]
The tutorial provides attendees a hands-on experience using Orbit Management Framework (OMF) to define IP and Non-IP experiments across a multi-site GENI WiMAX deployment. The tutorial focuses on using OMF, a resource management, experiment control, and measurement framework to define and conduct experiments on a multi-site WiMAX deployment. This tutorial demonstrates the use of OMF experimenter tools to control and tune parameters of a complex WiMAX Base station to carefully collect and analyze test results in a repeatable manner. We will focus on the OMF interface for WiMAX and demonstrate the communication between WiMAX clients over the GENI layer two network. [[br]]



== 1.  Introduction to GENI WiMAX ==

'''Aim:''' Moitvation for GENI WiMAX, and brief overview.

[http://groups.geni.net/geni/attachment/wiki/GENIWiMaxTridentcomTutorial/Tridentcom.ppt Slides]  [[BR]]

In this section, we will introduce the motivation for GENI WiMAX sites also give a brief overview of the architecture of the WiMAX testbeds. [[br]]




== 2.  Arrangements for this tutorial ==

'''Aim:''' Learn how to login to WiMAX site.

Requirements: Active participants will need a laptop equipped with an SSH client (such as [http://www.chiark.greenend.org.uk/~sgtatham/putty/ Putty] for Windows) and a web browser. [[br]]

Participants will login to designated sites using their assigned credentials, to begin the hands-on portion of the tutorial.




== 3.  Starting an experiment ==

'''Aim:''' Learn how to reset a GENI WiMAX testbed to a usable state before starting an experiment.

Participants will learn how to begin an experiment with a "fresh slate" by loading a new disk image onto their nodes and resetting the WiMAX base station to its default state.[[br]]

[  Demo #3]  [[BR]]

[http://witestlab.poly.edu/index.php/tutorials/27-starting-an-experiment.html Instructions #3][[br]]

This requires coordination between different teams using the same BS, since only one team should reset a given BS at a time.



== 4.  Basic WiMAX RSSI experiment ==

'''Aim:''' Learn how to run a simple OMF experiment, connect to GENI WiMAX using OMF, and view captured data during and after the experiment.

Participants will run a simple OMF experiment in which two nodes are configured to connect to the GENI WiMAX network and their WiMAX RSSI and CINR is stored by OML and plotted on the web interface during experiment runtime. They also learn how to use the ''result'' service of the AM. [[br]]

[  Demo #4]  [[BR]]

[http://witestlab.poly.edu/index.php/tutorials/28-4-basic-wimax-rssi-experiment.html Instructions #4][[br]]

(Since several users will be running experiments on the same AM in parallel, not all users will find their web interface at port 4000.) [[br]]

This experiment does not require coordination between different teams using the same BS.[[BR]]



== 5.  Iperf UDP broadcast receiver experiment ==

'''Aim:''' Learn how to send/receive traffic over the WiMAX link.

Participants will extend the previous simple experiment. Each of their nodes will be assigned an IP address and will listen for UDP traffic from a broadcast sender, using iperf. The iperf bandwidth and packet loss will be plotted on the web interface. [[br]]

[  Demo #5]  [[BR]]

[http://witestlab.poly.edu/index.php/tutorials/29-5-iperf-udp-broadcast-receiver-experiment.html Instructions #5][[br]]

This experiment does not require coordination between different teams using the same BS.[[BR]]



== 6.  Saving BS configuration to OML ==

'''Aim:''' Learn how to retrieve and examine WiMAX BS configuration.

Participants will run an OML-ized script that retrieve the WiMAX BS config and stores it in an OML database. [[br]]

[  Demo #6]  [[BR]]

[http://witestlab.poly.edu/index.php/tutorials/31-6-saving-bs-config-to-oml.html Instructions #6][[br]]

This experiment does not require coordination between different teams using the same BS.



== 7.  Varying modulation and coding ==

'''Aim:''' Learn how to change the configuration on a GENI WiMAX BS.

Participants will run an OMF experiment that turns off adaptive modulation and coding, then varies the MCS used at regular intervals during experiment runtime. Participants can see the effect of varying MCS by observing the packet loss graph shown in the web interface. [[br]]

[  Demo #7]  [[BR]]

[http://witestlab.poly.edu/index.php/tutorials/30-7-varying-modulation-and-coding-experiment.html Instructions #7][[br]]

This experiment requires coordination between different teams using the same BS. Only one team should change the BS settings at a time.



== References ==


Documentation, tutorials, software tools  [[BR]]
http://witestlab.poly.edu (NYU-Poly Testbed) [[BR]]
http://wimax.orbit-lab.org (GENI WiMAX) [[BR]]
http://mytestbed.net (OMF) [[BR]]

Support [[BR]]
witestlab@poly.edu (NYU-Poly Testbed) [[BR]]
orbit-user@orbit-lab.org (WINLAB Testbed) [[BR]]
omf-user@lists.nicta.com.au (OMF) [[BR]]

== Tutorial Feedback  ==

[https://docs.google.com/spreadsheet/viewform?formkey=dEpqY1RVOTZQZ3RiVTBDdWdUMjV5RWc6MA#gid=0    Questionaire]  [[BR]]