Home -> Toolkit -> Docs -> Development -> 3.9.5 -> Info -> Index -> User

GT 3.9.5 WS MDS Index Service: User's Guide

• Introduction
• Command-line tools
• Graphical user interfaces
• Troubleshooting

Introduction

This guide contains information for end-users of the WS MDS Index Service. The Index Service collects information about grid resources and publishes them as service group entries.

Command-line tools

• End-User tools
• wsrf-query
• wsrf-get-property
• wsrf-get-properties
• Administrative tools
• mds-servicegroup-add

End-user command line tools for WS MDS Index Service

The index service exposes information via service groups and is accessed using the same command-line tools used to query other WSRF services for information. These tools are documented in detail in the Java WS Core User's Guide.

• wsrf-query performs a query on a resource property document
• wsrf-get-property gets a single resource property
• wsrf-get-properties gets multiple resource properties.

Administrative command-line tools for WS MDS Index Service

mds-servicegroup-add

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).
-z auth_type	Specify an authorization type: self, to fail if the server's identity is different from the user's identity, host, to fail if the server does not have a valid server certificate, or none to continue regardless of the server's identity.
config.xml	the configuration file

The syntax of the configuration file used by mds-servicegroup-add is described in detail in the MDS Index Public Interface Guide. In addition, the Globus Toolkit distribution includes an example configuration file $GLOBUS_LOCATION/etc/globus_wsrf_mds_aggregator/example-aggregator-registration.xml.

The simplest way to register services to an index is to edit the example file, replacing the EPRs in that file with the EPRs for your resources, and then to run mds-servicegroup-add to perform the registrations specified in that file.

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 Index Service. The release contains a tech preview of WebMDS which can be used to display monitoring information collected in an Index Service in a normal web browser.

Troubleshooting

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