NIH | National Cancer Institute | NCI Wiki  

Versions Compared

Old Version 8

changes.mady.by.user Unknown User (wileyal)

Saved on

compared with

New Version 9

changes.mady.by.user Unknown User (wileyal)

Saved on

Key

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

...

  • 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 Downloading and Installing the LexEVS Local Runtime steps below.

Once you have completed the prerequisite software install, the Local Runtime environment install steps, and the verification test as described in this guide then you should be ready to start programming using the API to meet the needs of your application. Not counting prerequisite software products the installation and verification should not take more than 60 minutes.

...

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.

  • GUI Installer for LexEVS Local Runtime
    A single download package with everything you need to install the Local Runtime in a graphical user environment.
    LexEVS 6.0 Installer
  • LexEVS Local Runtime Fixes
    Fixes to be downloaded and installed after the initial install:
    6.0.1 JAR file Copy this file into the {LEXEVS_HOME}/runtime directory. See the ReadMe file for the latest information for about this release.
  • LexEVS Local Runtime Release Notes
    An optional download if you want to see the resolved issues and enhancements provided in the primary release. Readmes will contain information for fix releases. [ LexEVS 6.0 Release Notes

https://gforge.nci.nih.gov/docman/view.php/491/23714/lexevsapi60_notes.html]

  • 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.0 Command Line Install XML
  • LexEVS Local Runtime Environment
    A seperate archive in Java jar format including the LexEVS classes only. The core runtime, LexEVS API, loaders, and administrative utilities are included. Ships with the GUI installer above.
    LexEVS 6.0 Runtime Jar
  • LexEVS Local Runtime 3rd Party Dependencies
    Includes third party, open source code required by the LexEVS API. These ship with the GUI installer above.
    LexEVS 6.0 Runtime dependencies

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.jar

screenshot illustrating step

3. Click the OK button to begin the installation.

Note
titleNote

The only language currently supported is English.

screenshot illustrating step

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 step

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

screenshot illustrating step

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 step

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 step

<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="a76fd0ca0976e615-cf15319b-462c45eb-aa289408-d4adb4a15747e95bf99ef909"><ac:plain-text-body><![CDATA[

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

!worddav5a05b264d45b2e226432110817440e79.png

height=400,width=599,alt="screenshot illustrating step"!

]]></ac:plain-text-body></ac:structured-macro>

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

screenshot illustrating step

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 step

11. Install the latest fixes.
Select the latest fixes available on the right and install them as instructed.

  • GUI Installer for LexEVS Local Runtime
    A single download package with everything you need to install the Local Runtime in a graphical user environment.
    LexEVS 6.0 Installer
  • LexEVS Local Runtime Fixes
    Fixes to be downloaded and installed after the initial install:
    6.0.1 JAR file Copy this file into the {LEXEVS_HOME}/runtime directory. See the ReadMe file for the latest information for about this release.
  • LexEVS Local Runtime Release Notes
    An optional download if you want to see the resolved issues and enhancements provided in the primary release. Readmes will contain information for fix releases.
    LexEVS 6.0 Release Notes
  • 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.0 Command Line Install XML
  • LexEVS Local Runtime Environment
    A separate archive in Java jar format including the LexEVS classes only. The core runtime, LexEVS API, loaders, and administrative utilities are included. Ships with the GUI installer above.
    LexEVS 6.0 Runtime Jar
  • LexEVS Local Runtime 3rd Party Dependencies
    Includes third party, open source code required by the LexEVS API. These ship with the GUI installer above.
    LexEVS 6.0 Runtime dependencies

...

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}\testRun the TestRunner utility to start the test process: > TestRunner.{ext} -vwhere {ext} is the extension appropriate for your operating system (bat for Windows, sh for Unix) For example: Windows: TestRunner.bat -v Unix: ./TestRunner.sh -v

Note
titleNote

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

screenshot illustrating step

<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="59417dfa3c1cd3c5-0c9d75f5-471249ef-a428985b-f51ac1baa8c677409b1b370a"><ac:plain-text-body><![CDATA[

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.

!worddav539e734466f100b915febc925967b13d.png

height=379,width=597,alt="screenshot illustrating step"!

]]></ac:plain-text-body></ac:structured-macro>

...