[[PageOutline]]

== Establish Environment ==

=== Get an account ===

Temporary tutorial credentials will be available during the [wiki:GEC15Agenda/ExperimenterDropIn Experimenter Drop-in Help Session] at GEC15. Because there is some time delay between account creation and account approval, you won't be able to create an account and immediately start using it at that session.

However, if you would like to create an account for your later use, you can register at either of the open-access GENI WIMAX testbeds:
 * [http://witestlab.poly.edu/index.php/component/user/?task=register Register for an account at NYU-Poly]
 * [http://www.orbit-lab.org/userManagement/register Register for an account at WINLAB]

=== Reserve resources ===

Reservations will have been created ahead of time for the temporary tutorial credentials used in the [wiki:GEC15Agenda/ExperimenterDropIn Experimenter Drop-in Help Session] at GEC15. But for future reference, you may visit the following links (using the account you have set up on a GENI WiMAX testbed) to reserve WiMAX resources:

 * [https://www.orbit-lab.org/schedule/ Reservations at WINLAB]. Detailed instructions for using this reservation system are available [http://www.orbit-lab.org/wiki/Documentation/Scheduling here].
 * [http://witestlab.poly.edu/index.php/reservations/make-a-reservation.html Reservations at NYU-Poly]. Detailed instructions for using this reservation system are available at [http://witestlab.poly.edu/index.php/tutorial.html?start=2 here]. 

'''See more information about the [#Resources resources] at each site.'''

== Experiment Design ==

=== Resources ===

A GENI WiMAX testbed includes a number of components (pictured below):

 * A '''console''' that runs a set of services that help you manage and execute your experiment
 * A WiMAX '''base station''' 
 * A set of '''nodes''', which may include laptop computers, Android phones, or special PCs colloquially referred to as "yellow boxes." 

[[Image(testbed.png, 60%)]]

You can read more about the specific resources available on each testbed at the following links:
 * [http://witestlab.poly.edu/index.php/wimax/testbed.html NYU-Poly testbed]
 * [http://www.orbit-lab.org/status/orbit/ WINLAB testbed]

NB: The WINLAB facility includes multiple testbeds. WiMAX nodes are available on the following testbeds:
 * grid (make a reservation for '''grid''' and '''wimax''')
 * outdoor (make a reservation for '''outdoor''' and '''wimax''')
 * sb6 (make a reservation for '''sb6''' and '''wimax''')
 * sb7 (make a reservation for '''sb7''' and '''wimax''')
 * sb8 (make a reservation for '''sb8''' and '''wimax''')
 * sb4 (make a reservation for '''sb4''' - you do not need to also reserve '''wimax''', because sb4 has its own base station that is reserved automatically).

The NYU-Poly facility only has a single testbed. When you make a reservation at NYU-Poly, you have reserved the entire testbed, including all nodes and the WiMAX base station.


=== Services ===

 

=== Applications ===

A number of commonly used applications have been instrumented with OML to enable their use in OMF experiments. More information about these applications is available at:
 * [http://mytestbed.net/projects/omlapp/wiki NICTA OML Applications Overview]
 * [http://witestlab.poly.edu/index.php/wirelesstestbeds/omfnettest/oml-applications.html Additional OML Applications from NYU-Poly]


There are also several libraries available to help you instrument your own applications for use with OML:
 * For C and C++ - install [http://mytestbed.net/projects/oml/wiki/Installing_OML_packages liboml2-dev] and use it as described [http://mytestbed.net/projects/oml/wiki/Client_Programming here]
 * For Ruby - use the [https://rubygems.org/gems/oml4r oml4r] gem 
 * For Python - use the [http://pypi.python.org/pypi/oml4py/ oml4py] module
== Experiment Deployment and Execution ==


== Experiment Analysis ==