[[PageOutline]] This page describes the experiment life cycle of a GENI WiMAX experiment. If you want to jump right in and run a sample experiment, skip to the [#ExperimentDeploymentandExecution Experiment Deployment and Execution] section. == Support == To learn more about GENI WiMAX within the context of a non-trivial experiment from a major area of computer science or networking research, please attend the [wiki:GEC15Agenda/WiMAXTutorial WiMAX Tutorial] at GEC15. Use these links to get more information about: * [http://wimax.orbit-lab.org/ GENI WiMAX] * [http://mytestbed.net/ OMF and OML] * [http://witestlab.poly.edu/ NYU-Poly testbed] * [http://www.orbit-lab.org/ WINLAB testbed] Use these addresses to get support for: * GENI WiMAX: [mailto:wimax-developer@winlab.rutgers.edu wimax-developer@winlab.rutgers.edu] * OMF: [mailto:omf-user@lists.nicta.com.au omf-user@lists.nicta.com.au] * OML: [mailto:oml-user@lists.nicta.com.au oml-user@lists.nicta.com.au] * NYU-Poly Testbed: [mailto:witestlab@poly.edu witestlab@poly.edu] * WINLAB testbed: [mailto:orbit-user@orbit-lab.org orbit-user@orbit-lab.org] Or find any of these people at GEC15 and ask them all your WiMAX questions: || [[Image(http://witestlab.poly.edu/priv/fraida.png, 60%, nolink)]] [[BR]] Fraida Fund [[BR]] NYU-Poly || [[Image(http://witestlab.poly.edu/priv/ivan.png, 60%, nolink)]] [[BR]] Ivan Seskar [[BR]] WINLAB || [[Image(http://witestlab.poly.edu/priv/manu.png, 60%, nolink)]] [[BR]] Abhimanyu Gosain [[BR]] Raytheon BBN || == 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]. Note that before you may log on to a WINLAB testbed with your new credentials, you will need to [http://www.orbit-lab.org/wiki/Helpers/SSHKeys set up SSH keys]. === 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(http://witestlab.poly.edu/images/stories/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 === ==== OMF ==== OMF is a platform to support rigorous and repeatable experiments in a wireless environment. It provides an unambiguous way to describe an experiment, thus enabling repeatability. One OMF experiment can run on any GENI WiMAX testbed with minimal modifications. NB: You don't have to use OMF to run experiments on a GENI WiMAX testbed - you may also run experiments manually by logging on to each node via SSH and executing commands on the nodes yourself. However, once you have figured out exactly how you want to configure your resources and what commands you want to run on them, OMF makes it much easier to run, refine, and repeat your experiment. ==== OML ==== OML is a measurement library and framework that provides a method for instrumenting experiments to stream measurements to a storage server during execution. The measurements are saved in a standard database format, which you can retrieve later for data analysis and visualization. ==== WiMAX ==== The WiMAX base stations are designed to "just work" in their default configuration. However, if you would like to change the settings on the base station, you can find the syntax [http://wimax.orbit-lab.org/wiki/WiMAX/17 here] (refer to the TOC on the right of the page for links to specific settings). === Applications === A number of commonly used applications and utilities (e.g. iperf, VLC) 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 == A set of simple tutorial exercises have been prepared to help familiarize you with the process of running an experiment on a GENI WiMAX testbed. To run these exercises, use an SSH client (such as [http://www.chiark.greenend.org.uk/~sgtatham/putty/ Putty] for Windows) to log on to your testbed console using the username and password that have been provided for you. For example, if your username is "tutorial01", your password is "gec15", and your console is "witestlab.poly.edu", then SSH into '''tutorial01@witestlab.poly.edu''' and enter '''gec15''' when you are prompted for a password. If you are using the sb4 testbed at WINLAB, your console is sb4.orbit-lab.org. * Introductory tutorial at NYU-Poly: [http://witestlab.poly.edu/index.php/tutorial.html?start=3 Part 1], [http://witestlab.poly.edu/index.php/tutorial.html?start=4 Part 2], and [http://witestlab.poly.edu/index.php/tutorial.html?start=5 Part 3] * Introductory tutorial on sb4 at WINLAB: [http://www.orbit-lab.org/wiki/Tutorials/WiMAX/Tutorial1 Part 1] and [http://www.orbit-lab.org/wiki/Tutorials/WiMAX/Tutorial2 Part 2] == Experiment Analysis == For instructions on archiving experiment data and visualizing results, please refer to these [http://wimax.orbit-lab.org/wiki/WiMAX/GIMIUse GIMI-WiMAX instructions].