= Orbit Measurement Library (OML)=

[[TOC(Software/d*, depth=2)]]

The ORBIT measurement library (OML), is a distributed software framework enabling real-time collection of data in a large testbed environment.

Although this framework was originally developed for ORBIT, it has been re-factored and significantly extended by [https://research.csiro.au/ng/ Data61 CSIRO] to allow its independent deployment on any testbed.

OML has three major components :

  * The '''OML-Service''', which can generate wrapper code for a c/c++ applications to interact with OML and also creates runtime experiment client/server files based on an experiment definition.
  * The '''OML-Client''' library, which is deployed on the nodes participating in the experiment and can aggregate and filter data from the applications participating in the experiment and send it to a central server.
  * The '''OML-Collection-Server''', which collects filtered data coming from all nodes involved in the experiment and stores it in a mySQL database.

'''Publications''' :

  * The original OML paper:[[BR]]
    [http://www.orbit-lab.org/attachment/wiki/Orbit/Documentation/Publications/final-oml-paper.pdf ORBIT Measurements Framework and Library (OML): Motivations, Design,Implementation, and Features] Manpreet Singh, Maximilian Ott, Ivan Seskar and Pandurang Kamat, proceedings of IEEE Tridentcom 2005, Trento, Italy, Feb 2005
  * The recent paper on current OML release:[[BR]]
    [http://www.nicta.com.au/pub-download/full/6718 An Instrumentation Framework for the Critical Task of Measurement Collection in the Future Internet] O. Mehani, G. Jourjon, T. Rakotoarivelo and M. Ott., Elsevier Computer Networks, pp. 68-83, 2014

== Starting Points ==

 * Download binary packages and source code at [https://oml.mytestbed.net]
 * [wiki:Documentation/OML/FAQ FAQ]

== For Experimenters ==

 * A collection of OML Applications can be found at https://oml.mytestbed.net/projects/omlapp

== For Developers ==

 * Find a developer tutorial here [https://oml.mytestbed.net/projects/oml/wiki/Quick_Start_Tutorial]
 * Check out source using '''git clone git://git.mytestbed.net/oml.git''' or browse code at [http://git.mytestbed.net/?p=oml.git;a=summary] (NICTA version)
 * Check out source using [http://www.subversion.org subversion] at  http://svn.orbit-lab.org/svn/orbit/oml/trunk. [[BR]] (WINLAB version)