= WiMAX Tutorial =

This is a continuation of the [http://www.orbit-lab.org/wiki/WiMAX_Tutorial-1/ WiMAX Tutorial and Primer].

== Prerequisites == 

This tutorial series assumes you have an [http://www.orbit-lab.org/userManagement/register ORBIT account], have [https://www.orbit-lab.org/schedule/ scheduled a session] on the ORBIT test bed, are familiar with [http://en.wikipedia.org/wiki/Secure_Shell SSH]'ing [http://www.orbit-lab.org/wiki/Tutorial/HelloWorld#a4.RunningtheHelloWorldexperiment into the test bed itself, and are familiar with the basics of running ORBIT experiments]. If you have not done these things yet, you may wish to do so before taking a look at this slightly more advanced experiment. If you are unfamiliar with or are entirely new to ORBIT, you may wish to start [http://www.orbit-lab.org/ here].


== Difficulty ==

This tutorial is of intermediate difficulty. In addition to the knowledge from the previous tutorial, basic understanding of the [http://mytestbed.net/projects/omf/wiki/OEDL-5-3 ORBIT Experiment Description Language] (OEDL) and its source language, [http://www.ruby-lang.org/en/ Ruby] (and especially [http://rubylearning.com/satishtalim/ruby_blocks.html blocks] within Ruby), are '''strongly''' recommended. Furthermore, fluency in low-level computer networking concepts such as IP are assumed.
----

== About This Experiment ==

This tutorial section is adapted from the tutorials at [http://witestlab.poly.edu/index.php/tutorials.html NYU-Polytech] and expanded from the more concise [http://wimax.orbit-lab.org/wiki/WiMAX/30/07#a18.GEC13:TutorialsfromPolyNYU ORBIT adaptations] done previously. As before, we will perform our experiment on Sandbox 4, providing some background information at each step. For more information, see the relevant documentation for each step at one of the source websites.

----

= Experiment: Check Connection Status, Then Send UDP Packets =

----
=== The Code ===

The following are the links to experiment Description script and the underlying codes. In the interest of saving space, they are not posted directly to this page.

 * [http://www.orbit-lab.org/attachment/wiki/WiMAX_Tutorial-2/nyupoly_mcsmod.rb Experiment Description] [[BR]]
 * [http://www.orbit-lab.org/attachment/wiki/WiMAX_Tutorial-2/iperf.rb iperf app] [[BR]]
 * [http://www.orbit-lab.org/attachment/wiki/WiMAX_Tutorial-2/wimaxcu_app.rb wimaxcu_app wrapper] [[BR]]
 * [http://www.orbit-lab.org/attachment/wiki/WiMAX_Tutorial-2/wmxstat wmxstat program] [[BR]]

At this point, we will give a primer on OMF and some of the functions inside the experiment. To skip to the experiment itself, [http://www.orbit-lab.org/wiki/WiMAX_Tutorial-2#LaunchExperiment click here].

----
== Background Information ==

Experiments performed on ORBIT (specifically) and all GENI wireless test-beds are managed by what was called the ORBIT Management Framework, now simply known as [http://mytestbed.net/projects/omf/wiki/OMF_Main_Page OMF]. (For background information on frameworks, see [http://en.wikipedia.org/wiki/Software_framework Wikipedia]. Simply put, a framework provides programs which perform all the generic functions a programmer would otherwise need to code at a given ''layer'' to obtain functional applications. This includes programs that check various paths, run subprograms, collect data, check validity, sanitize inputs, and more. 


----

== Launch Experiment ==