Version 5 (modified by 12 years ago) (diff) | ,
---|
The Idea
Experiment Design
Step 1: Choose the application that you want to run on the WiMAX nodes (or create a new one)
A number of already-OMLized applications are already available.
In this case, we will run two applications that we've written ourselves: 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 oml4r Ruby client library.
OML client libraries are also available for Python and C or C++.
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, instead of manually installing your application and configuring each node individually!
Step 4: If you've written and instrumented your own applications, you will have to write an application definition for each experiment.
Before running the experiment, download the application definitions to the console where you'll run the experiment.
- Sensor definition
- Wmxstat definition
Step 5: Write an OMF script
Decide exactly how you want to configure the network interfaces on your nodes and what options you want to run the applications with. Then write an OMF script to orchestrate all of this on your nodes.
Since we are working at two sites, we have two OMF scripts:
- NYU-Poly script
- UCLA scripts
Review these scripts with your instructor.
Experiment Deployment
Step 6: Set up your environment
Load your disk image onto the set of nodes you want to use:
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
Reset the base station to its default settings, and then restart it so that the changes will take effect:
wget -qO- "http://wimaxrf:5052/wimaxrf/bs/default" wget -qO- "http://wimaxrf:5052/wimaxrf/bs/restart"
Don't be alarmed if the second command returns a failure message; this is normal.
Step 7: Load your WiMAX datapath
The datapath you select will determine how your WiMAX clients will be connected; for example, will they appear on the public Internet or on the Internet2 network?
In this case, we are using the I2 network, so we will load the geni datapath configuration:
wget -qO- "http://wimaxrf:5052/wimaxrf/datapath/config/load?name=geni"