Upgrading To TDS 4.6

Requirements

• Java 8 is required
• Tomcat version 7.0.50 or greater
• On the command line when starting up Tomcat, you must specify -Dtds.content.root.path=<content root> where <content root> points to the top of the content directory (This is ${tomcat}/content, not ${tomcat}/content/thredds). For example:

  -Dtds.content.root.path=/opt/tomcat-home/content/

  For example, your {tomcat}/bin/setenv.sh might look like:

  #!/bin/sh
  #
  ulimit -n 2048
  #
  CATALINA_HOME="/opt/tomcat-home"
  export CATALINA_HOME
  CATALINA_BASE="/opt/tomcat-home"
  export CATALINA_BASE
  JAVA_HOME="/opt/jdk"
  export JAVA_HOME
  #
  CONTENT_ROOT="-Dtds.content.root.path=/data/thredds/tds-dev/content"
  NORMAL="-d64 -Xmx4090m -Xms512m -server"
  MAX_PERM_GEN="-XX:MaxPermSize=256m"
  HEADLESS="-Djava.awt.headless=true"
  JAVA_PREFS_SYSTEM_ROOT="-Djava.util.prefs.systemRoot=$CATALINA_BASE/content/thredds/javaUtilPrefs -Djava.util.prefs.userRoot=$CATALINA_BASE/content/thredds/javaUtilPrefs"
  #             
  JAVA_OPTS="$CONTENT_ROOT $NORMAL $MAX_PERM_GEN $HEADLESS $JAVA_PREFS_SYSTEM_ROOT"
  export JAVA_OPTS
  

Troubleshooting:

Don't leave a space after the =

 CONTENT_ROOT="-Dtds.content.root.path=/data/thredds/tds-dev/content"

not

 CONTENT_ROOT= "-Dtds.content.root.path=/data/thredds/tds-dev/content"

If the content root is not correctly set, you will see a message like: "SEVERE: Error listenerStart" in {tomcat}/logs/catalina.out and "Error creating bean with name 'tdsContext'", and "Content directory not a directory" in {$tomcat}/logs/localhost.log.

We recommend that you use an absolute path, like /opt/tomcat/content, instead of a relative path like "../content".

Note that your catalogs are under ${tomcat}/content/thredds but tds.content.root.path does not include the thredds subdirectory.

 

GRIB Feature Collection Changes

1. GRIB Collections now scale to large numbers of files.
2. New indexes (.ncx3) will be written the first time GRIB files are accessed. You may delete the older indices (ncx, ncx2) if you like. The gbx9 indices can stay as they are somewhat expensive to build (requiring a sequential read of the GRIBfiles). Deleting them will allow a few minor improvements to be made when recreating.
3. GRIB Best Collections now show the runtime as an auxiliary coordinate, and runtimes are monotonic increasing.
4. Some GRIB specific FAQs
5. For complete information, see GRIB Collections and TDM.

Bug Fixes in version 4.6

• IOSP
  • Dates from WRF not CF / ISO compliant
• GRIB Collections
  • restrict datasets was not working
  • improve detection of variant coded GDS - less need for gdshash corrections
  • add earth radius to lat/lon projection
• FMRC
  • floating point compares sometimes made spurious time coordinates
  • offsetsGreaterEqual did not work correctly
  • collection updating was not working (in 4.5)
• CDM
  • GeoGrid.makeSubset() not correctly subsetting regular axes.

See JIRA issues log

API changes

Client Catalog API

The catalog processing classes in thredds.catalog2 package have been replaced by thredds.client.catalog everywhere in client code. If you are using thredds.catalog2 in your code, please switch to thredds.client.catalog, as it is takes less memory and is better performant. The old classes are deprecated but still available, but in future versions they will be moved to legacy.jar, which you will need to seperately include in your classpath if needed.

Internal changes

• We are now using Gradle to do our builds. Maven will continue to be supported for now (version 4.6.0).
• Using Coverity to find and fix more than 4000 defects. Defect count now < 1 / 1000 LOC.

Upgrading from 4.3

If you are upgrading from 4.3, you may find the 4.3 to 4.5 upgrade document helpful.

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