=== Description ===

In this experiment traffic is generated on one wimax node which is received on another wimax node.

=== Prerequisite ===

This sample experiment requires sandbox 7 (sb7.orbit-lab.org) and the two nodes (node1-1 & node1-2). An OML server must be running sb7, this is required by the OTG2 and OTR2 applications that will be running on the nodes.


=== The tutorial experiment ===

This experiment is given in the attached script [attachment:wimax-tutorial2.rb wimax-tutorial2.rb]. Download this file to your home directory.

To run this experiment:

1. ssh into sandbox 7
{{{
ssh sb7.orbit-lab.org
}}}

2. Image node1-1 & node1-2 with wimax.ndz (this should be in the repository)
{{{
omf-5.2 load [1,1..2] wimax.ndz
}}}

The output of the imaging command should look similar to the following:
{{{
nilanjan@console.sb7:~$ omf-5.2 load [1,1..2] wimax.ndz
Imaging nodes: '[1,1..2]' with image 'wimax.ndz'
(Domain:  default from hostname)
(Timeout:  800 sec.)
 INFO NodeHandler: init OMF Experiment Controller 5.2.408
 INFO NodeHandler: init Experiment ID: sb7.orbit-lab.org_2011_09_14_15_07_41
 INFO NodeHandler: Web interface available at: http://10.17.0.10:4000
 INFO Experiment: load system:exp:stdlib
 INFO property.resetDelay: value = 70 (Fixnum)
 INFO property.resetTries: value = 1 (Fixnum)
 INFO Experiment: load system:exp:imageNode
 INFO property.nodes: value = [1, 1..2] (Array)
 INFO property.image: value = "wimax.ndz" (String)
 INFO property.domain: value = nil (NilClass)
 INFO property.outpath: value = "/tmp" (String)
 INFO property.timeout: value = 800 (Fixnum)
 INFO stdlib: Waiting for nodes (Up/Down/Total): 0/2/2 - (still down: n_1_1,n_1_2)
 INFO stdlib: Waiting for nodes (Up/Down/Total): 0/2/2 - (still down: n_1_1,n_1_2)
 INFO stdlib: Waiting for nodes (Up/Down/Total): 0/2/2 - (still down: n_1_1,n_1_2)
 INFO stdlib: Waiting for nodes (Up/Down/Total): 0/2/2 - (still down: n_1_1,n_1_2)
 INFO whenAll: *: 'status[@value='UP']' fires
 INFO exp: Progress(0/0/2): 10/10/10 min(n_1_1)/avg/max (40) - Timeout: 750 sec.
 INFO exp: Progress(0/0/2): 40/40/40 min(n_1_1)/avg/max (40) - Timeout: 740 sec.
 INFO exp: Progress(0/0/2): 60/60/60 min(n_1_1)/avg/max (40) - Timeout: 730 sec.
 INFO exp: Progress(0/0/2): 70/75/80 min(n_1_1)/avg/max (40) - Timeout: 720 sec.
 INFO exp: Progress(0/0/2): 90/90/90 min(n_1_1)/avg/max (40) - Timeout: 710 sec.
 INFO exp: Progress(2/0/2): 100/100/100 min()/avg/max (40) - Timeout: 700 sec.
 INFO exp:  -----------------------------
 INFO exp:  Imaging Process Done
 INFO exp:  - 2 node(s) successfully imaged - See the topology file: '/tmp/sb7.orbit-lab.org_2011_09_14_15_07_41_topo_active.rb'
 INFO exp:  -----------------------------
 INFO Experiment: DONE!
 INFO NodeHandler: Shutting down experiment, please wait...
 INFO NodeHandler: Shutdown flag is set - Turning Off the resources
 INFO run: Experiment sb7.orbit-lab.org_2011_09_14_15_07_41 finished after 1:41
}}}

3. Once the imaging process is complete, we need to turn the nodes on
{{{
omf-5.2 tell on [1,1..2]
}}}

Use the following command to query the status of the nodse to see if they are on
{{{
omf-5.2 stat
}}}

Once the nodes are on, the stat command should return the following.
{{{
nilanjan@console.sb7:~$ omf-5.2 stat
 INFO NodeHandler: init OMF Experiment Controller 5.2.408
-----------------------------------------------
 INFO Topology: Loading topology 'system:topo:all'.
 Testbed : sb7.orbit-lab.org
 Node n_1_1 - State: POWERON
 Node n_1_2 - State: POWERON
-----------------------------------------------
}}}

4. Run the experiment script (from above)
{{{
omf-5.2 exec wimax-tutorial2.ndz
}}}

The output of the experiment script should be similar to the following:
{{{
nilanjan@console.sb7:~$ omf-5.2 exec wimax-tutorial2.rb
 INFO NodeHandler: init OMF Experiment Controller 5.2.408
 INFO NodeHandler: init Experiment ID: sb7.orbit-lab.org_2011_09_14_10_58_24
 INFO NodeHandler: Web interface available at: http://10.17.0.10:4000
 INFO Experiment: load system:exp:stdlib
 INFO property.resetDelay: value = 70 (Fixnum)
 INFO property.resetTries: value = 1 (Fixnum)
 INFO Experiment: load wimax-tutorial2.rb
 INFO whenAll: *: 'apps/app/status/@value' fires
 INFO exp: Give machines some time to warm up
 INFO exp: Request from Experiment Script: Wait for 10s....
 INFO exp: Collect measurements for 100 seconds
 INFO exp: Request from Experiment Script: Wait for 100s....
 INFO exp: Finish it.
 INFO Experiment: DONE!
 INFO NodeHandler: Shutting down experiment, please wait...
}}}

5. In the above output make note of the Experiment ID: sb7.orbit-lab.org_2011_09_14_10_58_24.
This file is an sqlite3 file (with an extension .sq3). The file is located on sandbox 7. THe file is generated by the OML server and has data collected from OTG2 & OTR2 applications that was run via the experiment script.