Dashboard Installation 5.6.x

The Dashboard Server installation creates a MySQL database which is accessed by the Dashboard Client installations.

Pre-requisites

Read the Lingoport Suite Installation, which describes how all the Lingoport applications work together and the hardware and software configuration requirements.

Selected a target machine that has a supported Operating System: Windows, Linux, or MacOS

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. 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.
   • 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 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. Determine the port you will use for connection to the Dashboard Server; the default is 9000; on Mac the port is usually 9090. You will need to enter the connection port during the Dashboard Server installation.<?LI>
5. Download the installer jar file Lingoport_Dashboard_Server-<x.x>-Installer.jar (See support@lingoport.com if you don't have that information. It should have been sent in an email based on your license. )

   LRM Installation

   Run the installer, as the user Jenkins who runs the jobs, 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.

   Once you have retrieved your licensing information and ensured that all requirements are met, run the LRM Server installer.

   Installing for the First Time

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

      java –jar Lingoport_Dashboard_Server-<x.x>-Installer.jar
   

   The installation process will set up the Dashboard database as well as install the the Dashboard web server.

   Updating Your Existing Installation

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

   • Double-click on the Lingoport_Dashboard_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_Dashboard_Server-<x.x>-Installer.jar
   

   • In Step 5 of the installation process, be sure to uncheck the checkbox labeled Install LINGODASH Database Data.

   Follow the steps in the next section to start the Dashboard Server. See the section on Upgrading the Dashboard Client for additional upgrade instructions.

   Running the Dashboard Server

   After installation, follow these steps to ensure that the server is running and can be successfully displayed:

   • From the command line, cd to the bin directory of where you installed the Dashboard Server and then cd to the appropriate directory for your specific operating system.
   • For Windows, enter:

      StartSonar
   

   • For Mac or Linux, enter:

      ./sonar.sh start
   

   • Check the sonar.log file under the logs directory to make sure there are no errors. It is possible that the connection port is being used by another process. In this case, you may either keep 9000 or 9090 for the Dashboard Server and kill the other process, or modify the Dashboard port number by adjusting the sonar.web.port property in the sonar.properties file in the conf directory.
   • To start the server, open a browser from the server system or another computer that has access to the server and enter:

      http://<hostname>:<port>
   

   For example, displaying the Dashboard on the local system with the default port 9000:

      http://localhost:9000
   

   You should see the Lingoport Dashboard web page.