wiki:GENIWiMaxTridentcomTutorial

Version 24 (modified by hmussman@bbn.com, 12 years ago) (diff)

--

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

At TridentCom 2012, June 11, 2012

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

Abstract:
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.

1. Introduction to GENI WiMAX

Aim: Moitvation for GENI WiMAX, and brief overview.

slides

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

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 Putty for Windows) and a web browser.

We will also give instructions for participants to log into designated sites using their assigned credentials, to complete the hands-on portion of the tutorial.

Note to testbed operators:

  • We will prepare for 6 teams at Poly, 4 on sb4, 6 on grid (this gives us resources for 15 teams with one backup set). Manu will perform the tutorial at BBN and use screen sharing via Webex to project the demonstration to the tutorial participants.
  • Each team needs a username, password, address of console to log into, and names of two assigned nodes (and possibly address of experiment web interface and result service, if they are different from the console address)
  • To make things interesting, we would ideally give each team one node with a very good channel quality and one node with a fair channel quality. It's probably a good idea to figure out ahead of time which nodes have the desired channel quality (in the case of sb4, exactly what settings we want so that we will have the right signal strengths)
  • Remember to enable tutorial accounts before the tutorial begins.

3. Starting an experiment

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

Participants 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.

[ Demo]

Instructions

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

Note to testbed operators:

  • Make sure omf5.3 load works!
  • Make sure your WiMAX base station has sane defaults.
  • The hostname "wimaxrf" should resolve to your BS controller from the console where tutorial users will be logged in (i.e., the wimaxrf service should be located at http://wimaxrf:5052/wimaxrf)
  • For the sake of consistency, we will use a common image name for every testbed - wmx-tutorial.ndz. Make sure this image is installed in the appropriate location

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 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.

[ Demo]

Instructions

(Since several users will be running experiments on the same AM in parallel, not all users will find their web interface at port 4000.)
This experiment does not require coordination between different teams using the same BS.

Note to testbed operators:

  • The experiment script should be in the home directories of the tutorial users, with the node names in the experiment script substituted for the team's actual designated nodes. For the sake of consistency, we will use a common name for this experiment script - wmx-tut01.rb).
  • The web interface for OMF experiments should be accessible from the public Internet. If the address of the web interface is different from the address that participants SSH into, note this address together with the credentials.
  • The necessary files for the wimaxcu wrapper (including oml4r.rb) should be installed on the tutorial disk image
  • On the experiment controller, the application definition wimaxcu_app.rb must be installed.
  • The result service should be accessible from the public Internet. If the address of the result service is different from the address that participants SSH into, note this address together with the credentials.

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.

[ Demo]

Instructions

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

Note to testbed operators:

  • The experiment script should be in the home directories of the tutorial users, with the node names in the experiment script substituted for the team's actual designated nodes. For the sake of consistency, we will use a common name for this experiment script - wmx-tut02.rb).
  • The same requirements as in the "Basic WiMAX RSSI Experiment" apply
  • The old iperf_oml2 should be installed on the tutorial disk image
  • The application definition with the -B parameter enabled (I don't think it is by default) should be installed on the EC.
  • The broadcast sender and bridging across VLANs will be provided by Winlab.
  • Each site needs to modify the line in the script where the IP address is assigned, to reflect that site's own X in 10.43.X.Y

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.

[ Demo]

Instructions

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

Note to testbed operators:

  • This script should be installed at the user console
  • The script has the following Ruby prerequisites: xmlsimple, net-http, and oml4r

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.

[ Demo]

Instructions

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

Note to testbed operators:

  • The experiment script should be in the home directories of the tutorial users, with the node names in the experiment script substituted for the team's actual designated nodes. For the sake of consistency, we will use a common name for this experiment script - wmx-tut03.rb).
  • The same requirements as in the "Iperf UDP Broadcast Receiver Experiment" apply
  • The same requirements as in "Starting an experiment" apply

References

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

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

Attachments (2)