Difference between revisions of "InContext Server Installation"

From Lingoport Wiki
Jump to: navigation, search
(Installation Steps)
(Installation Steps)
Line 14: Line 14:
 
2. Modify <b>tomcat</b>/conf/server.xml and change the port number from 8080 (used by Jenkins) to 8081
 
2. Modify <b>tomcat</b>/conf/server.xml and change the port number from 8080 (used by Jenkins) to 8081
   
3. Create an empty MySQL database, named <b>incontext</b>:
+
3. Create an empty MySQL database. You may use <b>incontext</b> or any database name you would like:
 
shell> mysql -u root –p<your_password>
 
shell> mysql -u root –p<your_password>
 
mysql> CREATE DATABASE incontext DEFAULT CHARACTER SET utf8mb4 DEFAULT COLLATE utf8mb4_unicode_ci;
 
mysql> CREATE DATABASE incontext DEFAULT CHARACTER SET utf8mb4 DEFAULT COLLATE utf8mb4_unicode_ci;
Line 22: Line 22:
 
mysql> GRANT ALL PRIVILEGES ON *.* TO 'dbuser'@'localhost' IDENTIFIED BY 'dbpass' WITH GRANT OPTION;
 
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;
 
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 <b>tomcat</b> 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 <b>tomcat</b> directory:
  +
* String dbname = "incontext"
  +
* String dbuser = "dbuser"
  +
* String dbpass = "dbpass"
   
 
== InContext Server Files ==
 
== InContext Server Files ==

Revision as of 20:10, 1 March 2019

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.

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"

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.