GT 4.0 WS MDS Index Service: Registering an RFT service to an Index

This document gives instructions on how to register an RFT service to an Index Service. The registration process consists of two steps: creating a configuration file that specifies the registration parameters (including what resources to register, and what index to register to), and then using the mds-servicegroup-add tool to perform the registrations described in that configuration file.

• Prerequisites
• Creating the Configuration File
• Running mds-servicegroup-add

Prerequisites

Before you begin, you must:

• have a working RFT service, as documented in the RFT administrators guide.
• have a working index service, as documented in the main Index Service administrators guide.
• know the URL to the reliable file transfer factory. This can be seen in the container output at startup of the container on the RFT host, and will look something like this:
  https://myhost:8443/wsrf/services/ReliableFileTransferFactoryService
• know the URL to the index service. This can be seen in the container output at startup of the container on the index host, and will look something like this:
  https://myhost:8443/wsrf/services/DefaultIndexService

Creating the Configuration File

The configuration file includes sections that specify some default values and one or more ServiceGroupRegistrationParameters sections, each of which specifies the registration parameters for an entity to be registered (such as an RFT factory service).

The Globus Toolkit distribution includes an example configuration file in $GLOBUS_LOCATION/etc/globus_wsrf_mds_aggregator/example-aggregator-registration.xml; this file includes a ServiceGroupRegistrationParameters section for RFT. The only thing that you might need to change in that section is the address, which should be the address of your RFT factory service.

If you are already using mds-servicegroup-add to register resources to your index, then you can simply add the RFT ServiceGroupRegistrationParameters section to your existing file.

If you don't already have an aggregator framework registration configuration file, you can start with the example file. In this case, you will also need to edit the address in the defaultServiceGroupEPR section to make it correspond to your default index service.

Running mds-servicegroup-add

To run mds-servicegroup-add, run the following:

$GLOBUS_LOCATION/bin/mds-servicegroup-add -a -z none \
       -s http://foo your_config_file.xml &

where your_config_file is the configuration file that you created. The mds-servicegroup-add process will continue running to keep the registrations alive.

Note: the -s http://foo is a dummy option that is required but ignored.