Difference between revisions of "InContext Server Installation"
(→Installation Steps) |
|||
| Line 18: | Line 18: | ||
The <b>IncontextServerConfig.groovy</b> file is the configuration file for the InContext Server and must be configured and placed in the <b>tomcat</b> directory. |
The <b>IncontextServerConfig.groovy</b> file is the configuration file for the InContext Server and must be configured and placed in the <b>tomcat</b> directory. |
||
| − | == Installation Steps == |
||
| + | == Automated 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. |
||
| + | |||
| + | 1. Download the IncontextServer-<version>.zip file from our SFTP site. |
||
| + | |||
| + | 2. Copy the zip file to the /var/lib/jenkins directory (you should be logged in as jenkins) and unzip. |
||
| + | |||
| + | 3. Change directory: cd incontext-server |
||
| + | |||
| + | 4. Modify <b>install.conf</b> to set the values required by the install. Anything left blank will be prompted by the install script. |
||
| + | |||
| + | 5. Run the install script: ./install.sh |
||
| + | |||
| + | |||
| + | |||
| + | == 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: <b>incontext-server.war</b>, <b>incontext-server.sh</b>, and <b>IncontextServerConfig.groovy</b>. |
||
2. Download and install the latest Tomcat 8.5.x from <b>https://tomcat.apache.org/download-80</b> and place it in, for example, /usr/local/tomcat, which will be referred to as <b>tomcat</b>. |
2. Download and install the latest Tomcat 8.5.x from <b>https://tomcat.apache.org/download-80</b> and place it in, for example, /usr/local/tomcat, which will be referred to as <b>tomcat</b>. |
||
| Line 26: | Line 41: | ||
3. Modify <b>tomcat</b>/conf/server.xml and change the port number from 8080 (used by Jenkins) to 8081. |
3. Modify <b>tomcat</b>/conf/server.xml and change the port number from 8080 (used by Jenkins) to 8081. |
||
| − | 4. Create an empty MySQL database |
+ | 4. Create an empty MySQL database, named INCONTEXT: |
| − | shell> mysql -u root –p< |
+ | shell> mysql -u root –p<your_mysql_root_password> |
| − | mysql> CREATE DATABASE <b> |
+ | mysql> CREATE DATABASE <b>INCONTEXT</b>; |
5. Create a database user and password, replacing dbuser and dbpass with your configured values: |
5. Create a database user and password, replacing dbuser and dbpass with your configured values: |
||
| − | shell> mysql -u root –p< |
+ | shell> mysql -u root –p<your_mysql_root_password> |
| − | mysql> GRANT ALL PRIVILEGES ON |
+ | mysql> GRANT ALL PRIVILEGES ON INCONTEXT.* TO '<b>dbuser</b>'@'localhost' IDENTIFIED BY '<b>dbpass</b>'; |
| − | mysql> GRANT ALL PRIVILEGES ON *.* TO '<b>dbuser</b>'@'%' IDENTIFIED BY '<b>dbpass</b>' WITH GRANT OPTION; |
||
| − | 6. Configure |
+ | 6. Configure CATALINA_HOME in the <b>incontext-server.sh</b> file for your environment and place the file in the <b>tomcat</b> directory: |
* export CATALINA_HOME=<b>/usr/local/tomcat</b> |
* export CATALINA_HOME=<b>/usr/local/tomcat</b> |
||
| − | * export JAVA_HOME="<b>/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.191.b12-1.el7_6.x86_64/jre</b>" |
||
| − | * export JRE_HOME="<b>/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.191.b12-1.el7_6.x86_64/jre</b>" |
||
7. Configure the following values in the <b>IncontextServerConfig.groovy</b> file for your environment and place the file in the <b>tomcat</b> directory: |
7. Configure the following values in the <b>IncontextServerConfig.groovy</b> file for your environment and place the file in the <b>tomcat</b> directory: |
||
| − | * String dbname = "<b>incontext</b>" |
||
* String dbuser = "<b>dbuser</b>" |
* String dbuser = "<b>dbuser</b>" |
||
* String dbpass = "<b>dbpass</b>" |
* String dbpass = "<b>dbpass</b>" |
||
Revision as of 22:15, 6 March 2019
Contents
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.
Automated Installation Steps
1. Download the IncontextServer-<version>.zip file from our SFTP site.
2. Copy the zip file to the /var/lib/jenkins directory (you should be logged in as jenkins) and unzip.
3. Change directory: cd incontext-server
4. Modify install.conf to set the values required by the install. Anything left blank will be prompted by the install script.
5. Run the install script: ./install.sh
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
