THREDDS Reference: TDS Configuration Directory

All TDS configuration information is stored in the TDS configuration directory. The default location for the TDS configuration directory is

${TOMCAT_HOME}/content/thredds

The TDS configuration directory is created and populated with default files the first time the TDS is deployed. It is persistent even when a TDS installation is upgraded or re-deployed. All modifications and additions to the TDS configuration should be made in this directory. Do not place files containing passwords or anything else with security issues in this directory. Typically you will only be adding and modifying catalogs and configuration files.

Content of Configuration Directory

When the TDS is first deployed, the TDS configuration directory looks like:

• ${TOMCAT_HOME}/content/thredds/
  • catalog.xml - the main TDS configuration catalog (root catalog for TDS configuration)
  • enhancedCatalog.xml - an example catalog [Note: It is referenced from catalog.xml.]
  • threddsConfig.xml - configuration file for allowing non-default services, configuring caching, etc (more detailed information).
  • logs/
    • catalogInit.log - log file for messages generated while reading TDS configuration catalogs during TDS initialization and reinitialization.
    • threddsServlet.log - TDS error log file.

Changing the Default Location of Configuration Directory

TDS 4.0 supports configuring the location of the "content/thredds" directory by setting the "tds.content.root.path" system property. For instance, by adding the following to JAVA_OPTS in your startup script:

-Dtds.content.root.path=/some/absolute/path;

The TDS will use the configuration files in:

/some/absolute/path/thredds

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