Difference between revisions of "Localyzer Installation"

From Lingoport Wiki
Jump to: navigation, search
(Added the 1.0 to 1.1 drop table change. O.)
Line 1: Line 1:
 
== Resource Manager Installation ==
 
== Resource Manager Installation ==
   
The Lingoport Resource Manager is composed of three items:
+
The Lingoport Resource Manager System is composed of three items:
<UL><LI>the Resource Manager Server: many users can interact with the Resource Manager for the same projects. The Server keeps track of all the actions and the expected results. The server is best located on one central system accessible by all clients.
+
<UL><LI>the Lingoport Resource Manager: The Server keeps track of all the actions and the expected results. The server is best located on one central system accessible by all clients. This section describes the installation of LRM.
 
</LI>
 
</LI>
<LI>the Resource Manager Client: each user who interacts with the Resource Manager needs a client to execute the commands, such as verifying files to be sent for translation. The client is a light Java application and needs to communicate with the server.</LI>
+
<LI>Jenkins: Jenkins orchestrates the execution of the commands, such as verifying files to be sent for translation via a light Java application. Jenkins needs to communicate with the Lingoport Resource Manager server and is best co-located with LRM. The Jenkins setup is the subject of another guide.</LI>
 
<LI> the Dashboard: the Lingoport Dashboard aggregates and displays data from both the Resource Manager and Globalyzer. Its installation is the subject of another guide.</LI>
 
<LI> the Dashboard: the Lingoport Dashboard aggregates and displays data from both the Resource Manager and Globalyzer. Its installation is the subject of another guide.</LI>
 
</UL>
 
</UL>
   
The Resource Manager server must be installed before starting each individual Resource Manager installation.
 
   
  +
====Pre-requisites ===
 
=== Server Installation ===
 
Before installing the server, the following pre-requisites are necessary:
 
 
==== Pre-requisites ====
 
 
<OL>
 
<OL>
<LI>Supported OS: Windows, Linux, MacOS</LI>
+
<LI>Supported OS: Linux</LI>
  +
<LI>Installed Java 7 or greater JRE on the target machine. You can check your Java version using the command line. At the command prompt enter:
  +
<code>java -version</code>
  +
The version of Java which you have on your system should be displayed. If you need to install Java, please refer to http://www.java.com/en/download/index.jsp or any Java download page which supplies Java 7 or above.</LI>
 
<LI>Installer jar file: you must have the Lingoport_Resource_Manager_Server-<x.x>-Installer.jar file.</LI>
 
<LI>Installer jar file: you must have the Lingoport_Resource_Manager_Server-<x.x>-Installer.jar file.</LI>
 
<LI>License: Lingoport must have sent you an email with the licensing information. You must have that information ready before installing the server. If you do not have the licensing information of the jar file, please contact support@lingoport.com. </LI>
 
<LI>License: Lingoport must have sent you an email with the licensing information. You must have that information ready before installing the server. If you do not have the licensing information of the jar file, please contact support@lingoport.com. </LI>

Revision as of 18:57, 2 April 2015

Resource Manager Installation

The Lingoport Resource Manager System is composed of three items:

  • the Lingoport Resource Manager: The Server keeps track of all the actions and the expected results. The server is best located on one central system accessible by all clients. This section describes the installation of LRM.
  • Jenkins: Jenkins orchestrates the execution of the commands, such as verifying files to be sent for translation via a light Java application. Jenkins needs to communicate with the Lingoport Resource Manager server and is best co-located with LRM. The Jenkins setup is the subject of another guide.
  • the Dashboard: the Lingoport Dashboard aggregates and displays data from both the Resource Manager and Globalyzer. Its installation is the subject of another guide.


=Pre-requisites

  1. Supported OS: Linux
  2. Installed Java 7 or greater JRE on the target machine. You can check your Java version using the command line. At the command prompt enter: java -version The version of Java which you have on your system should be displayed. If you need to install Java, please refer to http://www.java.com/en/download/index.jsp or any Java download page which supplies Java 7 or above.
  3. Installer jar file: you must have the Lingoport_Resource_Manager_Server-<x.x>-Installer.jar file.
  4. License: Lingoport must have sent you an email with the licensing information. You must have that information ready before installing the server. If you do not have the licensing information of the jar file, please contact support@lingoport.com.
  5. JVM: you must have a Java 6 or above JVM. To verify you do, simply type “java –version” at the command line and check the version. If you need to install Java, refer to the Java download page, for instance http://www.java.com/en/download/index.jsp
  6. MySQL: you must have a MySQL 5.1 or above database instance running and access to it. To verify this installation, type “mysql –u <username> -p<password> “at the command prompt. If you don’t have mysql installed or if mysql is not on your path, you may need to refer to MySql download and installation, for instance http://dev.mysql.com/downloads/.
  7. MySQL Time Zone: MySQL time zone must be non-ambiguous. An example of an ambiguous time zone is 'MST' whereas 'America/Denver' is a non-ambiguous time zone. Refer to MySQL documentation for your specific OS to set time zones appropriately.
    • For Window, you should be able to type SET GLOBAL time_zone = 'America/Denver’ at the MySQL prompt.
    • For Linux, you could for instance type mysql_tzinfo_to_sql /usr/share/zoneinfo/|mysql -u root mysql -p from the command line and then SET GLOBAL time_zone = 'America/Denver’ at the MySQL prompt.
    • For MacOS, you may for instance type mysql_tzinfo_to_sql /usr/share/zoneinfo/|mysql -D mysql -u root mysql -p from the command line and then SET GLOBAL time_zone = 'America/Denver’ at the MySQL prompt.

Setting up the Server

Run the installer by either:

  • double clicking on the Lingoport_Resource_Manager_Server-<x.x>-Installer.jar
  • running “java –jar Lingoport_Resource_Manager_Server-<x.x>-Installer.jar“ at the command prompt.

The Lingoport Resource Manager will then prompt you for license information and database settings to create the database tables in MySQL. Please note that the connection settings and the company ID in the server installation will be used in the subsequent client installations.

Moving Server DB from 1.0 to 1.x

The fileDirectory column was not used in 1.0 and was dropped from the schema starting with 1.1. For clients that are existing LRM 1.0 user, run the following command:

  • ALTER TABLE translated_kit DROP Column fileDirectory


Client Installations

Before starting an individual client installation, the following pre-requisites are necessary:

Pre-requisites

  1. Supported OS: Windows, Linux, MacOS
  2. Installer jar file: you must have the Lingoport_Resource_Manager_Client-<x.x>-Installer.jar file.
  3. Server installed: the Resource Manager Server must have been installed.
  4. JVM: you must have a Java 6 or above JVM. To verify you do, simply type “java –version” at the command line and check the version. If you need to install Java, refer to the Java download page, for instance http://www.java.com/en/download/index.jsp .
  5. MySQL: you must have access to the Lingoport Resource Manager MySQL 5.1 instance where the server installation was run.

Setting up a Client

Run the installer by either:

  • double clicking on the Lingoport_Resource_Manager_Client-<x.x>-Installer.jar
  • running java –jar Lingoport_Resource_Manager_Client-<x.x>-Installer.jar at the command prompt.

The Lingoport Resource Manager will then prompt you for which database to use for the client.

Proceed to the Getting Started portion of this FAQ.