View Source

{scrollbar:icons=false}
h1. {page-info:title}
{anchor:ContentsofthisPage}{panel:title=Contents of this Page}
{toc:minLevel=2}
{panel}

h2. Tool overview
LexEVS v5.1 is an enhancement version, based on the new architecture introduced in LexEVS v5.0. (See [LexEVS 5.0] (Tool Overview). 

LexEVS v5.1 focuses on providing features that support the NCI Metathesaurus Browser: improved query performance and full loading of RRF data. Also, this version offers Value Domain and Pick List Services integrated into the LexEVS API, and an improved loader framework.

*LexEVS v5.1 Architecture*
!LexEVS_5.1_architecture.png|alt="LexEVS 5.1 architecture diagram"!

h3. What's new     
_Highlights_ 
* Released on January 5, 2010
* Enhanced query performance and behavior:
** Lucene 2.4 fast search engine with lazy document loading
** Plug-in search framework that allows a text query string input and generates a Lucene query output
** Plug-in sort framework that allows rapid creation of new sort algorithms and techniques
** SQL query optimaizations that increase database performance
* LexEVS Value Domain Service - provides programmatic access to load value domain definitions using the domain objects that are available via the LexGrid logical model
* LexEVS Pick List Service - provides programmatic access to pick list definitions using the pick list that are available via the LexGrid logical model
* Loader framework enhancements - improved loading capability; allows loaders to be modular and easily extendable; ability to load custom data
* RRF loader enhancements - ability to fully load RRF data; support the NCI Metathesaurus Browser
* BDA (Build and Deployment Automation) support - build and deployment of LexEVS project artifacts to remote servers

h3. At-a-glance specifications

* Grid Enabled: uses caGrid 1.3
* Compatibility Level: submitted for Silver
* Installation Level: Intermediate - technical assistance may be required, download may require supporting infrastructure or software
* Technology Stack: No new dependencies since LexEVS 5.0 except for additional storage to accommodate larger content loads.
** Operating System - Linux or Windows (although no operating system dependencies exist)
** Web Application Server - Apache or JBoss
** Database Server - MySQL, Oracle, PostgreSQL, HSQLDB, or DB2
** Other software components - caGrid 1.3 / Globus 4.0.3
** Server Hardware - NCI standard hardware
** Minimum processor speed  - Minimum required by Web Application Server
** Minimum memory - Minimum required by Web Application Server
** Expected file server disk storage (in MB)- 200GB 
** Expected database storage (in MB)- 100GB 
** Networking - Standard port required by JBoss to externalize LexEVS grid service. May be assigned any suitably available port #
For specific versions required please see [2 - LexEVS 5.x Prerequisite Software and Supported Platforms].

h2. Installation and downloads

h3. For everyone
Prior to using LexEVS we recommend reviewing our model and schema as this will aid in understanding and using LexEVS. 
* [LexGrid Model and Schema]
Information about the current and previous LexGrid models and schema.

h3. Beginners
For anyone new to LexEVS we recommend reviewing the [LexEVS 5.x Quick Start] page before downloading and installing LexEVS. The [LexEVS 5.x Quick Start] provides recommended links to additional information for users who are new to LexEVS.  Once you have reviewed some of the information in the Quick Start, come back here to install LexEVS.

* [LexEVS 5.x Installation Guide]
This document provides step-by-step, technical, installation instructions for LexGrid Enterprise Vocabulary Services v5.x for caBIG®.

h3. Intermediate
* [LexEVS 5.1 Installation Outline]
This page is for those users who are somewhat familiar with LexEVS and would like some guidance for installation. It lays out which files you may need to download to utilize LexEVS 5.1 based on what type of installation you require. There are even links to download the appropriate jars/zip files.

* [LexEVS Widget Library]
This page lists many widgets that have been developed for use by particular customers.  These widgets have been found to be potentially useful to a wider audience.  Each widget has a description for you to use in deciding if you'd like to dig deeper and find out the usefulness of the widget in your application.

h3. Experts
* [LexEVS 5.1 Components] (Download files)
If you are already very familiar with LexEVS, refer to this table for links to download the files/jars released with LexEVS 5.1, along with short descriptions of each. If you need further installation guidance please see the installation section below or review the [LexEVS 5.1 Documentation].

h3. Fix Releases

{include:LexEVS 5.1 Fix Releases to Include}

{Include:VKC:Code Download Disclaimer to Include}

h2. Documentation for version 5.1

h3. Release documents

* [LexEVS 5.1 Release Notes|https://gforge.nci.nih.gov/docman/view.php/491/19364/lexevsapi51_notes.html]
A detailed description of the features, bug fixes, and known issues in this release; also a release history. 

* Javadoc
** [View Javadoc as a web page|http://lexevsapi51.nci.nih.gov/lexevsapi51/docs/].
** [Download a copy of the Javadoc|https://gforge.nci.nih.gov/docman/view.php/491/20195/LexEVS_51_javadocs.zip].
** [Learn more about documentation produced as Javadoc|http://java.sun.com/j2se/javadoc/].

* [LexEVS v5.1 Readme for Client|https://gforge.nci.nih.gov/docman/view.php/491/20231/LexEVS_51_readme.txt] 
Lists contents of the caCORE LexEVS v5.1 client, required library files, demo programs, and an Ant build script. Outlines requirements for installation, describes how to run test examples, and provides licensing information.

* [LexEVS v5.1 Readme for API|https://gforge.nci.nih.gov/docman/view.php/491/20232/LexEVS_51_source_readme.txt]
Instructions for installing a local version of caCORE web-enabled LexEVS API v5.1 on a server machine. Outlines requirements for installation and provides licensing information.

h3. Guides for Users
Refer to [LexEVS 5.1 Guides for Users to Include], which includes a collection of guides for specific purposes and audiences, such as architecture, migration, and programming.

h3. Programming examples
Feel free to browse through this compiled list of examples. You will also encounter them in context as they are used throughout the LexEVS documentation.

* [LexEVS API Code Examples|LexEVS API Code Examples]
* [LexEVS caCore Code Examples|LexEVS caCore Code Examples]
* [LexEVS caGrid Code Examples|LexEVS caGrid Code Examples]
* [LexEVS DataGrid Code Examples|LexEVS DataGrid Code Examples]
* [LexEVS Rest Code Examples|LexEVS REST Code Examples]

h3. Documentation in PDF

Refer to to [LexEVS 5.x Documentation in PDF] to retrieve PDF files created from the wiki-based user guides.

h2. Service URLs

h3. LexEVS API URLs

* EVS Home Page - https://cabig.nci.nih.gov/concepts/EVS/

* LexEVS 5.1 Java API - http://lexevsapi51.nci.nih.gov/lexevsapi51/Home.action
 
* XML-HTTP API
For example: {code}http://lexevsapi51.nci.nih.gov/lexevsapi51/{servlet}?query={returnClass}&{criteria}&resultCounter={counter}&startIndex={index}&pageSize={pageSize}&pageNumber={pageNumber}{code}
 
* Example with sample parameters: {code}http://lexevsapi51.nci.nih.gov/lexevsapi51/GetHTML?query=org.LexGrid.concepts.Entity&org.LexGrid.concepts.Entity[@_entityCode=C12434]{code}

h3. LexEVS Grid Service URL

* caGrid Portal - http://cagrid-portal.nci.nih.gov

* LexEVS 5.1 Analytical Grid Service (for programming contexts)
{code}http://lexevsapi-analytical51.nci.nih.gov/wsrf/services/cagrid/LexEVSGridService{code}

* LexEVS 5.1 Data Grid Service (for programming contexts)
{code}http://lexevsapi-data51.nci.nih.gov/wsrf/services/cagrid/LexEVSDataService{code}

h2. Support

{multi-excerpt-include:pageTitle=LexEVS 6.0|name=LexEVSSupportLinks|nopanel=true}

h2. Contributions
In the spirit of open source caBIG® invites you to participate in our community. The contribution process is described in [LexEVS Community Code Contribution].  LexEVS source code is in [NCI SVN|https://ncisvn.nci.nih.gov/svn/lexevs/] and the project is ready to accept your contributions to this tool.

h2. Training materials and background information

{include:LexEVS Training and Background to Include}

h2. Presentations and demos

{multi-excerpt-include:pageTitle=LexEVS 6.0|name=LexEVSPresentations|nopanel=true}

h2. Related Tools

All other [versions of LexEVS|LexEVS Release Roadmap].

h2. Additional resources

{include:LexEVS Additional Resources Links to Include}

{scrollbar:icons=false}