InContext Server Installation

From Lingoport Wiki
Revision as of 20:59, 4 April 2019 by Rdaly (talk | contribs) (Automated 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 InContext 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.

Automated Installation Steps

1. Download and unzip the IncontextServer-<version>.zip file from our SFTP site.

2. Change directory: cd incontext-server

3. Modify install.conf to set the values required by the install. Any information left blank will be prompted by the install script.

4. Run the install script (note you must have sudo privileges): ./install.sh

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

Manual Installation Steps

1. Download and unzip the IncontextServer-<version>.zip file from our SFTP site. This zip file includes three files you will be dealing with: 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, named INCONTEXT:

shell> mysql -u root –p<your_mysql_root_password> 
mysql> CREATE DATABASE INCONTEXT; 

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

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

6. Configure CATALINA_HOME in the incontext-server.sh file for your environment and place the file in the tomcat directory:

  • export CATALINA_HOME=/usr/local/tomcat

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

  • 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