Page History

1. Download the latest version of the Local Runtime GUI install package from the right. The location you have chosen to save this on your computer will be referred to as the SAVE_DIRECTORY. Examples will use scratch as the directory.

2. Using a file explorer, navigate to the SAVE_DIRECTORY. Double Click on the downloaded JAR file. This will launch the install wizard.
As an alternative to a file explorer, use a command prompt. Change to the SAVE_DIRECTORY:
cd {SAVE_DIRECTORY}
Then enter the command to begin the installation wizard:
java -jar LexEVS-install-{version}.jar
where {version} is the version you downloaded For example:

java -jar LexEVS-install-6.0.4.jar

Image RemovedImage Added

3. Click the OK button to begin the installation.

Image RemovedImage Added

4. After the initial welcome screen, the release notes for the LexEVS distribution are displayed. Once you have read through the release notes click the Next button.

Image RemovedImage Added

5. Review the license agreement of the LexEVS software. Select "I accept the terms of this license agreement." and click Next.

Image RemovedImage Added

6. Enter the path where you would like the LexEVS software installed. This will be referred to as LEXEVS_HOME throughout the remaining instructions.

Click the Next button.

Image RemovedImage Added

7. Select the components to be installed. The components "Product Information" and "Runtime and Administration Toolkit" are required and cannot be unchecked. The remaining components are optional. Clicking on individual components will display a description of that component.

Once components have been selected click Next.

Image RemovedImage Added

8. Once all the components have been installed, a [Finished] dialog will be displayed. Click Next.

Image RemovedImage Added

9. A dialog with some help and urgent reminders will appear. Click Next.

Image RemovedImage Added

10. The last step of the installation wizard provides the ability to generate a command line installation configuration XML file that can be used on other servers. This installation script can be used to install LexEVS without the wizard that you just went through. If you want to generate this file then click the Generate an automatic installation script button. This will have no effect on the current installation. For more information look at the instructions for Installing LexEVS 6.0 Local Runtime (Optional Command Line Method).

Click Done to complete the installation process.

Image RemovedImage Added

11. Install the latest fixes.

If you started with the 6.0.4 installer there are no additional fixes at this time.

1. Configure Database Management System properties

We provide examples of MySQL and PostgreSQL configurations to optimize a database for LexEVS.

• MySQL properties
  We highly recommend optimizing the behavior of the MySQL database server by changing the set of properties in the following link.
  LexEVS 6.0 Local Runtime MySQL Properties Guide
• PostgreSQL properties
  Optimizations for the Postgres DBMS are at the following link.
  LexEVS 6.0 Local Runtime PostgresSQL Properties Guide

2. Create a database

LexEVS does not create a database for you. You must do this as the administrator of your database management system.

Consult database management system documentation. We provide an example and a recommendation for MySQL. LexEVS must have access to a user with rights to create, update and delete tables.

3. Make sure the JDBC driver is in place

The java software interface for a given supported database must be available in the <install-root>/runtime/sqlDrivers directory

• Check {LEXEVS_HOME}\runtime\sqlDrivers to see if the appropriate driver for your database is there. Licensing restrictions prevent some drivers, like those from MySQL, from being shipped with LexEVS.
• MySQL driver can be downloaded from MySQL downloads.

4. Modify the LexEVS configuration file

Update the LexEVS service properties file {LEXEVS_HOME}/resources/config/lbconfig.propswith connection and database settings

The lbconfig.props file has the latest documentation embedded inside of it. lbconfig.props should be considered authoritative if there is a difference between the documentation written here and that contained in lbconfig.props.
You may open that file now and use the documentation within it to configure LexEVS.
The following link describes all of the property settings available for configuring LexEVS. It may have additional descriptive information beyond that found within lbconfig.props. It is useful but not necessary to a successful install.
LexEVS 6.0 x Local Runtime Configuration File Settings

5. Set DB_PRIMARY_KEY_STRATEGY

Take extra care to consider this parameter in the configuration file. The value for the parameter may not be optimal for loading terminologies. You must change its value before any LexEVS operations. Once there have been any operations you can not reset this parameter without deleting the database and recreating it.

See the parameter settings documentation for more information.

1. Your database management system and your web container must be running. This should already be true but if you get connection errors then it is usually due to this.

Verify

2. In a command prompt window change to the test directory:
cd {LEXEVS_HOME}\test
Run the TestRunner utility to start the test process:
> TestRunner.{ext} -v
where {ext} is the extension appropriate for your operating system (bat for Windows, sh for Unix)
Windows example:

TestRunner.bat -v

Unix example:

./TestRunner.sh -v

Image RemovedImage Added

3. Each test section should have [OK] printed after it. If so then that test passed. If you see [FAIL] after a test then you will need to look into the error. When it says BUILD SUCCESSFUL at the end this simply means that the test script ran to the end.

Image RemovedImage Added