WebMDS can be configured to get information from any of various sources and to filter it through any XSL transform. WebMDS uses configuration files to specify the location of (and to name) sources of information and xsl and web form arguments to select among these configured information sources and xsl transforms.

By default, WebMDS comes configured to report information about an index server using transaction-level security on the default port (8443) on the local system. If you are running the Globus Toolkit in this default configuration, then you can use WebMDS to query your local Index Service without any configuration changes.

If you wish to monitor a different index server, you will need to edit the file $GLOBUS_LOCATION/lib/webmds/conf/indexinfo to change the URL in the line:

    <value>https://127.0.0.1:8443/wsrf/services/DefaultIndexService</value>

to match the URL of your default index service. Changes to WebMDS configuration files take effect the next time that Tomcat is restarted.

For other configuration changes (e.g., monitoring different kinds of services), see the detailed configuration information below.

2. Syntax of the interface

Each configuration file in $GLOBUS_LOCATION/lib/webmds/conf defines a source of XML, which can be used in an HTML form to specify sources of information and XSL transforms. The distribution contains some standard configuration files in this directory, including:

Table 1. Pre-configured information sources

`indexinfo`	all resource properties from an index server running with transaction-level security on port 8443 on the local host
`indexinfo_nosec`	all resource properties from an index server running with no security on port 8080 on the local host
`openEndedQuery`	all resource properties from a user-specified grid service
`openEndedRP`	a user-specified resource property from a user-specified grid service
`servicegroupxsl`	an xsl transform that presents summary information about a service group
`sgedetail`	an xsl transform that presents detailed information about a service group entry

Each configuration file defines a WebmdsConfig object. A WebmdsConfig object consists of:

A description: a textual description of the XML source being defined.
A className: the name of the Java class that will be used to acquire the XML data.
Zero or more parameter objects, each of which consists of the name of some parameter recognized by the Java class specified by className, and the string value of that parameter.

For example, this is $GLOBUS_LOCATION/lib/webmds/conf/servicegroupxsl, which defines the servicegroupxsl XML source:

    <WebmdsConfig>
      <description>
         XSL file to show service group summary information
      </description>
      <className>org.globus.mds.webmds.xmlSources.file.FileXmlSource</className>
      <parameter>
        <name>file</name>
        <value>xslfiles/servicegrouptable.xsl</value>
      </parameter>
    </WebmdsConfig>

This file tells WebMDS to use the org.globus.mds.webmds.xmlSources.file.FileXmlSource Java class (a class which reads XML from a local file) to collect XML data and to pass a file parameter (which that Java class interprets as the name of the file to open, relative to the WebMDS base directory).

Tomcat must be restarted (or one of the more advanced Tomcat administrative mechanisms must be used) for changes to these configuration files to take effect.

3. XML Sources included with WebMDS

3.1. FileXMLSource

The class org.globus.mds.webmds.xmlSources.file.FileXmlSource reads XML from a file, and recognizes a single parameter:

Table 2. Configuration parameters used with FileXMLSource

file The name of the file to read. Relative path names are interpreted relative to the WebMDS base directory ($GLOBUS_LOCATION/lib/webmds).

3.2. NodeXMLSource

This XML source class uses a WebmdsNodeSource object to fetch an XML document and return it in a form that is usable by WebMDS. It recognizes the following options:

Table 3. Configuration parameters used with NodeXMLSource

`class`	The name of a class that implements the WebmdsNodeSource interface. An instance of this class will be used to get an XML document.
parameters	Additional parameters are passed to an instance of the class specified by the `class` argument.

3.3. Classes That Implement WebmdsNodeSource

The following classes implement the NodeXMLSource interfaces and can be used in conjunction with NodeXMLSource

3.4. ResourcePropertyQueryNodeSource

This class performs a resource property query to get all the resource properties for some web service. It recognizes the following configuration parameters:

Table 4. Configuration parameters used with ResourcePropertyQueryNodeSource

`endpoint`	The endpoint name to be used in a resource property query.
`endpointKeyName` and `endpointKeyValue`	An optional key/value pair to use as reference properties for the endpoint specified with the `endpoint` parameter.
`allowUserEndpoints`	If `true`, values for `xmlSource.sourceName.param.endpoint`, `xmlSource.sourceName.param.endpointKeyName`, and `xmlSource.sourceName.param.endpointKeyValue` specified in the request will override the configured endpoint value.
`endpointFile`	The name of a file from which the endpoint information (in XML) will be read. This configuration parameter can never be overridden by request arguments.

3.5. ResourcePropertyNodeSource

This class queries a web service for a single resource property. It recognizes the following parameters:

Table 5. Configuration parameters used with ResourcePropertyNodeSource

`endpoint`	The endpoint name to be used in a resource property query.
`endpointKeyName` and `endpointKeyValue`	An optional key/value pair to use as reference properties for the endpoint specified with the `endpoint` parameter.
`allowUserEndpoints`	If `true`, values for `xmlSource.sourceName.param.endpoint`, `xmlSource.sourceName.param.endpointKeyName`, and `xmlSource.sourceName.param.endpointKeyValue` specified in the request will override the configured endpoint value.
`endpointFile`	The name of a file from which the endpoint information (in XML) will be read. This configuration parameter can never be overridden by request arguments.
`rpNamespace`	The namespace part of the QName of the resource property to be queried for.
`rpName`	The local name part of the QName of the resource property to be queried for.
`allowUserResourceProperties`	If `true`, values of `xmlSource.sourceName.param.rpNamespace` and `xmlSource.sourceName.param.rpNames` specified in the request will override the configured resource property namespace and name.

Prev		Next
GT 4.1.3 WS MDS WebMDS: System Administrator's Guide	Home	Deploying