Context Navigation

Changes between Version 1 and Version 2 of WikiStart

Timestamp:: Feb 17, 2019, 2:31:36 PM (5 years ago)
Author:: seskar
Comment:: --

Legend:

: Unmodified
: Added
: Removed
: Modified

WikiStart

-              v1
+              v2
 = Welcome to Trac
+= OML =
+Trac is a '''minimalistic''' approach to '''web-based''' management of
+'''software projects'''. Its goal is to simplify effective tracking and
+handling of software issues, enhancements and overall progress.
+[[TOC(heading=OML Documentation, OML/*, depth=1)]]
+All aspects of Trac have been designed with the single goal to
+'''help developers write great software''' while '''staying out of the way'''
+and imposing as little as possible on a team's established process and
+culture.
+OML 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.
+As all Wiki pages, this page is editable, this means that you can
+modify the contents of this page simply by using your
+web-browser. Simply click on the "Edit this page" link at the bottom
+of the page. WikiFormatting will give you a detailed description of
+available Wiki formatting commands.
+== Description ==
+OML was originally conceived to provide measurement facilities for OMF-enabled testbeds, such as the [http://www.orbit-lab.org 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.
+"[wiki:TracAdmin trac-admin] ''yourenvdir'' initenv" created
+a new Trac environment, containing a default set of wiki pages and some sample
+data. This newly created environment also contains
+[wiki:TracGuide documentation] to help you get started with your project.
+'''What does that mean?'''
+You can use [wiki:TracAdmin trac-admin] to configure
+[http://trac.edgewall.org/ Trac] to better fit your project, especially in
+regard to ''components'', ''versions'' and ''milestones''.
+Well, 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.
+'''What sort of measurements can OML handle?'''
 TracGuide is a good place to start.
+OML 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.
+Enjoy! [[BR]]
+''The Trac Team''
+'''What sort of applications can OML be used for?'''
+== Starting Points
+OML 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.
+ * TracGuide --  Built-in Documentation
+ * [http://trac.edgewall.org/ The Trac project] -- Trac Open Source Project
+ * [http://trac.edgewall.org/wiki/TracFaq Trac FAQ] -- Frequently Asked Questions
+ * TracSupport --  Trac Support
+OML consists of two main components:
+For a complete list of local wiki pages, see TitleIndex.
+* 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.
+* 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.
+A 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.
+== Third Party Libraries ==
+* OML4J is a Java Injection Point (Maintained by NITLab it also has example of use within an Android application.
+* OML4JS is a !Javascript/!WebSocket library to collect measurements from webpages, maintained by Fraida Fund from NYU Poly.
+== Bugs ==
+If 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 mytestbed.net (does not require an account). Please attach log files and describe which version of OML and what platform you are using.
+== References and Citations ==
+The OML architecture is described in a few academic publications. Perhaps the most relevant are the following (see the attached BibTeX file [attachemnt: oml.bib]):
+Manpreet Singh, Max Ott, Ivan Seskar, and Pandurang Kama, "ORBIT measurements framework and library (OML): Motivations, design, implementation, and features," in !TridentCom 2005, Feb. 2005. [http://www.orbit-lab.org/raw-attachment/wiki/Orbit/Documentation/Publications/final-oml-paper.pdf [Download] ].
+Olivier 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 [http://www.nicta.com.au/pub?id=6718 [Download]]
+Jolyon White, Guillaum Jourjon, Thierry Rakotoarivelo, and Max Ott. "Measurement architectures for network experiments with disconnected mobile nodes," in TridentCom 2010, May 2010 [http://www.nicta.com.au/pub?id=3298 [Download]]