Unidata - To provide the data services, tools, and cyberinfrastructure leadership that advance Earth system science, enhance educational opportunities, and broaden participation. Unidata
         
  advanced  
 

TDS Catalog Generation Service


DEPRECATED

The TDS Catalog Generation service has been DEPRECATED. Instead, please use datasetScan elements in TDS catalog configuration files.



Configuration

The TDS Catalog Generation service must be enabled in the threddsConfig.xml configuration file before it can be used. This is done by adding the following:

  <CatalogGen>
<allow>true</allow>
</CatalogGen>

Usage

The Catalog Generation service provides a web interface for controlling your catalog generation tasks. To use the catalog generation admin pages, TDS remote management must be setup and requires login with the "tdsConfig" role. The catalog generation admin pages are located at:

http://server:port/thredds/cataloggen/admin/

You will see something like:

CatalogGen Admin Page

Each row in the web form table is a single catalog generation task. The form allows users to look at the configuration files and control the frequency at which each catalog is generated. When a task's period is set to zero, as in the two sample tasks shown above, the task is not scheduled to run. The initial delay value allows the tasks to be delayed rather than starting immediately upon scheduling; this can be used so that all the tasks do not start running upon startup of the servlet.

Before a new catalog generation task can be added a Catalog Generator configuration file is required.

Catalog Generator Configuration Documents

A CatalogGen configuration document is an XML document that describes how to produce a THREDDS catalog by scanning or crawling one or more dataset collections. Each CatalogGen configuration document is a skeleton THREDDS catalog containing one or more metadata elements of type "CatalogGenConfig". Each "CatalogGenConfig" metadata element will be replaced by dataset elements representing the datasets that make up the collection described by that metadata element.

 You will need to write a CatalogGen configuration document that describes how to access the datasets you want to catalog, how to group those datasets, and how to name those datasets. The syntax and meaning of the CatalogGen config files are described on the "CatalogGen Configuration" page.


This document is maintained by Unidata and was last updated February 2009. Send comments to THREDDS support.

 

 
 
  Contact Us     Site Map     Search     Terms and Conditions     Privacy Policy     Participation Policy
 
National Science Foundation (NSF) UCAR Community Programs   Unidata is a member of the UCAR Community Programs, is managed by the University Corporation for Atmospheric Research, and is sponsored by the National Science Foundation.
P.O. Box 3000     Boulder, CO 80307-3000 USA     Tel: 303-497-8643     Fax: 303-497-8690