Changes between Version 44 and Version 45 of Tutorials/g0WmLTE/Tutorial2
- Timestamp:
- Sep 30, 2014, 1:58:46 AM (10 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
Tutorials/g0WmLTE/Tutorial2
v44 v45 1 1 2 = WiMAX Tutorial 2: OMF based WiMAX experiments=2 == OMF Based WiMAX Experiment == 3 3 4 4 [[TOC(Tutorials/g0WmLTE*)]] 5 5 6 == Prerequisites==6 === Prerequisites === 7 7 8 8 This tutorial series assumes you have an [http://www.orbit-lab.org/userManagement/register ORBIT account], have [https://www.orbit-lab.org/schedule/ scheduled a session] on the ORBIT test bed, are familiar with [http://en.wikipedia.org/wiki/Secure_Shell SSH]'ing [http://www.orbit-lab.org/wiki/Tutorial/HelloWorld#a4.RunningtheHelloWorldexperiment into the test bed itself, and are familiar with the basics of running ORBIT experiments]. If you have not done these things yet, you may wish to do so before taking a look at this slightly more advanced experiment. If you are unfamiliar with or are entirely new to ORBIT, you may wish to start [http://www.orbit-lab.org/ here]. 9 9 10 == About This Experiment==10 === About This Experiment === 11 11 12 12 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. 13 13 14 ----15 16 = Experiment: Check Connection Status, Then Send TCP Packets =17 18 ----19 14 === The Code === 20 15 … … 31 26 32 27 ---- 33 == Background Information==28 ==== Background Information ==== 34 29 35 30 Experiments performed on ORBIT (specifically) and all GENI wireless test-beds are managed by what was once called the ORBIT Management Framework, now simply known as [http://mytestbed.net/projects/omf/wiki/OMF_Main_Page OMF]. (For background information on frameworks, see [http://en.wikipedia.org/wiki/Software_framework Wikipedia].) Simply put, a framework provides programs which perform all the generic functions a programmer would otherwise need to code at a given ''layer'' to obtain functional applications. This includes programs that check various paths, run subprograms, collect data, check validity, sanitize inputs, and more. Together with its sister program, formerly known as the ORBIT Measurement Library (now known as OML), OMF is used to run experiments from start to finish. … … 39 34 ---- 40 35 41 == Dissecting the Experiment==36 === Dissecting the Experiment === 42 37 43 38 {{{ … … 94 89 ''app.measure'' collects the data and leverages OML to save them to an external service. A measurement type should be specified to ensure that data is collected properly. 95 90 ---- 96 == Launch Experiment==91 === Launch Experiment === 97 92 98 93 Before 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: … … 122 117 123 118 ---- 124 == Troubleshooting Runtime Problems==119 === Troubleshooting Runtime Problems === 125 120 126 121 There are a few problems which may arise during the course of attempting to run this experiment. Usually, they are the result of fragmentation of framework/operational code. Below are some errors encountered, and suggested solutions. … … 134 129 ---- 135 130 136 == Retrieving Results==131 === Retrieving Results === 137 132 138 133 Data is collected during experimentation and pushed to a server using an experiment ID indicated during the initiation and conclusion of each experiment. This ID is important, as it is used to recover experiment results and even view them in real-time. (Server names vary with test beds. This server name is specific to ORBIT.) … … 157 152 }}} 158 153 159 ---- 160 161 == Final Observations == 154 === Final Observations === 162 155 163 156 Due to the highly experimental nature of ORBIT and its OMF and OML, it is possible that this experiment may eventually be broken by future design changes. Please bear this in mind. 164 157 165 158 If this experiment does not work for you, and the above troubleshooting suggestions did not resolve your difficulties, you may need to contact an administrator. Unfortunately, it is difficult to tell the difference between the system being down and simply misconfigured for an end user. Therefore, you should attempt to debug the experiment using the above troubleshooting tips to ensure that the error is not from the configuration. 166 167 ----
