= 18. GEC13: Tutorials from Poly@NYU =

== Description ==
These are hand-on tutorials which provide experience in creating and executing WiMAX experiments on the orbit-lab WiMAX testbed. The original experiments are written by Fraida Fund from Poly@NYU. The following is a link to the original experiments that can be run on [http://witestlab.poly.edu/index.php/tutorials.html WITest].

The experiments have been modified to run on the WiMAX testbed in the orbit-lab. The following modifications were done to get the experiment running:[[BR]]
 a. Added /usr/bin/wmxstat to a baseline WiMAX image that run on the node.[[BR]]
 b. Added /usr/share/omf-expctl-5.3/repository/test/app/wimaxcu_app.rb in the experiment controller (sb4). [http://wimax.orbit-lab.org/attachment/wiki/WiMAX/30/07/wimaxcu_app.rb Click here to view file.] [[BR]]
 c. Added the following snippet to /usr/share/omf-expctl-5.3/repository/test/app/iperf.rb in the experiment controller (sb4). [http://wimax.orbit-lab.org/attachment/wiki/WiMAX/30/07/iperf.rb Click here to view file.] [[BR]]
{{{
  a.defMeasurement("UDP_Rich_Info"){ |m|
    m.defMetric('ID', :long)
    m.defMetric('Begin_interval', :float)
    m.defMetric('End_interval', :float)
    m.defMetric('Transfer', :float)
    m.defMetric('Bandwidth', :float)
    m.defMetric('Jitter', :float)
    m.defMetric('Packet_Lost', :long)
    m.defMetric('Total_Packet', :long)
    m.defMetric('PLR', :float)
  }
}}}

 d. The experiment description was also modified to:
  i. reflect the node's host name for sandbox 4.
  ii. added network configuration for the wimax interface
  iii. use ''properties'' to change pass different node host name from command line.

The following are the experiment description scripts.
 * [http://wimax.orbit-lab.org/attachment/wiki/WiMAX/30/07/gec13_tut01.rb gec13_tut01.rb] [[BR]]
 * [http://wimax.orbit-lab.org/attachment/wiki/WiMAX/30/07/gec13_tut02.rb gec13_tut02.rb] [[BR]]
 * [http://wimax.orbit-lab.org/attachment/wiki/WiMAX/30/07/gec13_tut03.rb gec13_tut03.rb] [[BR]]

The experiments are geared towards sandbox 4 however they can be scripted for the outdoor resources with some modifications.