Difference between revisions of "Lingoport Suite Installation"

From Lingoport Wiki
Jump to: navigation, search
(The Globalyzer Client/Workbench)
(Installation and Upgrade Order)
Line 213: Line 213:
   
 
Now that you have decided on one of the [[ Deployment Scenarios | Deployment Scenarios]], be sure to follow this order:
 
Now that you have decided on one of the [[ Deployment Scenarios | Deployment Scenarios]], be sure to follow this order:
  +
<OL>
 
  +
# If you haven't already, go back and decide on a [[Deployment Scenarios | Deployment Scenario]].
<LI>Install/Upgrade the Globalyzer Server: If you are not using Lingoport's Globalyzer server, http://www.globalyzer.com , follow the instructions in the Globalyzer_Server_Setup&Admin_<version>.doc file included with the Globalyzer Server installation files.</LI>
 
  +
# Read below for details on [[#The Globalyzer Server]], [[#The Dashboard Server System]], [[#The Build Server]] and [[#The Developer Machine]].
<LI>Install/Upgrade the Globalyzer Client: Log in to the Globalyzer Server and click on the Client download link at the bottom of the page.</LI>
 
  +
# Install/Upgrade [[#The Globalyzer Server]]
<LI>Install/Upgrade the LRM Server: Follow the instructions in the LRM Installation Guide HTML file included with your LRM installation files.</LI>
 
  +
# Install/Upgrade [[#The Globalyzer Client/Workbench]]
<LI>Install/Upgrade the Dashboard Server: Follow the instructions in the Dashboard Installation Guide HTML file included with your Dashboard installation files.</LI>
 
<LI>Install/Upgrade the Dashboard Client: Follow the instructions in the Dashboard Installation Guide HTML file included with your Dashboard installation files.</LI>
+
# Install/Upgrade the LRM Server: Follow the instructions in the LRM Installation Guide HTML file included with your LRM installation files.
  +
# Install/Upgrade the Dashboard Server: Follow the instructions in the Dashboard Installation Guide HTML file included with your Dashboard installation files.
</OL>
 
  +
# Install/Upgrade the Dashboard Client: Follow the instructions in the Dashboard Installation Guide HTML file included with your Dashboard installation files.
<p></p>
 
  +
   
 
==The Globalyzer Server==
 
==The Globalyzer Server==
The Globalyzer Server is where your Account and Rule Set information are stored. Lingoport provides the Globalyzer Server at [http://www.globalyzer.com www.globalyzer.com]. However, depending on licensing, you may install the server on your own system. Follow the detailed installation instructions that come with your Globalyzer Server installation files.
+
The Globalyzer Server is where your Account and Rule Set information are stored. Lingoport provides the Globalyzer Server at [http://www.globalyzer.com www.globalyzer.com]. However, depending on licensing, you may install the server on your own system. Follow the detailed installation instructions that come with your Globalyzer Server installation files, especially the Globalyzer_Server_Setup&Admin_<version>.doc file.
   
 
==The Globalyzer Client/Workbench==
 
==The Globalyzer Client/Workbench==

Revision as of 01:04, 3 October 2015

Lingoport Suite Overview

The Lingoport Suite is comprised of three applications:

  • Globalyzer, to detect and fix internationalization issues in your source code.
  • Lingoport Resource Manager (LRM), to track and manage the localization of your translatable resource files.
  • Lingoport Dashboard, to share the progress of your internationalization and localization efforts company-wide, by displaying both high-level and detailed views of your Globalyzer Project Scan data and your Lingoport Resource Manager status information.

Please read through the different Deployment Scenarios and choose the one which is more appropriate for your installation.

Hardware & Software Requirements

The following sections describe the hardware and software requirements for each of the Lingoport Suite applications.

Globalyzer Server

The Globalyzer Server is where all your Globalyzer account information and rule sets are stored. Lingoport's hosted server is at [1]

The following table lists the system specifications for installing the Globalyzer Server on a dedicated Windows or Linux machine. The disk size assumes that the database is also installed on the machine; it could be less if the database is on a separate server. If the server machine is running more than the Globalyzer Server, we recommend increasing CPU and memory.

Hardware requirements

Element Recommended Up to
CPU 2 4
Memory 4 GB 8 GB
Disk 160 GB 500 GB

Software requirements

Software Recommended
Operating System Linux or Windows, 64 bit
Java Standard Edition Java SDK 1.7 or later
MySQL Database MySQL 5.1 or later
Web Server Tomcat 6.x
Web Browser Any more recent browser

Lingoport Resource Manager Database

The LRM MySQL Database is where all your resource file tracking and management status is stored. When the LRM Server is installed, you will enter the connection to the LRM database.

Hardware Requirements

Element Recommended Minimum
CPU 2
Memory 4 GB
Disk 160 GB

Software Requirements

Software Supported
Operating Systems
  • Windows: 64 bit, 32 bit
  • Linux: 64 bit, 32 bit
  • Mac OS X: Power PC, 64 bit, 32 bit
Java Standard Edition Java SDK 1.7 or later
MySQL Database MySQL 5.1 or later

Lingoport Resource Manager Server

The LRM Server provides a command line interface, run via Jenkins jobs, that you use to configure, manage and track the localization of your application's resource files. LRM must be installed on machines that will also have the Dashboard Client installed, such as a build machine, where the source code is available. The LRM MySQL Database is not required to be on this machine.

Note: A Linux OS system is required by the LRM Server.

Hardware Requirements

Element Recommended Minimum
CPU 2
Memory 4 GB
Disk 160 GB

Software requirements

Software Supported
Operating Systems Linux: 64 bit
Java Standard Edition Java SDK 1.7 or later

Lingoport Dashboard Server

The Dashboard Server displays the results of Globalyzer scans and/or the Resource Manager status in a web browser. The hardware requirements assume that the MySQL database is on the Dashboard Server machine; if the database is on a different server, then the disk size can be less, but you will still need the MySQL Client installed on the Dashboard Server machine.

Hardware Requirements

Element Recommended Minimum
CPU 2
Memory 500 MB
Disk 160 GB

Software Requirements

Software Supported
Operating Systems
  • Windows: 64 bit, 32 bit
  • Linux: 64 bit, 32 bit
  • Mac OS X: Power PC, 64 bit, 32 bit
Java Standard Edition Java SDK 1.7 or later
MySQL Database MySQL 5.1 or later
Web Browser Any more recent browser

Lingoport Dashboard Client

The Dashboard Client analyzes source code with Globalyzer and/or with LRM and displays the information on the Dashboard server. The client must be installed on a machine where the source code resides and both the Globalyzer Client and the LRM Server have been installed. Although you can run the Dashboard scripts directly, using an application such as Jenkins, allows you to have a continuous integration system that will update your application's source code, execute Dashboard scripts to call Globalyzer and LRM to generate internationalization and localization status, and then push those results to the Dashboard Server. This entire process can be set up and then scheduled to run nightly using Jenkins' web-based interface.

Note: A Linux OS system is required by the Dashboard Client to run LRM's automated scripts.

Hardware Requirements

Element Recommended Minimum
CPU 2
Memory 500 MB
Disk 160 GB

Software Requirements

Software Supported
Operating Systems Linux: 64 bit (or Windows, Mac if no LRM)
Java Standard Edition Java SDK 1.7 or later
Web Browser Any more recent browser
Jenkins 1.6 or greater

Systems Configuration

The Lingoport Suite can be configured in a variety of ways. The following describes our recommended configuration for a Continuous Globalization System, where both internationalization and localization progress is tracked, managed and displayed in an automated and reliable process.

Lingoportsuite config.png

Important Note : The Dashboard server and the Build Server can be the same machine. This is a frequent deployment scenario. The same machine can also host the Globalyzer Server. To see more deployment scenarios, please refer to Deployment Scenarios . Make sure you choose a deployment scenarios with your IT department before starting the installation.

Installation and Upgrade Order

Now that you have decided on one of the Deployment Scenarios, be sure to follow this order:

  1. If you haven't already, go back and decide on a Deployment Scenario.
  2. Read below for details on #The Globalyzer Server, #The Dashboard Server System, #The Build Server and #The Developer Machine.
  3. Install/Upgrade #The Globalyzer Server
  4. Install/Upgrade #The Globalyzer Client/Workbench
  5. Install/Upgrade the LRM Server: Follow the instructions in the LRM Installation Guide HTML file included with your LRM installation files.
  6. Install/Upgrade the Dashboard Server: Follow the instructions in the Dashboard Installation Guide HTML file included with your Dashboard installation files.
  7. Install/Upgrade the Dashboard Client: Follow the instructions in the Dashboard Installation Guide HTML file included with your Dashboard installation files.


The Globalyzer Server

The Globalyzer Server is where your Account and Rule Set information are stored. Lingoport provides the Globalyzer Server at www.globalyzer.com. However, depending on licensing, you may install the server on your own system. Follow the detailed installation instructions that come with your Globalyzer Server installation files, especially the Globalyzer_Server_Setup&Admin_<version>.doc file.

The Globalyzer Client/Workbench

From #The Build Server you will be using, log in to the Globalyzer Server and click on the Client download link at the bottom of the page. If you have not configured your own Globalyzer Server, use www.globalyzer.com. Follow the instructions on the download page. For the Client's database, you may use either MySQL or HSQLDB.

  • If choosing MySQL, you must have MySQL 5.1 or greater installed'
  • You do not need to install any of the optional installation packages (Globalyzer Command Line Client, Globalyzer Ant Tasks). You may still install these if desired.

Once the workbench is installed, follow the instructions on the install page to start it. A login prompt will open. If you've installed the Globalyzer Server internally, open the "Connections" tab and change the server URL to point to your Globalyzer Server. Enter your credentials and attempt to log in.

If the login is successful, and Globalyzer opens without any error dialogues, then this indicates that the Globalyzer Server is working properly. If you've installed the Globalyzer Server internally, well done! Otherwise, this is still useful confirmation that you can connect to and use www.globalyzer.com.

If the login is not successful, then you'll need to troubleshoot why. It's probably best to double check your login and connection information before proceeding into deeper troubleshooting.

The Dashboard Server System

The Dashboard Server System is where you view internationalization and localization status of your projects in a sonar-powered dashboard. It contains the MySQL databases for both Dashboard and LRM as well as the scripts to start the Dashboard Server. In this configuration, we have separated the client applications from the server applications, though they are often combined on a single machine.

  • Install MySQL 5.1 or greater.
  • Install Java 7 JRE or greater.
  • Install the Dashboard Server. See the Dashboard Installation for details.

The Build Server

The Build Server is where you install many of the Lingoport Suite applications. It is the heart of the Continuous Globalization system, since this is where the automation occurs that keeps globalization status up-to-date. We call it the Build Server to distinguish it from a Developer machine and to imply that it could have source code for multiple applications, but it does not need to actually build executables. It just needs to run the Dashboard, Globalyzer, and LRM scripts on the latest source code; the Dashboard scripts will call the Globalyzer Client to scan the source code for internationalization issues, LRM to check for localization status, and then it will push those results to the Dashboard Server.

Starting with LRM 2.0, Jenkins, a continuous integration tool, is required. In addition to support for nightly scanning and scheduled Dashboard updates, Jenkins scripts are added as part of its LRM configuration that result in round-trip automation in the management of resource files.

  • Make sure the OS for the server is Linux, preferably Ubuntu.
  • Install Java 7 JDK or greater. The JDK is required by Globalyzer.
  • Install Jenkins 1.620 or greater.
  • The Globalyzer Client requires either MySQL or HSQLDB. If you choose MySQL, you will need to install MySQL 5.1 or greater.
  • Install the Globalyzer Client.
  • Install the LRM Server - as part of installation, you will enter connection to the LRM Server database. See Installation and Configuration
  • Install the Dashboard Client. See the Dashboard Installation section for details.

The Developer Machine

The individual Developer machine is where you install the Globalyzer Workbench so that internationalization and localization issues can be addressed.

  • Install Java 7 JDK or greater. The JDK is required by Globalyzer.
  • The Globalyzer Client requires either MySQL or HSQLDB. If you choose MySQL, you will need to install MySQL 5.1 or greater.
  • Install the Globalyzer Client.


Lingoport Customer Support

If you experience difficulties during the installation of the Lingoport Suite, please contact support@lingoport.com.