Version vom 28. Juli 2014, 07:11 Uhr

The following steps describes the installation and configuration of the Terminolgy Server with its components.

Requirements:

• installed and configured Ubuntu LTS
• root or sudo access to the server

Database

Please install the latest MySQL version as usual. Please follow the installation instructions from http://www.mysql.com/

Install the following database scripts:

• db/dump/TermServer_V2-0.sql (required - Terminology Server database)

Tomcat

Please install the latest version of the Apache Tomcat server from http://tomcat.apache.org/

For a stable service you have to adjust the memory size of java used in tomcat. Please find and edit the file catalina.sh. Add the following line or edit if it already exists. Please find appropriate values for Xms, Xmx and MaxPermSize according to your server hardware. These values do the work for us:

JAVA_OPTS="-Dfile.encoding=UTF-8 -server -Xms128M -Xmx1024M -XX:MaxPermSize=1024M -XX:+DisableExplicitGC"

You need to restart tomcat for the changes to take effect.

Configuration files

TermServer

• termserver.hibernate.cfg.xml
• termserver.log4j.cfg.xml
• termserver.properties

TermBrowser

• termbrowser.log4j.cfg.xml
• termbrowser.properties

TermAdmin

• termserver.hibernate.cfg.xml
• termadmin.log4j.cfg.xml
• termadmin.properties

Collaboration software

not yet available

Deployment

Deploy the following content (war files) to your tomcat environment:

• TermServer.war (required)
• TermBrowser.war (optional, require TermServer.war)
• TermAdmin.war (optional, require TermServer.war)

Configuration

Mail configuration

Configure your mail server either in TermAdmin (if installed) or in the database.

TermAdmin
Goto tab "System-Parameter". Edit all values starting with "mail_" according to your mail accout.

• mail_host: hostname of the mailing server
• mail_name: display name of sender
• mail_password: password of your mail account
• mail_port: port of your mail account
• mail_sender: mail address of the sender
• mail_user: user of your mail account

Database
Edit all values starting with "mail_" in the table "sys_param" according to your mail accout.

Status codes

If you change status codes in a domain you have to restart the TermBrowser due to cached values.

First start

Please ensure that all services are started (MySQL, Tomcat, Java).

There are 2 default users configured:

• admin (Password: test#123)
• user (Password: test)