Difference between revisions of "InContext Server Installation"
(→Automated Installation Steps (Recommended Installation)) |
|||
| Line 35: | Line 35: | ||
[[File:InContextServerLogin.jpg |600px]] |
[[File:InContextServerLogin.jpg |600px]] |
||
| − | |||
| − | == 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>. |
||
| − | |||
| − | 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, named INCONTEXT: |
||
| − | shell> mysql -u root –p<your_mysql_root_password> |
||
| − | mysql> CREATE DATABASE <b>INCONTEXT</b>; |
||
| − | |||
| − | 5. Create a database user and password, replacing dbuser and dbpass with your configured values. Make sure that the password meets the requirement for your MySQL release. |
||
| − | shell> mysql -u root –p<your_mysql_root_password> |
||
| − | mysql> GRANT ALL PRIVILEGES ON INCONTEXT.* TO '<b>dbuser</b>'@'localhost' IDENTIFIED BY '<b>dbpass</b>'; |
||
| − | |||
| − | 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> |
||
| − | |||
| − | 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 dbuser = "<b>dbuser</b>" |
||
| − | * String dbpass = "<b>dbpass</b>" |
||
| − | |||
| − | 8. Copy the <b>incontext-server.war</b> file to the <b>tomcat</b>/webapps directory |
||
| − | |||
| − | 9. Launch the server: |
||
| − | > cd <b>tomcat</b> |
||
| − | > ./incontext-server.sh start |
||
| − | |||
| − | The InContext Server should be launched; browse to: http://yourserverurl:8081/incontext-server |
||
| − | |||
| − | Note: To stop the Server: |
||
| − | > cd <b>tomcat</b> |
||
| − | > ./incontext-server.sh stop -force |
||
== Next Steps == |
== Next Steps == |
||
Revision as of 20:22, 19 April 2019
Contents
InContext Server Installation Requirements
The InContext Server requires the following:
- 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. The InContext Server provided by Lingoport installs Tomcat 8.5.x.
InContext Server Files
There are three files that comprise the InContext Server. The Lingoport InContext Server automated installation process will put these files in the appropriate location.
- 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.
MYSQL_ROOT_PASS- this is the password that was used or created by the Stack Installer or Stack Updater.INCONTEXT_MYSQL_USER / INCONTEXT_MYSQL_PASS- this is a new MySQL username and password.INSTALL_TOMCAT_HERE='/usr/local/tomcat'- Unless there is reason to change the location, leave it at the default.
4. Run the install script (note you must have sudo privileges): ./install.sh. If it is successful, one should see:
Tomcat started. Incontext Server successfully installed and deployed.
The InContext Server should be launched; browse to: http://yourserverurl:8081/incontext-server
Next Steps
For information on how to proceed after installation, please see the: InContext Server Users Guide
