Difference between revisions of "Localyzer Installation"

From Lingoport Wiki
Jump to: navigation, search
(Next Steps)
 
(61 intermediate revisions by 3 users not shown)
Line 1: Line 1:
  +
== Stack Installer/Updater ==
== Lingoport Resource Manager Overview ==
 
  +
The recommended way to install Localyzer is via the [[Installation and Configuration|Stack Installer]] or the Stack Updater.
The Lingoport Resource Manager System is composed of three items (See the diagram at [[Components Diagram]]):
 
  +
This page is kept in case a Localyzer patch for an existing version of the Lingoport Suite is needed.
# '''Lingoport Resource Manager''': The Server keeps track of all the actions and the expected results. The server is best located on one central system. 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.
 
# '''Dashboard''': the Lingoport Dashboard aggregates and displays data from both the Resource Manager and Globalyzer. Its installation is the subject of another guide.
 
   
  +
== Localyzer Overview ==
The Dashboard typically needs to have access to the <code>lrm-cli.jar</code> files in order to generate the xml report files and use those xml to push the files over to the Dashboard.
 
  +
Localyzer or as formerly known, the Lingoport Resource Manager System, is composed of several items that work together. (See the diagram at [[Components Diagram]]):
  +
# '''Localyzer''': The [[Terms_and_Definitions#LRMServer|Localyzer]] keeps track of all the actions and the expected results. The server is best located on one central system. This section describes the installation of Localyzer. The '''[[Terms_and_Definitions#LRMDatabase|Localyzer Database]]''' is created during the Localyzer installation.
  +
# '''Jenkins''': [[Terms_and_Definitions#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 Localyzer. The Jenkins setup is the subject of another guide.
  +
# '''Dashboard''': the [[Terms_and_Definitions#LingoportDashboard|Lingoport Dashboard]] aggregates and displays data from both the Resource Manager and [[Terms_and_Definitions|Globalyzer]]. Its installation is the subject of another guide.
   
  +
The [[Terms_and_Definitions#LingoportDashboardClient|Dashboard Client]] typically needs to have access to the <code>lrm-cli.jar</code> files in order to generate the XML report files and subsequently push the files over to the [[Terms_and_Definitions#LingoportDashboardServer|Dashboard Server]].
== Install Jenkins==
 
If you have not done so yet, install Jenkins. Jenkins must be <b>version 1.609</b> or later.
 
   
  +
== Install using the Stack Installer ==
Download Jenkins from [https://jenkins-ci.org/ jenkins-ci.org], install it, and start it as a daemon.
 
  +
The easiest way to install Localyzer on a typical system is to use the [[Terms_and_Definitions#stackinstaller|Stack Installer]]. It will install and configure Localyzer and its supporting components. Once the Stack Installer has completed, continue to [[LRM_Installation#Next_Steps|Next Steps]].
  +
  +
If you cannot use the [[Terms_and_Definitions#stackinstaller|Stack Installer]], follow the instructions below.
  +
  +
== Install Jenkins==
  +
Localyzer should be installed with under the Jenkins user. If you have not done so yet, install Jenkins from [https://jenkins-ci.org/ jenkins-ci.org], install it, and start it as a daemon.
   
Check that the location of the 'workspace' is <b>${JENKINS_HOME}/jobs/${ITEM_FULLNAME}/workspace</b>. This location can be found by going to <code>Jenkins -> Manage Jenkins</code> and clicking <code>Advanced...</code> near the top right of the configuration settings. Look for <code>Workspace Root Directory</code>.
+
Check that the location of the 'workspace' is <b>${JENKINS_HOME}/jobs/${ITEM_FULLNAME}/workspace</b>. This location can be found by going to <code>Jenkins -> Manage Jenkins</code> select <code>Configure System</code> and click on <code>Advanced...</code> near the top right page. Look for <code>Workspace Root Directory</code>.
   
 
<em>This is very important</em>. A different Workspace Root Directory will cause real problems!
 
<em>This is very important</em>. A different Workspace Root Directory will cause real problems!
   
Check which <b>Unix user is running the Jenkins job</b>. One simple way to do this is to run a Jenkins job, for instance 'Debug', with the Unix command 'whoami' as a Build Step / Execute Shell. You will install LRM as this user.
+
Check which <b>Unix user is running the Jenkins job</b>. Check the System Information by selecting <code>Manage Jenkins -> System Information</code> and search for USER.
   
== Installing LRM ==
+
== Installing Localyzer ==
   
 
===Prerequisites ===
 
===Prerequisites ===
  +
Before continuing see [[Introduction#Current_versions_of_Lingoport_products_and_supporting_applications|current supported software versions]]. These are the versions that need to be on the Localyzer Server. Review the [[Lingoport Suite Installation]], which describes how all the Lingoport applications work together and the hardware and software configuration requirements,
 
<OL>
 
<OL>
  +
<LI><b>Linux</b>: The supported Operating system is Linux, preferably CentOS. Verify that the correct version is running on the server. </LI>
<LI>Read the [[Lingoport Suite Installation]], which describes how all the Lingoport applications work together and the hardware and software configuration requirements.</LI>
 
  +
<LI><b>Java</b>: Install the supported version of the <b>Java JDK</b> on the target machine. You can check the Java version using the command line. At the command prompt enter:
<LI>Supported OS: <b>Linux</b></LI>
 
<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 the supported version of Java or above.</LI>
   
<LI>Installed <b>MySQL 5.1 or higher</b> on a database server. [http://www.mysql.com/downloads MySQL Download] site. If the database server is not the same machine as the LRM server, then you will need to install the MySQL 5.x Client (only need Client) on the LRM server so that it can access the database on the separate database server.
+
<LI><b>MySQL</b>: Install the supported version <b>MySQL </b> on a database server. If the database server is not the same machine as the Localyzer Server, then you will need to install the MySQL Client (only need Client) on the Localyzer Server 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:
 
:<code>mysql -u <user> -p<password></code>
 
:<code>mysql -u <user> -p<password></code>
   
* 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 MySQL Download] and install an up-to-date version.
+
* 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 the supported version or higher, please refer to a download site, such as [http://dev.mysql.com/downloads MySQL Download] and install an up-to-date version.
   
 
* You will need to enter the MySQL credentials (host, username, password and port number) during the installation.</LI>
 
* You will need to enter the MySQL credentials (host, username, password and port number) during the installation.</LI>
   
<LI><b>Jenkins</b>, the latest version. See [[#Install Jenkins]]</LI>
+
<LI><b>Jenkins</b>: The latest version should be installed. See [[#Install Jenkins]]. Complete the installation of Jenkins and identify its user before attempting to install Localyzer.</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. The licensing information will include the following:
+
<LI><b>Localyzer Licensing information</b>: When your company purchased Localyzer you should have been sent an email containing the licensing information. The licensing information will include the following:
 
* group name
 
* group name
 
* number of licenses in the license
 
* number of licenses in the license
 
* expiration date for the license
 
* expiration date for the license
 
* license key. This is a 10-digit number generated by Lingoport.
 
* license key. This is a 10-digit number generated by Lingoport.
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> You may many licenses, one per group. This must have been specified during the sales process.
+
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> You may have many licenses, one per group. This must have been specified during the sales process.
   
<LI>Installer jar file: you must have the <b>Lingoport_Resource_Manager_Server-<x.x>-Installer.jar</b> file.</LI>
+
<LI><b>Installer jar file</b>: You must have the <b>Lingoport_Resource_Manager_Server-<x.x>-Installer.jar</b> file. Where <b><x.x></b> is the current supported version of Localyzer</LI>
  +
  +
<LI><b>MySQL Time Zone</b>: 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 Linux, type <br><code>mysql_tzinfo_to_sql /usr/share/zoneinfo/|mysql -u root mysql -p</code><br> from the command line and then <br><code>SET GLOBAL time_zone = 'America/Denver’</code><br> at the MySQL prompt.
   
<LI>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.
 
<UL>
 
<LI>For Windows, you should be able to type <br><code>SET GLOBAL time_zone = 'America/Denver’</code><br> at the MySQL prompt.</LI>
 
<LI>For Linux, you could for instance type <br><code>mysql_tzinfo_to_sql /usr/share/zoneinfo/|mysql -u root mysql -p</code><br> from the command line and then <br><code>SET GLOBAL time_zone = 'America/Denver’</code><br> at the MySQL prompt.</LI>
 
<LI>For MacOS, you may for instance type <br><code>mysql_tzinfo_to_sql /usr/share/zoneinfo/|mysql -D mysql -u root mysql -p</code><br> from the command line and then <br><code>SET GLOBAL time_zone = 'America/Denver’</code><br> at the MySQL prompt.</LI>
 
</UL>
 
 
</LI>
 
</LI>
 
</OL>
 
</OL>
   
===Installing as the Jenkins Unix User ===
+
===Installing Localyzer ===
Once you have retrieved your licensing information and ensured that all requirements are met, log into the server as the <b>Unix user who will be running the Jenkins jobs</b>. This is usually the Jenkins user.
+
Once you have retrieved your licensing information and ensured that all requirements are met (see previous section), log into the server as the <b>Unix user who will be running the Jenkins jobs</b>. This is usually the Jenkins user.
   
* <b>WAIT. DID YOU READ THE ABOVE?</b> Which Unix user will do all the installation?
+
* <b>IMPORTANT:</b> Which Unix user will do all the installation?
 
** <b>Unix user who will be running the Jenkins jobs</b>
 
** <b>Unix user who will be running the Jenkins jobs</b>
   
  +
There are two variations to the install.
====Installing for the First Time====
 
  +
# '''Initial Localyzer Installation''': The Localyzer installer will create the Localyzer Database and the <code>Lingoport_Data/L10nStreamlining</code> directory. The path to the <code>Lingoport_Data/LRM</code> will be established.
Are you logged in as the <b>Unix user who will be running the Jenkins jobs</b>?
 
  +
# '''Upgrading Localyzer''': Use this when upgrading your Localyzer to a newer version, this will make sure the existing Localyzer Database is not overwritten.
  +
  +
  +
A '''headless installation''' is used to installLocalyzer without a windowing system. An XML installation file with the correct options specified is used from the command line.
  +
  +
Please note that '''<code><x.x></code>''' is used in these instructions as a placeholder for the current version of Localyzer. To see the current version see [[Introduction#Current_versions_of_Lingoport_products_and_supporting_applications|current supported software versions]].
  +
  +
====Initial Localyzer Installation====
  +
  +
Verify that you are logged in as the <b>Unix user who will be running the Jenkins jobs</b>.
   
 
* Double-click on the <code>Lingoport_Resource_Manager_Server-<x.x>-Installer.jar</code> file, or
 
* Double-click on the <code>Lingoport_Resource_Manager_Server-<x.x>-Installer.jar</code> file, or
* From the command line, cd to the directory with the installer and type:
+
* From the command line, cd to the directory with the installer jar file and type:
 
::<code>java –jar Lingoport_Resource_Manager_Server-<x.x>-Installer.jar</code>
 
::<code>java –jar Lingoport_Resource_Manager_Server-<x.x>-Installer.jar</code>
   
The installer will prompt you for license information and database settings to create the MySQL LRM database.
+
The installer will prompt you for the install location, license information and database settings to create the MySQL Localyzer database.
The installer will also prompt you for the LRM and the L10nStreamlining directory location. These will default to <code><home>/Lingoport_Data/LRM</code> and <code><home>/Lingoport_Data/L10nStreamlining</code>. When installation completes, the L10nStreamlining directory will have been created, but the LRM directory is created when the first project is generated.
+
The installer will also prompt you for the Localyzer and the L10nStreamlining directory location. These will default to <code><home>/Lingoport_Data/LRM</code> and <code><home>/Lingoport_Data/L10nStreamlining</code>. When installation completes, the L10nStreamlining directory will have been created, but the LRM directory is created when the first [[Terms_and_Definitions#LRMproject|Localyzer project]] is generated.
   
  +
To verify the installation, from the command line:
====Updating Your Existing Installation====
 
  +
<pre>
If you are upgrading your LRM Server to a newer version, make sure that you do not overwrite the existing database.
 
  +
> java -jar <install location>/lrm-cli.jar --version
*Double-click on the Lingoport_Resource_Manager_Server-<x.x>-Installer.jar file, or
 
  +
> java -jar <install location>/lrm-cli.jar --help
  +
</pre>
  +
This should show the current version of Localyzer and the help text. If either of these commands errors, something is incorrect and must be fixed before moving on.
  +
  +
====Updating An Existing Localyzer Installation====
  +
Verify that you are logged in as the <b>Unix user who will be running the Jenkins jobs</b>.
  +
  +
If you are upgrading your Localyzer to a newer version, make sure that you do not overwrite the existing database.
  +
*Double-click on the <code>Lingoport_Resource_Manager_Server-<x.x>-Installer.jar</code> file, or
 
*From the command line, cd to the directory with the installer jar file and type:
 
*From the command line, cd to the directory with the installer jar file and type:
 
::<code>java –jar Lingoport_Resource_Manager_Server-<x.x>-Installer.jar</code>
 
::<code>java –jar Lingoport_Resource_Manager_Server-<x.x>-Installer.jar</code>
   
 
On the Type of Installation page, be sure to select <b>Update Server</b>.
 
On the Type of Installation page, be sure to select <b>Update Server</b>.
  +
  +
To verify the installation, from the command line:
  +
<pre>
  +
> java -jar <install location>/lrm-cli.jar --version
  +
> java -jar <install location>/lrm-cli.jar --help
  +
</pre>
  +
This should show the current version of Localyzer and the help text. If either of these commands errors, something is incorrect and must be fixed before moving on.
   
 
====Headless Installation====
 
====Headless Installation====
Are you logged in as the <b>Unix user who will be running the Jenkins jobs</b>?
+
Verify that you are logged in as the <b>Unix user who will be running the Jenkins jobs</b>.
   
To install LRM without a windowing system, use an xml installation file. The xml installation files can be generated from a first installation or an update using a windowing system on the last page of the installer. That file can be modified to fit other installations. To run a headless installation, from the command line, cd to the directory with the installer and type:
+
To install or update Localyzer without a windowing system or from a command line, use an XML installation file. The XML installation files can be generated from a first installation or an update using a windowing system on the last page of the installer. That file can be modified to fit other installations. To run a [[Terms_and_Definitions#headless|headless installation]], from the command line, cd to the directory with the installer and type:
 
:<code>java –jar Lingoport_Resource_Manager_Server-<x.x>-Installer.jar headlessinstaller.xml</code>
 
:<code>java –jar Lingoport_Resource_Manager_Server-<x.x>-Installer.jar headlessinstaller.xml</code>
  +
  +
To verify the installation, from the command line:
  +
<pre>
  +
> java -jar <install location>/lrm-cli.jar --version
  +
> java -jar <install location>/lrm-cli.jar --help
  +
</pre>
  +
This should show the current version of Localyzer and the help text. If either of these commands errors, something is incorrect and must be fixed before moving on.
   
 
===Adding or Updating the License===
 
===Adding or Updating the License===
 
Depending on your licensing agreement, you will have a license for one or more groups. Each group must have a license.
 
Depending on your licensing agreement, you will have a license for one or more groups. Each group must have a license.
 
To update or add a new license to your current installation, open a command prompt and type:
 
To update or add a new license to your current installation, open a command prompt and type:
* To update an existing license for a group
+
*'''Update an existing license''' for a group:
 
:<code>java -jar <LRM_INSTALLATION_PATH>lrm-cli.jar --update-license --group-name <group> --number-of-licenses <number> --date <YYYY-MM-DD> --license-key <key> </code>
 
:<code>java -jar <LRM_INSTALLATION_PATH>lrm-cli.jar --update-license --group-name <group> --number-of-licenses <number> --date <YYYY-MM-DD> --license-key <key> </code>
* To add a new license for a group:
+
* '''Add a new license''' for a group:
 
:<code>java -jar <LRM_INSTALLATION_PATH>/lrm-cli.jar --create-group <groupname> --number-of-licenses <number> --date <YYYY-MM-DD> --license-key <key> </code>
 
:<code>java -jar <LRM_INSTALLATION_PATH>/lrm-cli.jar --create-group <groupname> --number-of-licenses <number> --date <YYYY-MM-DD> --license-key <key> </code>
* To verify that the new license has been installed with the correct information
+
* '''Verify''' that the new license has been installed with the correct information:
 
:<code>java -jar <LRM_INSTALLATION_PATH>/lrm-cli.jar --list-groups</code>
 
:<code>java -jar <LRM_INSTALLATION_PATH>/lrm-cli.jar --list-groups</code>
   
 
===Group Name===
 
===Group Name===
  +
The group name must be established before Lingoport can issue a license key.
 
A group name <b>must conform</b> to the following specification:
 
A group name <b>must conform</b> to the following specification:
 
A set of alphanumeric characters without the following special characters:
 
A set of alphanumeric characters without the following special characters:
Line 113: Line 152:
   
 
= Next Steps =
 
= Next Steps =
  +
After the installation, there is a
If this is a new installation, you will need to configure your LRM Project and start managing your application's resource files. This involves configuring Jenkins with tabs, the jobs, the users, and the authorizations. See [[LRM Jenkins Configure System]].
 
  +
  +
If this is a new installation, you will need to configure your [[Terms_and_Definitions#LRMProject|Localyzer Project]] and start managing your application's [[Terms_and_Definitions#resourcefiles|resource files]]. This involves configuring [[Terms_and_Definitions#Jenkins|Jenkins]] with tabs, the jobs, the users, and the authorizations. See [[LRM Jenkins Configure System| Localyzer Jenkins Configure System]].
   
LRM works with the Lingoport Dashboard. If you have the Dashboard currently installed, make sure it is configured to point to the current LRM installation. You may want to update the Dashboard installation to do so. If you are going to install the Dashboard later, then don't worry for now. This will be part of the Dashboard installation process.
+
Localyzer works with the [[Terms_and_Definitions#LingoportDashboard|Lingoport Dashboard]]. If you have the Dashboard currently installed, make sure it is configured to point to the current Localyzer installation. You may want to update the Dashboard installation to do so. If you are going to install the Dashboard later, then don't worry for now. This will be part of the Dashboard installation process.
   
<b>Important MySQL Configuration Note</b>
+
<b>Important MySQL Configuration Note: </b>
If you see the following error when running LRM commands: <b>Packet for query is too large</b>
+
If you see the following error when running Localyzer commands: <b>Packet for query is too large</b>
you will need to increase the max_allowed_packet variable of your MySQL database server to either 16 or 32 megabytes in the lingoport directory of your Server and Client installations.
+
you will need to increase the max_allowed_packet variable of your MySQL database server to either 16 or 32 megabytes in the Lingoport directory of your Server and Client installations.
   
 
= Lingoport Customer Support =
 
= Lingoport Customer Support =
If you experience difficulties during the installation of the Lingoport Resource Manager, please contact support@lingoport.com.
+
If you experience difficulties during the installation or update of the Lingoport Resource Manager, please contact '''support@lingoport.com'''.

Latest revision as of 14:11, 12 July 2021

Stack Installer/Updater

The recommended way to install Localyzer is via the Stack Installer or the Stack Updater. This page is kept in case a Localyzer patch for an existing version of the Lingoport Suite is needed.

Localyzer Overview

Localyzer or as formerly known, the Lingoport Resource Manager System, is composed of several items that work together. (See the diagram at Components Diagram):

  1. Localyzer: The Localyzer keeps track of all the actions and the expected results. The server is best located on one central system. This section describes the installation of Localyzer. The Localyzer Database is created during the Localyzer installation.
  2. 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 Localyzer. The Jenkins setup is the subject of another guide.
  3. Dashboard: the Lingoport Dashboard aggregates and displays data from both the Resource Manager and Globalyzer. Its installation is the subject of another guide.

The Dashboard Client typically needs to have access to the lrm-cli.jar files in order to generate the XML report files and subsequently push the files over to the Dashboard Server.

Install using the Stack Installer

The easiest way to install Localyzer on a typical system is to use the Stack Installer. It will install and configure Localyzer and its supporting components. Once the Stack Installer has completed, continue to Next Steps.

If you cannot use the Stack Installer, follow the instructions below.

Install Jenkins

Localyzer should be installed with under the Jenkins user. If you have not done so yet, install Jenkins from jenkins-ci.org, install it, and start it as a daemon.

Check that the location of the 'workspace' is ${JENKINS_HOME}/jobs/${ITEM_FULLNAME}/workspace. This location can be found by going to Jenkins -> Manage Jenkins select Configure System and click on Advanced... near the top right page. Look for Workspace Root Directory.

This is very important. A different Workspace Root Directory will cause real problems!

Check which Unix user is running the Jenkins job. Check the System Information by selecting Manage Jenkins -> System Information and search for USER.

Installing Localyzer

Prerequisites

Before continuing see current supported software versions. These are the versions that need to be on the Localyzer Server. Review the Lingoport Suite Installation, which describes how all the Lingoport applications work together and the hardware and software configuration requirements,

  1. Linux: The supported Operating system is Linux, preferably CentOS. Verify that the correct version is running on the server.
  2. Java: Install the supported version of the Java JDK on the target machine. You can check the 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 the supported version of Java or above.
  3. MySQL: Install the supported version MySQL on a database server. If the database server is not the same machine as the Localyzer Server, then you will need to install the MySQL Client (only need Client) on the Localyzer Server 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 the supported version or higher, please refer to a download site, such as MySQL Download 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. Jenkins: The latest version should be installed. See #Install Jenkins. Complete the installation of Jenkins and identify its user before attempting to install Localyzer.
  5. Localyzer Licensing information: When your company purchased Localyzer you should have been sent an email containing the licensing information. The licensing information will include the following:
    • group name
    • number of licenses in the license
    • expiration date for the license
    • license key. This is a 10-digit number generated by Lingoport.
    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.
  6. You may have many licenses, one per group. This must have been specified during the sales process.
  7. Installer jar file: You must have the Lingoport_Resource_Manager_Server-<x.x>-Installer.jar file. Where <x.x> is the current supported version of Localyzer
  8. 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 Linux, 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.

Installing Localyzer

Once you have retrieved your licensing information and ensured that all requirements are met (see previous section), log into the server as the Unix user who will be running the Jenkins jobs. This is usually the Jenkins user.

  • IMPORTANT: Which Unix user will do all the installation?
    • Unix user who will be running the Jenkins jobs

There are two variations to the install.

  1. Initial Localyzer Installation: The Localyzer installer will create the Localyzer Database and the Lingoport_Data/L10nStreamlining directory. The path to the Lingoport_Data/LRM will be established.
  2. Upgrading Localyzer: Use this when upgrading your Localyzer to a newer version, this will make sure the existing Localyzer Database is not overwritten.


A headless installation is used to installLocalyzer without a windowing system. An XML installation file with the correct options specified is used from the command line.

Please note that <x.x> is used in these instructions as a placeholder for the current version of Localyzer. To see the current version see current supported software versions.

Initial Localyzer Installation

Verify that you are logged in as the Unix user who will be running the Jenkins jobs.

  • Double-click on the Lingoport_Resource_Manager_Server-<x.x>-Installer.jar file, or
  • From the command line, cd to the directory with the installer jar file and type:
java –jar Lingoport_Resource_Manager_Server-<x.x>-Installer.jar

The installer will prompt you for the install location, license information and database settings to create the MySQL Localyzer database. The installer will also prompt you for the Localyzer and the L10nStreamlining directory location. These will default to <home>/Lingoport_Data/LRM and <home>/Lingoport_Data/L10nStreamlining. When installation completes, the L10nStreamlining directory will have been created, but the LRM directory is created when the first Localyzer project is generated.

To verify the installation, from the command line:

> java -jar <install location>/lrm-cli.jar --version
> java -jar <install location>/lrm-cli.jar --help

This should show the current version of Localyzer and the help text. If either of these commands errors, something is incorrect and must be fixed before moving on.

Updating An Existing Localyzer Installation

Verify that you are logged in as the Unix user who will be running the Jenkins jobs.

If you are upgrading your Localyzer to a newer version, make sure that you do not overwrite the existing database.

  • Double-click on the Lingoport_Resource_Manager_Server-<x.x>-Installer.jar file, or
  • From the command line, cd to the directory with the installer jar file and type:
java –jar Lingoport_Resource_Manager_Server-<x.x>-Installer.jar

On the Type of Installation page, be sure to select Update Server.

To verify the installation, from the command line:

> java -jar <install location>/lrm-cli.jar --version
> java -jar <install location>/lrm-cli.jar --help

This should show the current version of Localyzer and the help text. If either of these commands errors, something is incorrect and must be fixed before moving on.

Headless Installation

Verify that you are logged in as the Unix user who will be running the Jenkins jobs.

To install or update Localyzer without a windowing system or from a command line, use an XML installation file. The XML installation files can be generated from a first installation or an update using a windowing system on the last page of the installer. That file can be modified to fit other installations. To run a headless installation, from the command line, cd to the directory with the installer and type:

java –jar Lingoport_Resource_Manager_Server-<x.x>-Installer.jar headlessinstaller.xml

To verify the installation, from the command line:

> java -jar <install location>/lrm-cli.jar --version
> java -jar <install location>/lrm-cli.jar --help

This should show the current version of Localyzer and the help text. If either of these commands errors, something is incorrect and must be fixed before moving on.

Adding or Updating the License

Depending on your licensing agreement, you will have a license for one or more groups. Each group must have a license. To update or add a new license to your current installation, open a command prompt and type:

  • Update an existing license for a group:
java -jar <LRM_INSTALLATION_PATH>lrm-cli.jar --update-license --group-name <group> --number-of-licenses <number> --date <YYYY-MM-DD> --license-key <key>
  • Add a new license for a group:
java -jar <LRM_INSTALLATION_PATH>/lrm-cli.jar --create-group <groupname> --number-of-licenses <number> --date <YYYY-MM-DD> --license-key <key>
  • Verify that the new license has been installed with the correct information:
java -jar <LRM_INSTALLATION_PATH>/lrm-cli.jar --list-groups

Group Name

The group name must be established before Lingoport can issue a license key. A group name must conform to the following specification: A set of alphanumeric characters without the following special characters:

  • < (less than)
  • > (greater than)
  •  : (colon)
  • " (double quote)
  • / (forward slash)
  • \ (backslash)
  • | (vertical bar or pipe)
  •  ? (question mark)
  • * (asterisk)
  • (space)
  •  % (percentage)

Next Steps

After the installation, there is a

If this is a new installation, you will need to configure your Localyzer Project and start managing your application's resource files. This involves configuring Jenkins with tabs, the jobs, the users, and the authorizations. See Localyzer Jenkins Configure System.

Localyzer works with the Lingoport Dashboard. If you have the Dashboard currently installed, make sure it is configured to point to the current Localyzer installation. You may want to update the Dashboard installation to do so. If you are going to install the Dashboard later, then don't worry for now. This will be part of the Dashboard installation process.

Important MySQL Configuration Note: If you see the following error when running Localyzer commands: Packet for query is too large you will need to increase the max_allowed_packet variable of your MySQL database server to either 16 or 32 megabytes in the Lingoport directory of your Server and Client installations.

Lingoport Customer Support

If you experience difficulties during the installation or update of the Lingoport Resource Manager, please contact support@lingoport.com.