NIH | National Cancer Institute | NCI Wiki  

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Note
titleBEFORE YOU BEGIN

LexEVS has been tested with the operating systems and hardware specified in the supported platforms. While LexEVS is expected to run on many variations of hardware and software similar to the test platforms, results cannot be guaranteed. Before you begin you should check to make sure that your platform will support the software.

  • There are a number of prerequisite software products that you must install to run a LexEVS Local Runtime on your platform. You must make sure that you have the proper software and versions, depending on which LexEVS environment you are installing. Do this now, for the Local Runtime designated prerequisite software, before continuing to the install steps.
  • As an option you may consider the command line install of a LexEVS Local Runtime for putting all the necessary files in place based on a pre-decided list of components to include. As noted in the last step of the GUI Installer for LexEVS Local Runtime, you can save a file that represents the choices you have made during the GUI install. This file can be used as-is or be edited and then fed into an install on another server. Follow the steps for installing a LexEVS Local Runtime using the optional command line method if you should choose this route.
  • Complete the 2 - Installing LexEVS 6.x Local Runtime steps.

...

Step

Action

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.

Note
titleNote

If you plan to install LexEVS Distributed or the LexEVS Grid Services then you must install matching versions in conjunction with the Local Runtime.

Note
titleNote

Access to the downloads does not require an account. If you are having trouble downloading files then you may need to disable pop-up blockers or check any firewall settings at your site.

FilenameDescription

LexEVS-install-6.1.0.jar

GUI Installer for LexEVS Local Runtime: A single download package with everything you need to install the Local Runtime in a graphical user environment. This package includes the Local Runtime client and dependency JAR files listed in this table.

lexbig.jar

If you need the Local Runtime client, a JAR file with the LexEVS classes only can be found in {LEXEVS_HOME}/runtime-components/lexbig.jar. The core runtime, LexEVS API, loaders, and administrative utilities are included. Ships with the GUI installer.

LexEVS_localRuntime_dependencies.jar

LexEVS Local Runtime 3rd Party Dependencies:Includes code from other open source projects required by the LexEVS API. This file is included with the GUI installer.

LexEVS-install-config-6.1.xml

LexEVS Local Runtime Command Line Install: An XML file allowing the user to install in a command line environment. This file can be generated by the GUI installer or downloaded here.

LexEVS 6.1 Release NotesLexEVS Local Runtime Release Notes: A list of resolved issues and enhancements provided in the major release.

 

 

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:

Code Block
java -jar LexEVS-install-6.0.4.jar

screenshot illustrating stepImage Removedscreenshot illustrating stepImage Added

3. Click the OK button to begin the installation.

Note
titleNote

The only language currently supported is English.

screenshot illustrating stepImage Removedscreenshot illustrating stepImage 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.

screenshot illustrating stepImage Removedscreenshot illustrating stepImage Added

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

screenshot illustrating stepImage Removedscreenshot illustrating stepImage 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.

Note
titleNote

In any operating system it is NOT recommended to use spaces in the install path. You will be better off if you do not use the default "Program Files" path in Windows.


Click the Next button.

Note
titleNote

If the directory does not exist, the program will prompt to proceed with creating the new directory. If the directory does exist, the program will prompt to overwrite the directory and files that may be contained within it.

screenshot illustrating stepImage Removedscreenshot illustrating stepImage 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.

screenshot illustrating stepImage Removedscreenshot illustrating stepImage Added

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

screenshot illustrating stepImage Removedscreenshot illustrating stepImage Added

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

screenshot illustrating stepImage Removedscreenshot illustrating stepImage 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.

screenshot illustrating stepImage Removedscreenshot illustrating stepImage Added

11. Install the latest fixes.

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

Wiki Markup
{Include:LexEVS 6.0 Local Runtime Downloads to Include}

...

The LexEVS Local Runtime can be configured to work with many different databases, however, the recommended databases are MySQL or PostgreSQL. Specific versions are noted in the listing. Following installation of a database of your choice you should follow these steps in order.

...

Step

Action

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:

Code Block
TestRunner.bat -v

Unix example:

Code Block
./TestRunner.sh -v
Note
titleNote

The image shows the start of the test. If you use the Java runtime rather than the Java SDK at this point it will complain about tools.jar. Other debug errors may show up but these are just warnings.

screenshot illustrating stepImage Removedscreenshot illustrating stepImage 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.

screenshot illustrating stepImage Removedscreenshot illustrating stepImage Added

If all the tests pass then you have successfully installed the LexEVS Local Runtime. Congratulations!

...