Changes between Version 38 and Version 39 of Tutorials/g0WmLTE/Tutorial2


Ignore:
Timestamp:
Oct 18, 2012, 1:16:58 AM (12 years ago)
Author:
ffund01
Comment:

Legend:

Unmodified
Added
Removed
Modified
  • Tutorials/g0WmLTE/Tutorial2

    v38 v39  
    1919== About This Experiment ==
    2020
    21 This tutorial section is adapted from the tutorials at [http://witestlab.poly.edu/index.php/tutorial.html NYU Poly WITest lab] and expanded from the more concise [http://wimax.orbit-lab.org/wiki/WiMAX/30/07#a18.GEC13:TutorialsfromPolyNYU ORBIT adaptations] done previously. As before, we will perform our experiment on Sandbox 4, providing some background information at each step. For more information, see the relevant documentation for each step at one of the source websites. '''This experiment uses OMF Version 5.3, also known as omf-5.3. This experiment very well may fail for other versions of OMF.'''
     21This tutorial section is adapted from the tutorials at [http://witestlab.poly.edu/index.php/tutorial.html NYU Poly WITest lab] and expanded from the more concise [http://wimax.orbit-lab.org/wiki/WiMAX/30/07#a18.GEC13:TutorialsfromPolyNYU ORBIT adaptations] done previously. As before, we will perform our experiment on Sandbox 4, providing some background information at each step. For more information, see the relevant documentation for each step at one of the source websites. '''This experiment uses OMF Version 5.3, also known as omf-5.3.'''
    2222
    2323----
     
    3030The following are the links to experiment Description script and the underlying codes. In the interest of saving space, they are not posted directly to this page.
    3131
    32  * [http://www.orbit-lab.org/attachment/wiki/WiMAX_Tutorial-2/nyupoly_mcsmod.rb Experiment Description] [[BR]]
    33  * [http://www.orbit-lab.org/attachment/wiki/WiMAX_Tutorial-2/iperf.rb iperf app] [[BR]]
    34  * [http://www.orbit-lab.org/attachment/wiki/WiMAX_Tutorial-2/wimaxcu_app.rb wimaxcu_app wrapper] [[BR]]
    35  * [http://www.orbit-lab.org/attachment/wiki/WiMAX_Tutorial-2/wmxstat wmxstat program] [[BR]]
     32 * [http://www.orbit-lab.org/attachment/wiki/Tutorials/WiMAX/Tutorial2/wimax_ed.rb Experiment Description] [[BR]]
     33 * [http://www.orbit-lab.org/attachment/wiki/Tutorials/WiMAX/Tutorial2/iperf.rb iperf app description] [[BR]]
     34 * [http://www.orbit-lab.org/attachment/wiki/Tutorials/WiMAX/Tutorial2/wimaxcu_app.rb wimaxcu_app description] [[BR]]
     35 * [http://www.orbit-lab.org/attachment/wiki/Tutorials/WiMAX/Tutorial2/wmxstat wmxstat program] [[BR]]
     36
    3637
    3738At this point, we will give a primer on OMF and some of the functions inside the experiment. To skip to the experiment itself, [http://www.orbit-lab.org/wiki/Tutorials/WiMAX/Tutorial2#LaunchExperiment click here].
     
    5051{{{
    5152#!ruby
    52 defGroup('first_node', 'node1-1.sb4.orbit-lab.org')
     53defGroup('first_node', 'node1-4.sb4.orbit-lab.org')
    5354}}}
    5455
     
    5859{{{
    5960#!ruby
    60 defGroup('first_node', 'node1-1.sb4.orbit-lab.org') do |node|
     61defGroup('first_node', 'node1-4.sb4.orbit-lab.org') do |node|
    6162  node.net.x0.profile = '51'
    62   node.net.x0.ip = '10.41.14.1'
     63  node.net.x0.ip = '10.41.14.4'
    6364  node.net.x0.netmask = '255.255.0.0'
    6465  node.net.x0.up
    65   node.addApplication("test:app:wimaxcu_app") do |app|
     66  node.addApplication("wimaxcu_app") do |app|
    6667    app.measure('status_link')
    6768  end
     
    7879''addApplication'' gives a group instructions to use the defined application in the specified manner. The principle parameter is the URI of the predefined application.
    7980
    80  * The ''wimaxcu_app'' application is actually already installed in the experiment image here, and "test:app:..." instructs OMF to search in the /test/app/ subdirectory of its primary directory of applications.
     81 * The ''wimaxcu_app'' application tells OMF to load the application described in the ''wimaxcu_app.rb'' - in this case, the ''wmxstat'' application.
    8182
    8283 * ''app.measure('status_link')'' tells this application to use its predefined code to measure the 'status_link' property. OML will save these data for later. The exact behavior of this application is outside the scope of this discussion; suffice it to say that the implementation of the application is defined in the ''wimaxcu_app.rb'' and ''wmxstat'' programs mentioned previously.
     
    8586#!ruby
    8687  node.addApplication("test:app:iperf") do |app|
    87     app.setProperty('client', '10.41.14.4', true)
     88    app.setProperty('client', '10.41.14.6', true)
    8889    app.setProperty('mss', 536) # Do not raise above 600
    8990    app.setProperty('interval', 1)
    90     app.setProperty('bind', "10.41.14.1")
     91    app.setProperty('bind', "10.41.14.4")
    9192    app.measure('TCP_Info', samples => 1)
    9293  end
    9394}}}
    9495
    95  * As before, this application is contained in a subdirectory accessed through ''/test/app/''.
    9696
    9797This adds the ''iperf'' application functionality to the group. ''iperf'' is an application which measures connectivity by sending data packets between groups. To see a complete list of possible parameters and measurements available, examine the source code of the ''iperf'' wrapper applications.
     
    105105== Launch Experiment ==
    106106
    107 Before launching the experiment, please ensure that the experiment description file is on the local machine.
     107Before launching the experiment, please download the experiment description file (wimax_ed.rb) and the application description files (iperf.rb and wimaxcu_app.rb) to the console:
     108
     109{{{
     110wget http://www.orbit-lab.org/raw-attachment/wiki/Tutorials/WiMAX/Tutorial2/iperf.rb
     111wget http://www.orbit-lab.org/raw-attachment/wiki/Tutorials/WiMAX/Tutorial2/wimaxcu_app.rb
     112wget http://www.orbit-lab.org/raw-attachment/wiki/Tutorials/WiMAX/Tutorial2/wimax_ed.rb
     113}}}
    108114
    109115Reset the base station to default settings, and then image the nodes, as before.
     
    118124
    119125{{{
    120 omf tell on all
    121 omf-5.3 exec nyupoly_mcsmod.rb
     126omf-5.3 tell -a on -t node1-4.sb4.orbit-lab.org,node1-6.sb4.orbit-lab.org
     127omf-5.3 exec wimax_ed.rb
    122128}}}
    123129
     
    144150
    145151{{{
    146 wget "http://oml:5053/result/dumpDatabase?expID=<your_experiment_ID>" -O myDatabase
     152wget "http://oml:5054/result/dumpDatabase?expID=<your_experiment_ID>" -O myDatabase
    147153}}}
    148154