GT 3.9.5 WS MDS Aggregator: User's Guide

Introduction
Command-line tools
Graphical user interfaces
Troubleshooting

Introduction

The WS-MDS Aggregator is the software framework on which WS-MDS services (currently, the WS-MDS Index and WS-MDS Trigger services) are built. The aggregator framework collects data from an aggregator source and sends that data to an aggregator sink for processing. Aggregator sources distributed with the Globus Toolkit include modules that query service data, acquire data through subscription/notification, and execute programs to generate data. Aggregator sinks include modules that implement the WS-MDS Index service interface and the WS-MDS Trigger service interface.

In general, end-users will not interact directly with the aggregator framework; instead, they will interact with clients specific to the aggregator sources and aggregator sinks.

Command-line tools

Command-line tool `mds-servicegroup-add` for WS MDS Aggregator

Tool description

mds-servicegroup-add creates a set of registrations to a WS-ServiceGroup and periodically renews those registrations. It is intended primarily for registering grid resources to MDS services such as the index and trigger services.

Registrations are defined in an XML configuration file, which is documented in the Aggregator Framework System Administrator's Guide.

Command syntax

mds-servicegroup-add -s http://foo [options] config.xml

Options and Arguments

`-s http://foo`	This dummy option is required but ignored. All end point references used by `mds-servicegroup-add` are read from the configuration file, not the command line.
`-a`	By default, `mds-servicegroup-add` will attempt to make an authenticated connection to each service group. This option is used to specify anonymous connections (and to prevent `mds-servicegroup-add` from failing if you don't have a valid Grid credential).
config.xml	the configuration file

The other standard toolkit options [TODO -- link to standard options page] are also supported.

Limitations

It is necessary for the tool to continue to run in order for the registrations that it maintains to be kept alive, as registrations will otherwise time out.

Graphical user interfaces

There is no GUI specifically for the aggregator framework. The release contains a tech preview of WebMDS which can be used to display monitoring information in a web browser. Specifically, it can be directed at services based on the aggregator framework to display information about resources registered to the aggregator framework.

Troubleshooting

End-users do not generally interact directly with the aggregator framework.

General troubleshooting information can be found in the GT 3.9.5 Java WS Core User's Guide.