== Measurement Manager Evaluation ==

The Measurement Manager Package delivers a model_builder features, which uses Flowvisor data structures to generate Nagios configurations, nox features that use the Flowvisor API to generate a GMOC exchange format file, and scripts to add to nox installation that control the logic for L2 learning switch, as well as a debugging application.

Time Frame: The Measurement Manager software was made available on May 31st, and evaluation started June 7th. 

== Measurement Manager Findings ==

== Measurement Manager How-to ==

Download software from meas_manager and unpacked. Package contains 2 READMEs and one INSTALL instruction files.  The meas_manager/nox/meas_monitor/INSTALL file states:

{{{
INSTALL

git clone git://noxrepo.org/nox
<<<missing cd nox>>>
git checkout -b destiny remotes/origin/destiny

To create the component directory, 
make sure (nox/src/scripts is in your path and) execute:

cd nox/src/nox/netapps
nox-new-py-app.py meas_monitor <<do not exist as stated>>  ../../scripts/nox-new-py-app.py
nox-new-py-app.py grnoc_switch <<do not exist as stated>>

Copy the python components into their corresponding 
directories, from meas_manager/nox/meas_monitor/

grnoc_switch.py to nox/src/nox/netapps/grnoc_switch/grnoc_switch.py
meas_monitor.py to nox/src/nox/netapps/meas_monitor/meas_monitor.py

Compile NOX as usual:
 ./boot.sh
 mkdir build
 cd build
 ../configure
 make -j

To run NOX, with the meas_monitor and grnoc_switch components:
        cd src
        ./nox_core -i ptcp:6633 meas_monitor grnoc_switch

}}}

Was able to execute the INSTALL instructions without any problem. Next the two README files includes:

'''meas_manager/model_builder/README'''
{{{
#--------------------------------------------------------------------
# README
#--------------------------------------------------------------------

ABOUT
These Perl modules build Flowvisor datastructures that contain
references to slice and device objects. These are then used, to
generate a Nagios configuration file. The driver script (go.pl) can be
edited to enable you to import this Flowvisor information for other
applications, and the Fvctl moldule can be extended for other XMLRPC
calls to Flowvisor.

Note: The latest version of Flowvisor contains the utility ( fvcli ) 
that allows users to remotely query the Flowvisor and can be extended
to achieve similar functionality.

INSTRUCTIONS
1) You may need to install the Frontier::Client Perl module
        For Debian/Ubuntu:
                apt-get install libfrontier-rpc-perl

2) Specify the URL(s) of the Flowvisor(s) that you have access to in go.pl
        Ex. "https://[username]:[password]\@[hostname]:8080/xmlrpc"
        Note: We placed the credentials in Auth.pm

3) To run the script to generate Nagios configuration files, run:
        perl go.pl

   Which will generate:
        auto-openflow.cfg

4) This script can then be imported into Nagios ( http://www.nagios.org/ )

   This script needs to be placed in:
        /usr/local/nagios/etc/

   The file /usr/local/nagios/etc/nagios.cfg will need to be edited to 
   contain the following line:
        cfg_file=/usr/local/nagios/etc/auto-openflow.cfg   

   To check the sanity of the new configuration file, run:
        sudo /usr/local/nagios/bin/nagios -v /usr/local/nagios/etc/nagios.cfg

   If the config is sane, you can reload Nagios with your new configurations
        sudo /etc/init.d/nagios restart

COMMON ERRORS
1) "No method: Flowvisor::set_username at go.pl line 54"
        Be sure to specify the proper credentials in Auth.pm or go.pl

}}}

'''./meas_manager/nox/gen_topo/README'''
{{{
ABOUT
This package uses the Flowvisor API to generate a GMOC exchange format file.

This should contain all nodes, interfaces and links between OF switches 
connected to that Flowvisor

--Chris Small 

INSTRUCTIONS
To run:
   perl gen_top.pl


}}}



[[BR]]

{{{
#!html
<a href="mailto:luisa.nevers@bbn.com">Email us</a> with any questions and feedback on this page!
}}}