NAME
perfSONAR_PS::Services::MA::Topology - A module that provides methods for the Topology MA.
DESCRIPTION
This module aims to offer simple methods for dealing with requests for information, and the related tasks of interacting with backend storage.
SYNOPSIS
use perfSONAR_PS::Services::MA::Topology;
my %conf = readConfiguration();
my %ns = ( nmwg => "http://ggf.org/ns/nmwg/base/2.0/", ifevt => "http://ggf.org/ns/nmwg/event/status/base/2.0/", nmtopo => "http://ogf.org/schema/network/topology/base/20070828/", );
my $ma = perfSONAR_PS::Services::MA::Topology->new(\%conf, \%ns);
# or # $ma = perfSONAR_PS::Services::MA::Topology->new; # $ma->setConf(\%conf); # $ma->setNamespaces(\%ns);
if ($ma->init != 0) { print "Error: couldn't initialize measurement archive\n"; exit(-1); }
$ma->registerLS;
while(1) { my $request = $ma->receive; $ma->handleRequest($request); }
API
The offered API is simple, but offers the key functions needed in a measurement archive.
init
Initializes the MA and validates the entries in the
configuration file. Returns 0 on success and -1 on failure.registerLS($self)
Registers the data contained in the MA with the configured LS.receive($self)
Grabs an incoming message from transport object to begin processing. It
completes the processing if the message was handled by a lower layer.
If not, it returns the Request structure.handleMessage($self, $messageType, $message) Handles the specific message. This should entail iterating through the metadata/data pairs and handling each one.
handleMetadataPair($$$$) { Handles a specific metadata/data request.
SEE ALSO
perfSONAR_PS::Services::Base, perfSONAR_PS::Services::MA::General, perfSONAR_PS::Common, perfSONAR_PS::Messages, perfSONAR_PS::Client::LS::Remote
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:$
AUTHOR
Aaron Brown, aaron@internet2.edu
LICENSE
You should have received a copy of the Internet2 Intellectual Property Framework along with this software. If not, see <http://www.internet2.edu/membership/ip.html>
COPYRIGHT
Copyright (c) 2004-2007, Internet2 and the University of Delaware
All rights reserved.