NIH | National Cancer Institute | NCI Wiki  

Versions Compared

Key

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

...

Step

Action

1. Download the latest version of the LexEVS Distributed WAR file from the right. You have a choice between WAR files tailored for JBoss or Apache Tomcat installations. The location you have chosen to save this on your computer will be referred to as the SAVE_DIRECTORY. Our command examples will use scratch as this directory.

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

Include Page
LexEVS 6.0 Distributed Downloads to Include
LexEVS 6.0 Distributed Downloads to Include

2. Shut down your application or servlet container. This presumes that you have already installed a web server as outlined in the LexEVS 6.x Prerequisite Software Supported to Include. The command to do the shut down will be web server specific. See the documentation for your web server for information on how to do this. There may be many alternatives.
JBoss example:

  • Windows:

    Code Block
    shutdown.bat -S
    
  • Unix:

    Code Block
    ./shutdown.sh -S
    

    If you experience Java errors then the server may already be down.

Shutting down the JBoss server.

3. Rename the WAR file. These files are distributed with an application server designation in their name for clarity while downloading them.
Change to the SAVE_DIRECTORY and rename the file, like this:

Code Block
rename {SAVE_DIRECTORY}/lexevsapi6.5.{WEB_SERVER}.war {SAVE_DIRECTORY}/lexevsapi65.war

JBoss example:

  • Windows:

    Code Block
    rename c:\scratch\lexevsapi65.jboss.war lexevsapi65.war
    
  • Unix:

    Code Block
    move /scratch/lexevsapi65.jboss.war lexevsapi65.war
    
    Info
    titleNote

    Consider other names as well. Many application servers use the deployed name as part of the URL, so if you would rather it be a different name then you should rename the WAR file to that.

Command prompt showing rename of the WAR file.

4. Copy the WAR file to the appropriate web application server directory, like this:

Code Block
copy {SAVE_DIRECTORY}\lexevsapi65.war {WEB_SERVER_HOME}\{DEPLOYMENT_HOME}

...where SAVE_DIRECTORY is the location of the downloaded file.
WEB_SERVER is the brand of the web server.
WEB_SERVER_HOME is your application server home directory.
DEPLOYMENT_HOME is the Web Archive deployment directory for your application server.
JBoss example:

  • Windows:

    Code Block
    copy c:\scratch\lexevsapi65.war c:\jboss-5.1.0.GA\server\default\deploy
    

    Unix:

    Code Block
    copy /scratch/lexevsapi65.war /jboss-4.0.5.GA/server/default/deploy
    

Copy the WAR file to the JBoss deploy directory.

5. Create a text file named lexevs.properties in the WEB_SERVER_CLASSPATH to set the location of the LexEVS configuration. The WEB_SERVER_CLASSPATH is a location along the class path for your web application server. This whole path including the file name will be called LEXEVS_PROPERTIES_HOME for the rest of these instructions.

  • JBoss example:
    • Windows:

      Code Block
      c:\jboss-5.1.0.GA\server\default\conf\lexevs.properties
      
    • Unix:

      Code Block
      /jboss-5.1.0.GA/server/default/conf/lexevs.properties
      
  • Set LG_CONFIG_FILE to the path of the lbconfig.propsfile of your LexEVS installation like this:

    Code Block
    LG_CONFIG_FILE={LEXEVS_HOME}\resources\config\lbconfig.props
    

    ...where LexEVS_HOME is the install directory of LexVES.

  • Copy/paste the examples below as a starting point for this file:
    • Windows:

      Code Block
      LG_CONFIG_FILE=c:\\LexEVS\\6.05\\resources\\config\\lbconfig.props
      
      Info
      titleNote

      he back slash escape character required for a Windows, Java environment.

    • Unix:

      Code Block
      LG_CONFIG_FILE=/LexEVS/6.05/resources/config/lbconfig.props
      

Editing the LexEVS properties file.

6. (OPTIONAL) The lexevs.properties file is also used to add security for any coding scheme. This is not a highly used function, but may be required if your service is publicly hosting a proprietary terminology. For each coding scheme a security implementation class name can be set to enable security like this:

Code Block
{CODING_SCHEME_NAME}={SECURITY_IMPLEMENTATION}

...where CODING_SCHEME_NAME is the name or URI of the terminology.
SECURITY_IMPLEMENTATION is a class that implements the interface gov.nih.nci.system.dao.security.DAOSecurity.
For all ways of accessing the coding scheme, security must be set up. The example at the right shows access by Name, URI, and Formal Name, but others are possible too.Note:Coding schemes can be added or changed later after a coding scheme or terminology is loaded into LexEVS.

Code Block
MedDRA=gov.nih.nci.system.dao.security.MedDRASecurity
 urn\:oid\:2\.16\.840\.1\.113883\.6\.163=gov.nih.nci.system.dao.security.MedDRASecurity
 Medical\ Dictionary\ for\ Regulatory\ Activities\ Terminology\ \(MedDRA\)=gov.nih.nci.system.dao.security.MedDRASecurity

7. Adjust the properties-service.xml file.This file is likely to be found in the WEB_SERVER_HOME DEPLOYMENT_HOME directory but may be different for some servers.

  • JBoss example:
    • Windows:

      Code Block
      c:\jboss-5.1.0.GA\server\default\deploy\properties-service.xml
      
    • Unix:

      Code Block
      /jboss-5.1.0.GA/server/default/deploy/properties-service.xml
      
  • Add a line to the file in the "System Properties Service" section where other properties are set like this:

    Code Block
    <attribute name="Properties">org.LexGrid.LexBIG.caCore.Properties={LEXEVS_PROPERTIES_HOME}</attribute>
    

    ...where LEXEVS_PROPERTIES_HOME is the location and file name of lexevs.properties established in a previous step.

  • In Tomcat place the file in the /webapps/lexevsapi65/WEB-INF/classes directory. Edit the catalina.sh file in <tomcat root>/bin/ adding to the JAVA_OPTS -Xmx1052m -XX:MaxPermSize=256m"
    ...so that this line in catalina.sh::

    Code Block
    JAVA_OPTS="$JAVA_OPTS \-Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager"
    

    Should look like this:

    Code Block
    JAVA_OPTS="$JAVA_OPTS \-Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager \-Xmx1052m \-XX:MaxPermSize=256m"
    
  • JBoss example:

    Code Block
    <attribute name="Properties">
    org.LexGrid.LexBIG.caCore.Properties={LEXEVS_PROPERTIES_HOME}
    </attribute>
    

    ...is added to this file between the <mbean> tags.
    The back slash escape character is NOT required for LEXEVS_PROPERTIES_HOME.

    Info
    titleNote

    In some server installations you may not have authority to modify this file. In that case you can simply move thelexevs.propertiesfile somewhere on the web application servers class path.

Wordpad editing the Jbos Service PROPERTIES file.

...