Difference between revisions of "Localyzer Installation"

From Lingoport Wiki
Jump to: navigation, search
(Pre-requisites)
(Pre-requisites)
Line 11: Line 11:
 
===Pre-requisites ===
 
===Pre-requisites ===
 
<OL>
 
<OL>
<LI>Supported OS: Linux</LI>
+
<LI>Supported OS: <b>Linux</b></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:
+
<LI>Installed <b>Java 7 or greater</b> JRE on the target machine. You can check your Java version using the command line. At the command prompt enter:
 
<code>java -version</code>
 
<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>
 
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>Installed MySQL 5.1 or higher on a database server. If the database server is not the same machine as the target machine, then you will need to install the MySQL 5.x Client (only need Client) on the target machine so that it can access the database on the separate database server.
+
<LI>Installed <b>MySQL 5.1 or higher</b> on a database server. If the database server is not the same machine as the target machine, then you will need to install the MySQL 5.x Client (only need Client) on the target machine so that it can access the database on the separate database server.
 
 
 
* You can verify that you have a sufficiently up-to-date version of MySQL using the command prompt. In the command prompt type:
 
* You can verify that you have a sufficiently up-to-date version of MySQL using the command prompt. In the command prompt type:
Line 28: Line 28:
 
<LI>Received the <b>Licensing information</b> from Lingoport. When your company purchased LRM you should have been sent an email containing the licensing information. This licensing information will be required for the server installation. If you do not have the licensing information of the jar file, please contact <code>support@lingoport.com</code>. Please keep it handy while you perform the install.</LI>
 
<LI>Received the <b>Licensing information</b> from Lingoport. When your company purchased LRM you should have been sent an email containing the licensing information. This licensing information will be required for the server installation. If you do not have the licensing information of the jar file, please contact <code>support@lingoport.com</code>. Please keep it handy while you perform the install.</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 <b>Lingoport_Resource_Manager_Server-<x.x>-Installer.jar</b> file.</LI>
   
   

Revision as of 19:04, 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. Installed MySQL 5.1 or higher on a database server. If the database server is not the same machine as the target machine, then you will need to install the MySQL 5.x Client (only need Client) on the target machine so that it can access the database on the separate database server.
    • You can verify that you have a sufficiently up-to-date version of MySQL using the command prompt. In the command prompt type:
    mysql -u <user> -p<password>
    • If MySQL is installed on your system, information on the version will be displayed after entering a valid username and password. If MySQL is not version 5.1 or higher, please refer to a download site, such as http://dev.mysql.com/downloads and install an up-to-date version.
    • You will need to enter the MySQL credentials (host, username, password and port number) during the installation.
  4. Received the Licensing information from Lingoport. When your company purchased LRM you should have been sent an email containing the licensing information. This licensing information will be required for the server installation. If you do not have the licensing information of the jar file, please contact support@lingoport.com. Please keep it handy while you perform the install.
  5. Installer jar file: you must have the Lingoport_Resource_Manager_Server-<x.x>-Installer.jar file.

  6. 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.