Changes between Version 12 and Version 13 of Software
- Timestamp:
- Nov 23, 2007, 1:15:44 AM (17 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
Software
v12 v13 31 31 The main component of the Experiment Management Service is the '''Node Handler''' that functions as an Experiment Controller. It multicasts commands to the nodes at the appropriate time and keeps track of their execution. The '''Node Agent''' software component resides on each node, where it listens and executes the commands from the '''Node Handler'''. It also reports information back to the '''Node Handler'''. The combination of these two components gives the user the controls over the testbed, and enables the automated collection of experimental results. Because the '''Node Handler''' uses a rule-based approach to monitoring and controlling experiments, occasional feedback from experimenters may be required to fine tune its operation. Figure 4 illustrates the execution of an experiment from the user's point-of-view. 32 32 33 Finally, using the '''Node Handler''' (via a dedicated experiment called ''imageNodes'', see here), the user can quickly load hard disk images onto the nodes of his/her experiment. This ''imaging process'' allows different groups of nodes to run different OS images. It relies on a scalable multicast protocol and the operation of a disk-loading ''Frisbee'' server from M. Hibler et al. ([http://www.cs.utah.edu/flux/papers/frisbee-usenix03-base.html link]).33 Finally, using the '''Node Handler''' (via a dedicated experiment called ''imageNodes'', which will be described [wiki:Tutorial/HowToImage later]), the user can quickly load hard disk images onto the nodes of his/her experiment. This ''imaging process'' allows different groups of nodes to run different OS images. It relies on a scalable multicast protocol and the operation of a disk-loading ''Frisbee'' server from M. Hibler et al. ([http://www.cs.utah.edu/flux/papers/frisbee-usenix03-base.html link]). 34 34 35 35 [[Image(OMF-User-View.png)]] 36 [[BR]]Figure 1. Execution of an Experiment from a User's point-of-view36 [[BR]]Figure 4. Execution of an Experiment from a User's point-of-view 37 37 38 38 === 2.2 Measurement & Result Collection === 39 39 40 The ''' Collection Server''' collects experimental results. There is one instance of the '''Collection Server''' per experiment. The Berkeley database is used for scalability, and an SQL database is used for persistent data archiving. One multicast channel per experiment is used for logical segregation of data and for scalability.40 The '''ORBIT Measurement Framework & Library (OML)''' is responsible for collecting the experimental results. It is based on a client/server architecture as illustrated in Figure 5 below. 41 41 42 Besides ORBIT Services, other ORBIT-developed software includes '''Libmac''' and the '''ORBIT Measurement Framework'''. Each provides procedures that may be called in user-developed applications. '''Libmac''' is a user-space C library that allows applications to inject and capture MAC layer frames, manipulate wireless interface parameters at both aggregate and per-frame levels, and communicate wireless interface parameters over the air on a per-frame level.42 One instance of an '''OML Collection Server''' is started by the Node Handler for a particular experiment execution. This server will listen and collect experimental results from the various nodes involved in the experiment. It uses an SQL database for persistent data archiving of these results. 43 43 44 The '''ORBIT Measurement Framework (OML)''' has a client/server architecture illustrated in Figure 4 below. '''OML''' uses IP multicast to send data to the measurement server as it is collected. '''OML''' includes a client application programming interface (API). A developer can use this client API through a web interface to define the measurement points and parameters for his or her application. Such definitions are saved as an XML-based configuration file and source code for the measurement client is automatically generated that contains application-specific methods that handle type-safe data collection. This source code can be compiled and linked with the application. 44 On each experimental node, one '''OML Collection Client''' is associated with each experimental applications. The details and "How-To" of such association will be presented in a following part of this tutorial. In the context of this introduction to the testbed, the client-side measurement collection can be viewed as follows. The application will forward any required measurements or outputs to the OML collection client. This OML client will optionally apply some filter/processing to these measurements/outputs, and then sends them to the '''OML Collection Server''' (currently over one multicast channel per experiment for logical segregation of data and for scalability) 45 46 There are two alternative methods for the user to interface their experimental applications with the '''OML Collection Clients''' and to define the requested measurement points and parameters. These methods and measurement definitions will be presented in details later in this tutorial. 45 47 46 48 [[Image(oml-50.png)]] 47 [[BR]]Figure 4. '''OML''' component architecture.49 [[BR]]Figure 5. '''OML''' component architecture. 48 50 49 User-developed software includes the script for the experiment, the application(s) and any modifications to system software. The user-developed script for the experiment contains three static components: the configuration of nodes, the configuration of the application software, and the configuration of the '''ORBIT Measurements Framework and Library (OML)'''. The application is one or more programs that implement the intended behavior of the active nodes in the experiment. Modified system software may include modified Linux components or custom device drivers. Each of these types of user-developed software is covered in more detail in the Testbed Experiments section of this tutorial. 50 51 51 Finally, the ORBIT platform also provides the '''Libmac''' library. '''Libmac''' is a user-space C library that allows applications to inject and capture MAC layer frames, manipulate wireless interface parameters at both aggregate and per-frame levels, and communicate wireless interface parameters over the air on a per-frame level. Users can interface their experimental applications with '''Libmac''' to collect MAC layer measurements from their experiments. This [wiki:Documentation/Libmac other section] of the documentation provides more information on '''Libmac''' and its operations.