Table of Contents
The WS MDS Index Service collects information about grid resources and publishes that information as a service group. Client programs use resource property queries or subscription/notification to retrieve information from the index. Information can be added to the index via a number of different mechanisms: since the Index Service is implemented using the Aggregator Framework, any aggregator source can be used to provide information for the index.
This document describes the programmatic interfaces to the Index Service. See also general Globus Toolkit coding guidelines and GT 4.0 best practices.
Features new in release 4.0
Based on WSRF rather than OGSI
- Aggregated data is published through WS-Resource Properties mechanisms
- The aggregator framework module (basis of the index service) collects data from monitored resources using WS-Resource Properties collection mechanisms, including the base WS-Resource Properties poll operations and WS-Notification.
- Persistent configuration of aggregations has been refactored. The service no longer has its own config file for specifying aggregations. Instead a separate client is used to make appropriate registrations. This client may be started alongside the container for the equivalent effect. The client may also be deployed elsewhere to support resource-side configuration (providing similar functionality to the GT3.2 RegistryPublishProvider) or at a third location.
Other Supported Features
- The index appears as a ServiceGroup (defined in WSRF) which lists registered resources alongside dynamically collected information from those resources. This information can be examined using (for example) XPath queries to discover resources that match desired constraints.
Deprecated Features
- Support for Xindice and aggregated data persistence has been removed.
- The ability to specify default aggregations in service config file has been removed (see item in 'New Features').
- Non-ServiceGroupRegistration methods for managing aggregations have been removed; the equivalent functionality is available through the ServiceGroupRegistration port type which is available in both GT3.2 and GT 3.9.3.0 versions of the index service.
Tested Platforms for WS-MDS Index Service:
- Linux on i386
- Windows XP
Tested containers for WS-MDS Index Service:
- Java WS Core container
- Tomcat 5.0.28
Protocol changes since GT version 3.2
- Generally incompatible with the GT3.2 index service as the service has been remodelled to use WSRF instead of OGSI.
API changes since GT version 3.2
- The aggregator framework API used internally has retained the general flavor of the GT3.2 aggregator framework API, but is not directly compatible with it.
Schema changes since GT version 3.2
- Schemas used for configuration and publishing are conceptually similar but are not compatible, primarily due to WSRF remodelling.
The Index Service depends on the following GT components:
The Index Service depends on the following 3rd party software:
- None
The security considerations for the Aggregator Framework also apply to the Index Service:
By default, the aggregator sources do not use authentication credentials -- they retrieve information using anonymous SSL authentication or no authentication at all, and thus retrieve only publicly-available information. If a user or administrator changes that configuration so that a service's aggregator source uses credentials to acquire non-privileged data, then that user or administrator must configure the service's aggregator sink to limit access to authorized users.
There are essentially two interfaces to the Index Service -- one for getting information into the index, and one for retrieving information from the index.
Information is retrieved from the Index Service as service group entries using the standard WS MDS Core APIs for resource property queries or subscription/notification.
Because the Index is implemented as a WS MDS Aggregator Framework, the programmatic interface for getting information into the index is to create an aggregator source. The Aggregator Framework's architecture is described in the next section.
The WS MDS Aggregator Framework is the software framework on which WS MDS 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 resource properties, acquire data through subscription/notification, and execute programs to generate data. Another way of describing the Aggregator Framework is that it is designed to facilitate the collecting of information from or about WS-Resources via plugin aggregator sources and the feeding of that information to plugin aggregator sinks, which can then perform actions such as re-publishing, logging, or archiving the information.
Aggregators work on a type of service group called an
AggregatorServiceGroupRP. Resources may be
registered to an AggregatorServiceGroupRP using the service
group add
operation, which will cause an entry to be
added to the service group. The entry will include configuration
parameters for the aggregator source; when the registration is
made, the appropriate aggregation source and sinks will be
informed; the aggregator source will begin collecting data and
inserting it into the corresponding service group entry, and the
aggregator sink will begin processing the information in the
service group entries.
The method of collection by source and processing by the sink is dependent on the particular instantiation of the aggregator framework.
The aggregator sinks distributed with the toolkit
(org.globus.mds.aggregator.impl.ServiceGroupEntryAggregatorSink
and org.globus.mds.trigger.impl.TriggerResource
) are
described in the following table.
Table 1. Standard aggregator sinks
Aggregator Sink | Service Implemented | Description |
---|---|---|
ServiceGroupEntryAggregatorSink | Index Service | The servicegroup sink (used by the Index Service) publishes received data as content in the AggregatingServiceGroup entry used to manage the registration. This data can therefore be retrieved by querying the index for its 'entries' resource property. |
TriggerResource | Trigger Service | The Trigger Service provides an aggregator sink which receives data, applies tests to that data, and if the tests match, runs a specified executable. See the trigger service documentation for more information. |
The aggregator sources supplied with the toolkit collect information using resource property queries (query sources), subscription/notification (subscription sources), and execution of external programs (execution sources).
The aggregator sources supplied with the Globus Toolkit are listed in the following table.
Note | |
---|---|
All aggregator sources listed in this
table are in the |
Table 2. Standard aggregator sources
Aggregator Source | Description |
---|---|
QueryAggregatorSource | The query source collects information from a registered resource by using WS-Resource Properties polling mechanisms:
Polls are made periodically, with both the period and target Resource Properties specified in the registration message. |
SubscriptionAggregatorSource | The subscription source collects information from a registered resource using WS-Notification mechanisms. Data is delivered when property values change, rather than periodically. |
ExecutionAggregatorSource | The execution source collects information about (not necessarily from) a registered resource by execution of a local executable, which is passed as input the identity of the registered resource. Details of the interface between the execution source and local executables are in Configuring the Execution Aggregator Source. |
The semantics and syntax of the APIs and WSDL for the component, along with descriptions of domain-specific structured interface data, can be found in the public interface guide.
Information is retrieved from the index using the standard Java WS Core API calls for getting resource property information:
GetResourceProperty
to request a single resource property by name,GetResourceProperties
to request several resource properties by name,QueryResourceProperty
to perform an XPath query on a resource property document, and- the notification/subscription mechanism.
See the Java WS Core Developer's Guide for API details.
Information is added to an index by way of an aggregator source.
The Globus Toolkit distribution includes several standard aggregator sources (see the Aggregator Sources Reference for more details).
To create your own custom information source, see the WS MDS Aggregator Framework Developer's Guide.
Use of the index service is covered in the Build a Grid Service Tutorial (GlobusWORLD 2005).
See the Debug section of the Java WS Core Developer's Guide for general information on logging, including which files to edit to set logging properties.
To turn on debug logging for the Index Service, add the line:
log4j.category.org.globus.mds.index=DEBUG
to the appropriate properties file. Since the Index Service is implemented using the aggregator framework, you may also want to turn on aggregator debugging by adding this line:
log4j.category.org.globus.mds.aggregator=DEBUG
General troubleshooting information can be found in the GT 4.0 Java WS Core Developer's Guide.
Specifications for resource properties, service groups, and subscription/notification are available at http://www.globus.org/wsrf/.