Versions Compared

Key

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

...

TermWeb requires Java Developers Kit (JDK) or Java Runtime Environment (JRE) platform to be installed on your server's operating system. Currently Java 1.6, 1.7 and 1.7 8 is supported by TermWeb. Java 1.8 is not supported.

Oracle's JDK/JRE can be downloaded from Oracle's website.

...

TermWeb is a web application that requires an application server. Apache Tomcat is the recommended application server and can be downloaded here. Recommended version is 7.0 or later, but TermWeb also supports Tomcat 6.0.

...

titlePlease note

...

.

...

The installation directory for Tomcat depends on the Linux distribution, one common location is /usr/share/tomcat.  Tomcat's installation directory is referred to as <tomcat-install> in this documentation.

...

TermWeb need more heap space than the 64MB that is allocated to the Java virtual machine by default. The recommended value is 512MB or higher, but it should not exceed the amount of physical RAM available.To increase heap space memory in Linux installations:

The exact procedure for configuration is depending on Linux distribution. For a

CentOS /

...

RedHat 

  1. Edit /etc/tomcat/tomcat.conf .
  2. Add or modify the line containing JAVA_OPTS and set the value for -Xms and -Xmx.

    Code Block
    languagebash
    JAVA_OPTS="-Xms=128m -Xmx512m"

Generic Tomcat installation

  1. In <tomcat-install>/bin, open the setenv.sh file, or create a new file if it doesn't exist.
  2. Add the line

    Code Block
    languagebash
    setexport JAVA_OPTS="$JAVA_OPTS -Xms128m -Xmx512m"

Restart Tomcat after the file is edited and saved. You can confirm that Tomcat has picked up the correct settings by running

Code Block
languagebash
ps aux | grep java

and see that the

...

settings for -Xms and -Xmx

...

are as desired.

Database connection

When Tomcat is installed, please refer to Connecting to Connecting TermWeb to a Database for setting up and configuring the database.

...

Copy the termweb.war file to <tomcat><tomcat-install>/webapp . The war file is extracted automatically into <tomcat><tomcat-install>/webapps/termweb if Tomcat is running.

In the file <tomcat><tomcat-install>/webapps/termweb/WEB-INF/termweb.properties.sample you will find settings that may have to be adjusted according to your environment. Pay extra attention to the Rename this file to termweb.properties and edit the values for termweb.home, base.url and work.dir values.

Info
titlePlease note

All Prior to TermWeb v3.15, all changes to termweb.properties requires a restart of TermWeb webapp or Tomcat to take effect.

...

See http://logging.apache.org/log4j for more information about logging configuration options.

Set Environment Variable

Set the TERMWEB_HOME environment variable according to the instructions in Setting TermWeb Home Directory and copy termweb.properties and log4j.properties to the directory specified by the variable.

Installation complete

Start up Tomcat and check the log files for any errors.

...