InContext Server Installation

InContext Server Installation Requirements

The InContext Server requires the following:

• Tomcat 8.5.x
• Java 8
• MySQL 5.5.3+

Since the Lingoport Suite already requires Java and MySQL, the only additional requirement for the InContext Server is Tomcat.

InContext Server Files

There are three files that comprise the InContext Server:

• incontext-server.war
• incontext-server.sh
• IncontextServerConfig.groovy

The war file must be placed under the tomcat/webapps directory.
The incontext-server.sh file must be configured and placed in the tomcat directory.
The IncontextServerConfig.groovy file must be configured and placed in the tomcat directory.

Installation Steps

1. Download and install the latest Tomcat 8.5.x from https://tomcat.apache.org/download-80 and place it in, for example, /usr/local/tomcat, which I will refer to as tomcat.

2. Modify tomcat/conf/server.xml and change the port number from 8080 (used by Jenkins) to 8081

3. Create an empty MySQL database. You may use incontext or any database name you would like:

shell> mysql -u root –p<your_password> 
mysql> CREATE DATABASE incontext DEFAULT CHARACTER SET utf8mb4 DEFAULT COLLATE utf8mb4_unicode_ci; 

4. Create a database user and password, replacing dbuser and dbpass with your configured values:

shell> mysql -u root –p<your_password> 
mysql> GRANT ALL PRIVILEGES ON *.* TO 'dbuser'@'localhost' IDENTIFIED BY 'dbpass' WITH GRANT OPTION; 
mysql> GRANT ALL PRIVILEGES ON *.* TO 'dbuser'@'%' IDENTIFIED BY 'dbpass' WITH GRANT OPTION;

5. Configure the following values in the incontext-server.sh file for your environment and place the file in the tomcat directory:

• export CATALINA_HOME=/usr/local/tomcat
• export JAVA_HOME="/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.191.b12-1.el7_6.x86_64/jre"
• export JRE_HOME="/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.191.b12-1.el7_6.x86_64/jre"

6. Configure the following values in the IncontextServerConfig.groovy file for your environment and place the file in the tomcat directory:

• String dbname = "incontext"
• String dbuser = "dbuser"
• String dbpass = "dbpass"

7. Copy the incontext-server.war file to the tomcat/webapps directory

8. Launch the server:

> cd tomcat
> ./incontext-server.sh start

The InContext Server should be launched and you can browse to: http://yourserverurl:8081/incontext-server