perfSONAR_PS::Services::MA::Topology - A module that provides methods for a Topology Service. The Topology Service can be used to make Topology Data available to individuals via webservice interface.
This module, in conjunction with other parts of the perfSONAR-PS framework, handles specific messages from interested actors in search of Topology data.
There are two major message types that this service can act upon: QueryRequest/SetupDataRequest - Allows queries to the database TopologyChangeRequest - Allows updates to the topology database =head1 API
If no subject is included, the semantics are "give me the whole database",
and a XQuery for "//*" (i.e. everything) is submitted to the backend database.
If an xquery subject is included, the semantics are "use the included
XQuery to query the database". It simply passes the included XQuery to the
If any other subject is included, an invalid subject error is thrown.
If an "http://ggf.org/ns/nmwg/topology/query/all/20070809" eventType is
included in the metadata, the entire backend database is returned.
If an "http://ggf.org/ns/nmwg/topology/query/xquery/20070809" eventType is
included in the metadata, an xquery subject must be included as well. The
xquery inside the xquery subject will be passed to the backend database.
The metadata contains an eventType specifying how the data should modify
the backend database and the data contains a topology wrapper containing
the topology elements to add or update.
If the eventType is "http://ggf.org/ns/nmwg/topology/change/add/20070809",
the elements in the data segment are added to the database. If any of the
elements (based on identifiers), already exist in the database, an error is
If the eventType is
"http://ggf.org/ns/nmwg/topology/change/update/20070809", the elements in
the data segment are merged with the existing elements with the same
identifier in the database. If any element in the data segment does not
exist in the database, an error will be returned.
If the eventType is
"http://ggf.org/ns/nmwg/topology/change/replace/20070809", the elements in
the data segment are added to the database. If any of the elements already
exist in the database, they will be replaced with the element in the data
perfSONAR_PS::Services::Base, perfSONAR_PS::Services::MA::General, perfSONAR_PS::Common, perfSONAR_PS::Messages, perfSONAR_PS::Client::LS::Remote, perfSONAR_PS::Topology::Common, perfSONAR_PS::Client::Topology::XMLDB
To join the 'perfSONAR-PS' mailing list, please visit:
The perfSONAR-PS subversion repository is located at:
Questions and comments can be directed to the author, or the mailing list.
Aaron Brown, firstname.lastname@example.org
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 (c) 2004-2008, Internet2 and the University of Delaware
All rights reserved.
To install perfSONAR_PS::Services::MA::Topology, copy and paste the appropriate command in to your terminal.
perl -MCPAN -e shell
For more information on module installation, please visit the detailed CPAN module installation guide.