Before Upgrading

Prior to upgrading to a new version of the TDS, please do the following:

Read The Release Notes For The New Version

There have been some significant changes between TDS version 4x and 5.0. Please have a look at the release notes correspomnding to the new TDS version to understand if the nature of the changes will influence the TDS operation.

Un-Deploy The Old TDS Version

Before upgrading to a newer version of the THREDDS Data Server, it is important to fully un-deploy the old TDS from the servlet container.

  1. Tomcat and other servlet containers have working directories into which any files needed during run time, such as the generated servlet code and class files for JSPs are written:

    ${tomcat.home}/work/Catalina/localhost/thredds

Un-deploying the older TDS version will flush the contents of this working directory, ensuring there is no conflict between the old and new replacement files created by the new TDS deployment.

  1. To undeploy the TDS, remove the TDS WAR file and the matching exploded (i.e., uncompressed) directory of the same name from ${tomcat_home}/webapps.
    You can perform this task manually or by using the Tomcat Manager application.

Perform Server Maintenance Tasks

This is a good time to perform maintenance of your server environment. Such tasks may include, but are not limited to:

  1. Upgrading any outdated packages, such as thr JDK and Tomcat as per the system requirements.
  2. Archiving old log files to a secure and stable disk space.

This is the process we at Unidata follow when we upgrade the TDS on our systems. (We use the Tomcat, but the upgrade process should be similar for other servlet containers).

  1. Download the most recent versions of the TDS and the THREDDS Data Manager (TDM) (if you use the later).
  2. Install the TDS and/or the TDM as outlined in the Installation process.
  3. Stop and restart the TDM process if you upgraded either the JDK or the TDM.

Upgrading From TDS Version 4.x To 5

In addition to the step outlined in the recommended upgrade process, you will need to perform the following necessary changes:

  1. Modify your JVM settings to be compatible with TDS 5, particularly the setting for specifying the location of the content directory.

  2. Review and update your catalogs to reflect the changes made to: