Installation of Terminology Server
K (→Mail configuration) |
(→First start) |
||
Zeile 74: | Zeile 74: | ||
*admin (Password: test#123) | *admin (Password: test#123) | ||
*user (Password: test) | *user (Password: test) | ||
+ | |||
+ | Please change passwords in a real environment. |
Version vom 6. Oktober 2014, 10:47 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
Inhaltsverzeichnis |
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)
Note: This script creates a database named web5db2 automatically. The script needs to create trigger, please ensure that the user has the appropriate rights.
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
Create configuration files for modules you want to install. All files have to been located in your tomcat/conf/ folder. See the following links for more information.
Sample files are available in the path /conf/termserver from the source code repository.
TermServer
TermBrowser
TermAdmin
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 directly 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)
Please change passwords in a real environment.