GT 3.9.4 WS MDS Index Service: User's Guide

Introduction

[End user-friendly introduction AND references to the Toolkit-level User's Guide where they can find general end user-oriented information]

Command-line tools

  • mds-servicegroup-add
  • Other command line tools

    • mds-servicegroup-add for WS MDS Index Service

    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 admin 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.

    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.

    Other command line tools for WS MDS Index Service

    The index service exposes information via service groups, so command line tools like wsrf-query and wsrf-get-property can be used to query it. See the GT Java WS Core User's Guide for more information about how to use these tools.

    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

    [user-friendly help on common problems they may encounter]