wiki:GENIWiMaxTridentcomTutorial

Version 7 (modified by Fraida Fund, 7 years ago) (diff)

--

Experimentation in a Multi-site GENI WiMAX Network using Orbit Management Framework
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)

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.

Active participants will need a laptop equipped with an SSH client (such as Putty for Windows) and a web browser.

GEC13 Tutorial]

Brief introduction to GENI WiMAX

Aim: Introduction to GENI WiMAX.

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

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 3 teams @ BBN, 4 at Poly, 4 on sb4, 4 on grid, with 2 "standby" each at Poly and on grid (These are in case of unexpected demand and/or if any BBN netbooks get partially imaged during the tutorial and can't be used without being restarted.) We can confortably accommodate 15 teams.
  • 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.

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.

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

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.

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.

Iperf UDP Broadcast Receiver

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.

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

Saving BS Config 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.

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

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.

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

Multisite Demo

?

Attachments (2)