Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This page describes how to upgrade an existing installation of TermWeb.Stopping

With TermWeb Home directory

Stop If TermWeb by shutting down Tomcat.

Backing up

gggHome directory is specified by the TERMWEB_HOME environment variable and termweb.properties and log4j.properties (and optionally custom/ directory, if your installation has custom layout or design) is stored in the directory defined by the variable, do one of the following to update:

  • Upgrade in Tomcat Manager
    If you have Tomcat Manager installed you can stop and undeploy TermWeb there. Then select the new termweb.war file for upload and deploy.

  • Copy file manually
    Copy the new termweb.war to <tomcat-install>/webapps (overwriting the old termweb.war)

It is recommended to restart Tomcat after the upgrade in both cases, since Tomcat keeps old classes in memory on application reload and will eventually run out of memory if not fully restarted.

Without TermWeb Home directory

If you are not using TERMWEB_HOME and/or you are upgrading to a TermWeb version lower than 3.15, do the following:

  1. Make a backup of your <termweb> directory, typically <tomcat-install>/webapps/termweb.properties in <termweb>/WEB-INF
  2. Deploy the new termweb.war in Tomcat
  3. Copy the logging configuration from your old termweb.properties to <termweb>
  4. Perform the update as with the home directory like above.
  5. Copy your old <termweb-install>/WEB-INF/termweb.properties and <termweb-install>/WEB-INF/log4j.properties
  6. Copy your old termweb.properties (with logging configuration removed) to <termweb>/WEB-INF/termweb.properties
  7. Restart TermWeb to the <termweb> directory.
  8. If you have customized layout, copy your custom/ directory to <termweb-install>
  9. Restart Tomcat to apply the .properties files.

Version specific upgrades

Please check Version specific upgrade notes for more information for your specific TermWeb version.

(tick) Congratulations! Your TermWeb installation is now upgraded!