Changes between Version 1 and Version 2 of Tutorials/g0WmLTE/Tutorial1


Ignore:
Timestamp:
Mar 16, 2011, 6:38:35 PM (13 years ago)
Author:
ssugrim
Comment:

Added more text for readability and clarity.

Legend:

Unmodified
Added
Removed
Modified
  • Tutorials/g0WmLTE/Tutorial1

    v1 v2  
    11= WiMAX "Hello World" Tutorial =
    22
    3 This tutorial presents a simple example of using WiMAX devices that are available in ORBIT. The tutorial assumes basic understanding of OMF so, if you are not familiar with it, you may want to read the short [http://mytestbed.net/projects/omf/wiki/An_Introduction_to_OMF OMF System Overview] to familiarize yourself with the testbed control framework.
     3This tutorial presents a simple example of using WiMAX devices that are available in ORBIT. The tutorial assumes basic understanding of OMF. If you are not familiar with it, please read the short [http://mytestbed.net/projects/omf/wiki/An_Introduction_to_OMF OMF System Overview] to familiarize yourself with the testbed control framework.
    44
    55== Experimental Scenario ==
    66
    7 The experimental scenario is fairly simple: our goal is to measure RTT of basic WiMAX link (single hop).
     7The experimental scenario is fairly simple: our goal is to measure RTT of basic WiMAX link (single hop). This will be achieved by processing the output of a simple ping command. The out put of the ping command will be passed through a regular expression and the results stored in an sqlite database.
    88
    9 == Experiment Description ==
     9=== Experiment Description ===
     10The expirment has two phases: setup and collection. In the setup phase we prime the interfaces with the necessary layer 3 information. In the collection phase we run the ping command and process the results.
    1011
    11 === Configuring WiMAX inteface ===
    12 We need to connect to the basestation; will use wimaxcu userspace utility for that.
     12==== Configuring WiMAX inteface ====
     13We need to connect each node to the basestation. We will use wimaxcu userspace utility for that. This application definition will invoke the the wimaxcu utility on each node with the arguments necessary to authenticate to the base station.
    1314
    1415{{{
     
    2122}}}
    2223
    23 === Assigning the WiMAX IP Address ===
    24 We will use dhclient command on the node to assign the IP address to the WiMAX interface. The following code snippet is the dhclient command wrapper that is used for address assignement.
     24==== Assigning the WiMAX IP Address ====
     25We will use dhclient command on the node to assign the IP address to the WiMAX interface. The following code snippet is the dhclient command wrapper that is used for ip address assignment on each individual node.
    2526
    2627{{{
     
    3435
    3536
    36 === Ping Application ===
     37==== Ping Application ====
    3738
    38 Wrapper for ping application.
     39This application definition wraps code around the ping command running on an individual node. Unlike the dhclient application definition, we're interested in it's out out. We've defined a few measurement metrics (pieces of data we're interested in). When we examine the results in the sqlite database produced from this experiment the field will be labeled with these metric names. This wrapper is based off the OML4R command wrapper library (it's included in a require statement).
    3940
    4041{{{
     
    6263}}}
    6364
    64 == Experiment Code ==
    65 Specify the nodes involved in the experiment and declare the applications with parameters that they would be running
     65==== Experiment Code ====
     66The last phase of the experiment description requires a script that coordinates all the elements.  This code snippet specifies the nodes involved in the experiment and declares the applications and parameters required to run them.
    6667
    6768{{{
     
    8081}}}
    8182
    82 The actual experiment: boot the nodes. wait for 10 seconds for them to worm up and then
     83Now that all the setup is done the actual experiment code is pretty simple. It  boot the nodes waits for 10 seconds for them to warm up and then runs the ping/collection.
    8384
    8485{{{