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.

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

  # 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";
  }

  

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.

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

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

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. =cut sub init { my $self = shift; return 0; }

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. =cut sub collectMeasurements { my ($self) = @_; $logger->logdie( "parse() is a virtual method, please override with inherited implementation.");

  # example flow; we gather the output from running some tool and then 
  # we need to translate the output into some internal datastructure using
  # the parse() method.

  my $output = 'Output from some tool';
  $self->parse( $output );

  return 0;
}

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

accessor/mutator method to set the destination to ping to

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

accessor/mutator method to set the destination to ping to

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

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

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

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

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

Returns the relevant RRD statement for the results.

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.

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

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

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.