Changes between Version 1 and Version 2 of WikiStart

Feb 17, 2019, 2:31:36 PM (2 years ago)



  • WikiStart

    v1 v2  
    1 = Welcome to Trac
     1= OML =
    3 Trac is a '''minimalistic''' approach to '''web-based''' management of
    4 '''software projects'''. Its goal is to simplify effective tracking and
    5 handling of software issues, enhancements and overall progress.
     3[[TOC(heading=OML Documentation, OML/*, depth=1)]]
    7 All aspects of Trac have been designed with the single goal to
    8 '''help developers write great software''' while '''staying out of the way'''
    9 and imposing as little as possible on a team's established process and
    10 culture.
     5OML is an instrumentation tool that allows application writers to define customisable measurement points (MP) inside new or pre-existing applications. Experimenters running the applications can then direct the measurement streams (MS) from these MPs to remote collection points, for storage in measurement databases.
    12 As all Wiki pages, this page is editable, this means that you can
    13 modify the contents of this page simply by using your
    14 web-browser. Simply click on the "Edit this page" link at the bottom
    15 of the page. WikiFormatting will give you a detailed description of
    16 available Wiki formatting commands.
     7== Description ==
     8OML was originally conceived to provide measurement facilities for OMF-enabled testbeds, such as the [ ORBIT Testbed]. It is now a stand-alone tool which can also be run independent of OMF. OML is now a generic software framework for measurement collection.
    18 "[wiki:TracAdmin trac-admin] ''yourenvdir'' initenv" created
    19 a new Trac environment, containing a default set of wiki pages and some sample
    20 data. This newly created environment also contains
    21 [wiki:TracGuide documentation] to help you get started with your project.
     10'''What does that mean?'''
    23 You can use [wiki:TracAdmin trac-admin] to configure
    24 [ Trac] to better fit your project, especially in
    25 regard to ''components'', ''versions'' and ''milestones''.
     12Well, imagine you have a bunch of devices that are recording some sort of measurement data, and they are all connected to a network. OML gives you a way to collect all the measurement data being recorded by the devices to a central location, via the network.
     14'''What sort of measurements can OML handle?'''
    28 TracGuide is a good place to start.
     16OML is quite flexible -- it can be used to collect data from any source, such as statistics about network traffic flows, CPU and memory usage, input from sensors such as temperature sensors, or GPS location measurement devices.
    30 Enjoy! [[BR]]
    31 ''The Trac Team''
     18'''What sort of applications can OML be used for?'''
    33 == Starting Points
     20OML is a generic framework that can be adapted to many different uses. Networking researchers who use testbed networks to run experiments would be particularly interested in OML as a way to collect data from their experiments. In fact, that's why we developed OML in the first place! However, any activity that involves measurement on many different computers or devices that are connected by a network could benefit from using OML.
    35  * TracGuide --  Built-in Documentation
    36  * [ The Trac project] -- Trac Open Source Project
    37  * [ Trac FAQ] -- Frequently Asked Questions
    38  * TracSupport --  Trac Support
     22OML consists of two main components:
    40 For a complete list of local wiki pages, see TitleIndex.
     24* OML client library: the OML client library provides a C API for applications to collect measurements that they produce. The library includes a dynamically configurable filtering mechanism that can perform some processing on each measurement stream before it is forwarded to the OML Server. The C library, as well as the native implementations for Python (OML4Py) and Ruby (OML4R) are maintained here.
     26* OML Server: the OML server component is responsible for collecting and storing measurements inside a database. Currently, SQLite3 and PostgreSQL are supported as database backends.
     28A bundle of OML-instrumented applications is also provided that perform measurements and filter and collect them using OML, including an OML-capable version of Iperf as well as wrapper applications for libsigar and libtrace.
     30== Third Party Libraries ==
     31* OML4J is a Java Injection Point (Maintained by NITLab it also has example of use within an Android application.
     32* OML4JS is a !Javascript/!WebSocket library to collect measurements from webpages, maintained by Fraida Fund from NYU Poly.
     34== Bugs ==
     35If you think you found a bug, please log in to this website and click New issue in the top menu. If you do not have an account, feel free to register. Alternatively, you can send your bug report via email: oml-issues AT (does not require an account). Please attach log files and describe which version of OML and what platform you are using.
     37== References and Citations ==
     39The OML architecture is described in a few academic publications. Perhaps the most relevant are the following (see the attached BibTeX file [attachemnt: oml.bib]):
     41Manpreet Singh, Max Ott, Ivan Seskar, and Pandurang Kama, "ORBIT measurements framework and library (OML): Motivations, design, implementation, and features," in !TridentCom 2005, Feb. 2005. [ [Download] ].
     43Olivier Mehani, Guillaume Jourjon, Thierry Rakotoarivelo, and Max Ott, "An instrumentation framework for the critical task of measurement collection in the future Internet," Computer Networks, vol. 63, pp. 68-83, Apr. 2014. doi:10.1016/j.bjp.2014.01.007 [ [Download]]
     45Jolyon White, Guillaum Jourjon, Thierry Rakotoarivelo, and Max Ott. "Measurement architectures for network experiments with disconnected mobile nodes," in TridentCom 2010, May 2010 [ [Download]]