close Warning: Can't synchronize with repository "(default)" (/common/SVN/wimax does not appear to be a Subversion repository.). Look in the Trac log for more information.

Changes between Version 2 and Version 3 of WiMAX/30/06


Ignore:
Timestamp:
Apr 17, 2012, 2:32:04 PM (10 years ago)
Author:
Nilanjan Paul
Comment:

Legend:

Unmodified
Added
Removed
Modified
  • WiMAX/30/06

    v2 v3  
    11= 17. Wimax Measurement Experiment: multiple traffic generators and single receiver =
     2
     3== Description ==
     4The experiment runs multiple traffic generators on up to 7 (client) wimax nodes and single traffic receiver. The number of clients can be varied to study the wimax interface's ability to handle traffic at different loads. The traffic generated is UDP, the number of packets and the bit rate can be varied as well.
     5
     6== Hardware utilized ==
     71. ''Sandbox 4 node1-1 - node1-7'': runs otg2 as generator.[[BR]]
     82. ''Sandbox 4 node1-8'': runs otr2 as receiver.[[BR]]
     93. ''RF-attenuator matrix'': this used prior to running the experiment to attenuate the air interface between the wimax base station and nodes.[[BR]]
     10
     11== Software / scripts worth mentioning ==
     121. ''baseline-iperf.ndz'': disk image that's loaded onto the nodes. This image is loaded with otg2 / otr2.[[BR]]
     132. ''oml2-server'': server running on sandbox 4 which collects measurement data from oml2-iperf and stores in a database file.[[BR]]
     143. ''sqlite3'': command line interface for accessing the contents in a database file.[[BR]]
     154. ''mclient.rb'': the experiment script. [http://wimax.orbit-lab.org/attachment/wiki/WiMAX/30/06/mclient.rb Click here to view file.][[BR]]
     16 a. The script takes the following parameters as arguments:[[BR]]
     17  i. nClient  - number of client nodes to use, nClients = [1..7]
     18  ii. packetsize - packet size (byte) from the sender node, packetsize max = 1024
     19  iii. bitrate - bitrate (bit/s) from the sender node
     20 b. Example usage:[[BR]]
     21  i. omf-5.2 exec mclient.rb -- --nClients 8 --packetsize 512 --bitrate 16000
     22
     23
     24== Set up ==
     25Getting started, ssh into the console of sandbox 4.[[BR]]
     26* Verify the oml2-server is running:
     27  * '''$ ps -elf | grep oml2-server'''
     28{{{
     29nilanjan@console.sb4:~/exp/dl-iperf/5.2$ ps -elf | grep oml2-server
     304 S oml2       948     1  0  80   0 -  2471 poll_s Feb02 ?        00:00:16 /usr/bin/oml2-server -l 3003 --logfile=/var/log/oml2-server.log --user=oml2 --group=oml2
     310 S nilanjan  1259 27360  0  80   0 -  1002 pipe_w 10:59 pts/1    00:00:00 grep oml2-server
     32}}}
     33
     34Before the experiment, the BS parameters can be changed. The following are a few examples commands to control the MCS:[[BR]]
     35* To get the current MCS:
     36  * '''$ wget -O status http://localhost:5052/wimaxrf/mcsProfile'''
     37
     38* Change downlink MCS to single profile:
     39  * '''$ wget -O status http://localhost:5052/wimaxrf/mcsProfile?dl=15 '''
     40
     41* Change downlink MCS with profile list:
     42  * '''$ wget -O status http://localhost:5052/wimaxrf/mcsProfile?dl=15,17,18'''
     43
     44* Change uplink MCS to single profile:
     45  * '''$ wget -O status http://localhost:5052/wimaxrf/mcsProfile?ul=15'''
     46
     47* Change uplink MCS with profile list:
     48  * '''$ wget -O status http://localhost:5052/wimaxrf/mcsProfile?ul=15,17,18'''
     49
     50* To restart the base station:
     51  * '''$ wget http://localhost:5052/wimaxrf/restart'''
     52
     53For other details on changing BS parameters please refer to ''Basic Support Services'' under http://wimax.orbit-lab.org/wiki [[BR]]
     54
     55Although the experiment script can vary the attenuator values, the details on manually changing attenuator values can be found in ''RF Matrix Control Services'' under http://wimax.orbit-lab.org/wiki [[BR]]
     56
     57== Usage ==
     58* Start clean, turn off all the nodes:
     59  * '''$ omf-5.2 tell offh all'''
     60{{{
     61nilanjan@console.sb4:~/exp/dl-iperf/5.2$ omf-5.2 tell offh all
     62
     63 INFO NodeHandler: init OMF Experiment Controller 5.2.408
     64 INFO Topology: Loading topology 'system:topo:all'.
     65---------------------------------------------------
     66 Testbed : sb4.orbit-lab.org - Command: offHard
     67 Node n_1_2 - Ok
     68 Node n_1_7 - Ok
     69 Node n_1_1 - Ok
     70 Node n_1_6 - Ok
     71 Node n_1_5 - Ok
     72 Node n_1_9 - Ok
     73 Node n_1_4 - Ok
     74 Node n_1_8 - Ok
     75 Node n_1_3 - Ok
     76---------------------------------------------------
     77}}}
     78
     79* Query the status of the nodes. Wait until all nodes are in ''POWEROFF'' state.
     80  * '''$ omf-5.2 stat'''.
     81{{{
     82nilanjan@console.sb4:~/exp/dl-iperf/5.2$ omf-5.2 stat
     83 INFO NodeHandler: init OMF Experiment Controller 5.2.408
     84-----------------------------------------------
     85 INFO Topology: Loading topology 'system:topo:all'.
     86 Testbed : sb4.orbit-lab.org
     87 Node n_1_1 - State: POWEROFF
     88 Node n_1_2 - State: POWEROFF
     89 Node n_1_3 - State: POWEROFF
     90 Node n_1_4 - State: POWEROFF
     91 Node n_1_5 - State: POWEROFF
     92 Node n_1_6 - State: POWEROFF
     93 Node n_1_7 - State: POWEROFF
     94 Node n_1_8 - State: POWEROFF
     95 Node n_1_9 - State: POWEROFF
     96-----------------------------------------------
     97}}}
     98
     99* Load image onto node1-1 through node1-8:
     100  * '''$ omf-5.2 load [1,1..8] baseline-iperf.ndz'''
     101{{{
     102LOAD IMAGE HERE
     103}}}
     104
     105* After loading the image, the nodes are turned off. Turn these nodes back on:
     106  * '''$ omf-5.2 tell on [1,1..8]'''
     107{{{
     108nilanjan@console.sb4:~/exp/dl-iperf/5.2$ omf-5.2 tell on [1,1..8]
     109
     110 INFO NodeHandler: init OMF Experiment Controller 5.2.408
     111---------------------------------------------------
     112 Testbed : sb4.orbit-lab.org - Command: on
     113 Node n_1_1 - Ok
     114 Node n_1_2 - Ok
     115 Node n_1_3 - Ok
     116 Node n_1_4 - Ok
     117 Node n_1_5 - Ok
     118 Node n_1_6 - Ok
     119 Node n_1_7 - Ok
     120 Node n_1_8 - Ok
     121---------------------------------------------------
     122}}}
     123
     124* Query the status of the nodes until they are in ''POWERON'' state: '''> omf-5.2 stat'''
     125
     126* Now run the experiment script:
     127  * '''$ omf-5.2 exec mclient.rb -- --nClients 4 --packetsize 512 --bitrate 8192000'''
     128{{{
     129RUN EXPERIMENT HERE
     130}}}
     131
     132This experiment generates the sqlite3 database file with the name of the file as the ExperimentID and this file is automatically copied to the current directory.