NAME

perfSONAR_PS::Services::MP::Agent::Base - A module that contains the basic methods involved in gathering data by some means and parsing it's output. This module should be inherited to provide a consistent interface to the gathering (collecting), parsing and storage of data for different perfsonar MP services.

DESCRIPTION

The purpose of this module is to create objects that contain all necessary information to make measurements and understand the output.

SYNOPSIS

# create a new agent
my $agent = new perfSONAR_PS::Services::MP::Agent::Base();

# do some setting up
$agent->init();

# perform the measurement collection
if ( $agent->collectMeasurements() == 0 ) {
	# we have successfully collected the measurements, we must now extract the
	# results into a form which is useable
	  	
	# spit out something useful
	use Data::Dumper;
	print "Results in raw parsed: " . Dumper $agent->results() . "\n";
	
	# or as XML
	print "Results XML: " . $agent->xml() . "\n";
	
} else {
  # all errors should be stored under $agent->error()
	print STDERR "Could not collect measurements: " . $agent->error() . "\n";
}

new()

Creates a new agent class, all results should be stored under $self->{RESULTS} in some format that is understood internally by the class. This should be overloaded by inheriting classes.

error( $text )

accessor/mutator method for storage and or retrieval of errors in executation all methods should call this method with a human readable string $text when things go wrong

timeout

accessor/mutator for the timeout value of command line run's

init()

Initiate any datastructures/connections etc prior to collecting any measurements

Return:

-1 = something failed
 0 = initialisation was okay

Should be overloaded by inherited classes when needed.

collectMeasurements( )

Do something to enable the collection of the results. After running the command we MUST always call the parse() function in order to format the output into an understanable datastructure which can then be used later.

Return:

-1 = something failed
 0 = command ran okay

This method should be inherited.

parse( \@results, $time )

Parses the data in the array of string @results into internal hash of variable=value. on success, returns 0, otherwise -1;

destination( $string )

accessor/mutator method to set the destination to ping to

destinationIp( $string )

accessor/mutator method to set the destination ip to ping to

destination( $string )

accessor/mutator method to set the destination to ping to

destinationIp( $string )

accessor/mutator method to set the destination ip to ping to

results( )

Accessor/Mutator function for the result of the output in some internal datastructure.

fromDOM( )

Accepts a DOM object and determines the relative paramters to create and use for the test

toDOM( )

Returns the full nmwg message (metadata and data elements) for the results that have been collected. Output should be a XML::LibXML::Document object.

resultsSQL( $namespace )

Returns the relevant SQL insert or update statement for the results.

resultsRRD( $namespace )

Returns the relevant RRD statement for the results.

SEE ALSO

perfSONAR_PS::Common,

To join the 'perfSONAR-PS' mailing list, please visit:

https://mail.internet2.edu/wws/info/i2-perfsonar

The perfSONAR-PS subversion repository is located at:

https://svn.internet2.edu/svn/perfSONAR-PS 

Questions and comments can be directed to the author, or the mailing list.

VERSION

$Id: PingER.pm 242 2007-06-19 21:22:24Z zurawski $

AUTHOR

Yee-Ting Li, <ytl@slac.stanford.edu>

COPYRIGHT AND LICENSE

Copyright (C) 2007 by Internet2

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.8 or, at your option, any later version of Perl 5 you may have available.

cpanm IEPM::PingER::Statistics::RTT

perl -MCPAN -e shell
install IEPM::PingER::Statistics::RTT