HEC-RTS versions come prepackaged with the latest model builds at the time of release. Sometimes, the user might want to upgrade their HEC-HMS version before the next build of HEC-RTS is released. HEC-HMS can be downloaded here.

This tutorial is arranged by the HEC-RTS version you are using and which HEC-HMS version you want to upgrade to.


If the HEC-HMS model, both the HEC-HMS build currently in HEC-RTS and the build you are upgrading to, fall within in the same range listed below. The modification to the CAVI.config is not needed.  You only need to do steps 1 through 3.

HEC-RTS is only tested with HEC-HMS builds between released HEC-RTS builds. Example: HEC-RTS 3.1.1 was only tested by HEC with HEC-HMS versions 4.5 through 4.6.1.  Anything after HEC-HMS 4.6.1 was not tested by HEC within HEC-RTS 3.1.1.

It is always recommended to use the latest version of the software (whether it is HEC-RTS or HEC-HMS in this case). We included older versions for completion purposes but do not encourage the use of outdated software.

HEC-RTS 3.2.3

Originally packaged with HEC-HMS 4.8

HEC-HMS 4.9 - 4.11 

  1. Remove the previous HEC-HMS build from the /HEC-HMS/ directory.
  2. Copy the contents of the new HEC-HMS build.
  3. Paste the contents of the HEC-HMS build in to the /HEC-HMS/ directory.

HEC-RTS 3.2.1

Originally packaged with HEC-HMS 4.6.1

HEC-HMS 4.8 - 4.11 Beta

  1. Remove the previous HEC-HMS build from the /HEC-HMS/ directory.
  2. Copy the contents of the new HEC-HMS build.
  3. Paste the contents of the HEC-HMS build in to the /HEC-HMS/ directory.
  4. Open the /HEC-RTS/HEC-RTS.config file.
  5. Scroll to the bottom of the .config file.
  6. Replace the “addjar ../HEC-HMS/lib/hms-command-1.0.jar” statement with “addjar ../HEC-HMS/lib/hms-command-1.1.jar”

HEC-HMS 4.7.1

  1. Remove the previous HEC-HMS build from the /HEC-HMS/ directory.
  2. Copy the contents of the new HEC-HMS build.
  3. Paste the contents of the HEC-HMS build in to the /HEC-HMS/ directory.

HEC-HMS 4.7 was intentionally left out of these upgrade notes. It is encouraged to use HEC-HMS 4.7.1 over 4.7 as version 4.7.1 is a bug fix version of HEC-HMS 4.7

HEC-RTS 3.1.1

Originally packaged with HEC-HMS 4.5

HEC-HMS 4.8 - 4.11 Beta

  1. Remove the previous HEC-HMS build from the /HEC-HMS/ directory.
  2. Copy the contents of the new HEC-HMS build.
  3. Paste the contents of the HEC-HMS build in to the /HEC-HMS/ directory.
  4. Open the /HEC-RTS/HEC-RTS.config file.
  5. Scroll to the bottom of the .config file.
  6. Replace the “addjar ../HEC-HMS/lib/hms-command-1.0.jar” statement with “addjar ../HEC-HMS/lib/hms-command-1.1.jar”

HEC-HMS 4.6.1-4.7.1

  1. Remove the previous HEC-HMS build from the /HEC-HMS/ directory.
  2. Copy the contents of the new HEC-HMS build.
  3. Paste the contents of the HEC-HMS build in to the /HEC-HMS/ directory.

HEC-HMS 4.6 was intentionally left out of these upgrade notes. It is encouraged to use HEC-HMS 4.6.1 over 4.6 as version 4.6.1 is a bug fix version of HEC-HMS 4.6

HEC-RTS 3.0.3

Originally packaged with HEC-HMS 4.2.1

HEC-HMS 4.8 - 4.11 Beta

  1. Remove the previous HEC-HMS build from the /HEC-HMS/ directory.
  2. Copy the contents of the new HEC-0HMS build.
  3. Paste the contents of the HEC-HMS build in to the /HEC-HMS/ directory.
  4. Open the /HEC-RTS/HEC-RTS.config file.
  5. Scroll to the bottom of the .config file.
  6. If upgrading from HMS 4.2.1: Replace the “addjar ../HEC-HMS/hms.jar” statement with “addjar ../HEC-HMS/lib/hms-command-1.1.jar”
  7. If upgrading from HMS 4.3 through 4.7.1: Replace the “addjar ../HEC-HMS/lib/hms-command-1.0.jar” statement with “addjar ../HEC-HMS/lib/hms-command-1.1.jar”

HEC-HMS 4.5-4.7.1

  1. Remove the previous HEC-HMS build from the /HEC-HMS/ directory.
  2. Copy the contents of the new HEC-HMS build.
  3. Paste the contents of the HEC-HMS build in to the /HEC-HMS/ directory.
  4. Copy hms-command-1.0.jar from <HMS root>/lib directory into <HEC-RTS root>/HEC-RTS/jar directory.
  5. Open the /HEC-RTS/HEC-RTS.config file.
  6. Scroll to the bottom of the .config file.
  7. Replace the “addjar ../HEC-HMS/hms.jar” statement with “addjar ../HEC-HMS/lib/hms-command-1.0.jar”

HEC-HMS 4.3-4.4

  1. Remove the previous HEC-HMS build from the "../HEC-HMS/" directory.
  2. Copy the contents of the new HEC-HMS build.
  3. Paste the contents of the HEC-HMS build in to the "../HEC-HMS/"directory.
  4. Open the "hmsServer.template" file.
  5. Scroll to the bottom of the .template file.
  6. Add "setenv $SETENV" at the bottom.