Skip to content

Administrator Guide

Jennifer Oxelson edited this page Sep 4, 2020 · 2 revisions

Intended Audience:

  • People who install and/or maintain the TDS
  • People who modify TDS configurations
  • People who modify existing catalogs in ${tds.content.root.path}/thredds/

Assumption: Users of this guide do NOT have prior knowledge of Unidata jargon, meteorology, netCDF, TDS, etc.

I. Installation & Upgrading

  • System Requirements
  • Download
  • Tomcat sentenv.sh
  • Deploying TDS
  • Creation of TDS content directory
  • Tomcat manager
  • TDM installation
  • Run behind proxy
  • Security Recommendations (currently the putting TDS into production)
  • Upgrading

II. TDS Overview & Structure

  • TDS structure & how it interacts with the servlet container
  • TDS content directory tour
  • Recommended places to store your datasets

III. Configuration

  • Catalog
  • Constructing Access URLs
  • Making Data Accessible
    • Nested Datasets
    • Remote Datasets
    • datasetRoot Element
    • datasetScan Element
    • NcML
      • Modifying an existing dataset
      • Virtual datasets
      • NcML aggregation
    • Feature Collections
    • Collection Specification String
  • Adding Metadata
    • Describing datasets
    • Exporting THREDDS datasets to digital libraries
    • Sharing metadata amongst multiple datasets
  • Making Data Available Via Services
    • Available Services
    • Adding Services
      • Multiple services via the Compound Service Element
    • Dataset Source Plugin
  • Organizing Catalogs
    • Catalog references
  • TDS Configuration Catalog Files
    • TDS content directory layout
    • ${tds.content.root.path}/thredds/catalog.xml
    • ${tds.content.root.path}/thredds/threddsConfig.xml
    • Revisit the catalog refs
  • Customizing the TDS Look and Feel
    • Server Information
    • CSS Stylesheets
    • Thymeleaf Templates
    • Jupyter Notebooks
    • Viewers
  • Troubleshooting
    • Catalog validation
    • ToolsUI

Monitoring & Debugging

  • Catalog validation
  • ToolsUI
  • Logs

Reference

  • Catalog Specification
  • TDS Configuration File Reference (threddsConfig.xml)
  • TDS Service Reference
    • NetCDF Subset Service
      • Restrictions on what files can be served
    • WMS Service
      • Styling
      • Additional configuration via wmsConfig.xml file
      • Various WCS and WMS clients (mention)
  • TDS Reference
  • Link to NetCDF Subset Service Reference
  • Link to CDM/netCDF-Java docs
  • Viewers