Troubleshooting

Check log files for errors

1. ${tomcat.home}/logs/catalina.out: This is where Tomcat prints messages about Tomcat startup and uncaught exceptions from any webapp.
2. ${tomcat.home}/logs/localhost.{date}.log: This is where log messages for Tomcat are sent.
3. ${tomcat.home}/content/thredds/logs/serverStartup.log: As TDS starts up, it logs messages here. Errors and warnings in your catalog configuration files are shown here.
4. ${tomcat.home}/content/thredds/logs/threddsServlet.log: Each request that the TDS responds to gets logged here. Errors and warnings that are associated with a request are logged here.
5. ${tomcat.home}/content/thredds/logs/models.log: Errors and warning specific to gridded data may be shown here (optional).

Common errors in the TDS Configuration Catalogs:

Duplicate path(s)

If you accidentally use the same path in more than one data root, you will get an error in catalog.

  <datasetRoot path="testdup" location="C:/data/" />
  <datasetScan name="duplicate path" path="testdup" location="/home/workshop/data/" serviceName="dodsServer" />


  In ${tomcat.home}/content/thredds/logs/serverStartup.log:
  **Error: already have dataRoot =<testdup>  mapped to directory= <C:/data/> wanted to map to=</home/workshop/data/> in catalog

Data directory doesnt exist

   <datasetRoot path="sage" location="C:/data/notexist/" />

  In ${tomcat.home}/content/thredds/logs/serverStartup.log:
  **Error: Data Root =sage directory= <C:/data/notexist/> does not exist

DatasetScan has missing or invalid service

  <datasetScan name="bad service name" path="segundo" location="C:/data/" serviceName="badd" />
  <datasetScan name="no service name" path="tertiary" location="C:/data/" />

  In ${tomcat.home}/content/thredds/logs/serverStartup.log:
  **Error: DatasetScan (Top Dataset/bad service name ): must have a default service
  **Error: DatasetScan (Top Dataset/no service name): must have a default service

Data not compatible with service

  <dataset name="inappropriate service" urlPath="images/labyrinth.jpg" serviceName="dodsServer" dataType="Grid" />

• You wont get an error in serverStartup.log
• But when you try to access it:
  • Browser: DODServlet ERROR: Cant read C:/data/images/labyrinth.jpg: not a valid NetCDF file.
  • nj22/IDV:: Lexical error at line 1, column 1. Encountered: "" (0), after : ""

Data file does not exist

  <dataset name="no data (opendap)" ID="Y" urlPath="images/labyrinth.nc" serviceName="dodsServer" dataType="Grid" />

• You wont get an error in serverStartup.log
• If you try to access it (OPeNDAP)
  • Browser: message = "Cant find images/labyrinth.nc"
  • nj22/IDV:: "Cant find images/labyrinth.nc"
• If you try to access it (HTTP server)
  • Browser: Error 404 The requested resource () is not available.
  • nj22/IDV: Error 404 Not Found

DatasetScan points to an empty directory

Aggregation scan points to an empty directory

Duplicate ids

This document is maintained by John Caron and was last updated on May 27, 2009