[[PageOutline]]


== The Idea ==


== Experiment Design ==

'''Step 1''': Choose the application that you want to run on the WiMAX nodes (or create a new one)

In this case, we will run two applications: a ''sensor'' application that collects measurements from temperature, humidity, and light sensors attached to the node, and a ''wmxstat'' application that collects measurements about the state of the WiMAX link.

Both of these applications are Ruby scripts. 

'''Step 2''': If you've written your own application, instrument it with OML so that you can collect measurements from it during experiment runtime

These applications were instrumented with the [https://rubygems.org/gems/oml4r oml4r] Ruby client library.

OML client libraries are also available for [http://pypi.python.org/pypi/oml4py/ Python] and [http://mytestbed.net/projects/oml/wiki/Client_Programming C or C++].


== Experiment Deployment ==

'''Step 3''':  Create a disk image with your applications installed

Log onto a testbed and load a baseline disk image onto a node:
{{{
omf load -i baseline-witest.ndz -t omf.witest.node1
}}}

Log onto the node (''ssh root@node1'') and install your applications and any required files.

Then save your disk image:
{{{
omf save -n omf.witest.node1
}}}

This can take a while, so we've already created a disk image for use in this tutorial. It's called '''gec15sensor.ndz'''

You can load this disk image onto any number of nodes, e.g.:
{{{
omf load -i gec15sensor.ndz -t omf.witest.node1,omf.witest.node2,omf.witest.node3,omf.witest.node4,omf.witest.node5,omf.witest.node6,omf.witest.node7
}}}



=== OML-enabled Applications ===
=== Custom Application ===

== Experiment Execution ==
=== Experiment Description ===
=== Running OMF Experiment ===
=== Changing Parameters ===