InContext Server Installation

From Lingoport Wiki
Revision as of 21:03, 1 March 2019 by MaryH (talk | contribs) (Installation Steps)
Jump to: navigation, search

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 incontext-server.war is the server itself and must be placed under the tomcat/webapps directory.
The incontext-server.sh file is a script for starting/stopping the Server and must be configured and placed in the tomcat directory.
The IncontextServerConfig.groovy file is the configuration file for the InContext Server and must be configured and placed in the tomcat directory.

Installation Steps

1. Download and unzip the incontext-server-<version>.zip file from our SFTP site. The zip file contains three files: incontext-server.war, incontext-server.sh, and IncontextServerConfig.groovy.

2. 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 will be referred to as tomcat.

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

4. 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; 

5. 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;

6. 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"

7. 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"

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

9. Launch the server:

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

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

Note: To stop the Server:

> cd tomcat
> ./incontext-server.sh stop -force