...

Page info
title title

...

Please follow carefully the steps mentioned provided in the guide for installing LexEVS 6.0 Local Runtime.

Once all the steps have been followed successfully you should have a functional LexEVS Local Runtime instance.

In order to facilitate subsequent testing, please load and activate the test terminology Automobiles.xml located in the folder {LEXEVS_HOME}\test\resources\testData\Automobiles.xml.

...

1. Navigate to the Tomcat 6 download page

   Multiexcerpt include
   nopanel true MultiExcerptName ExitDisclaimer PageWithExcerpt wikicontent:Exit Disclaimer to Include

   and download the appropriate package for your system. The binary core distribution (zip) is the most usual one.
2. Unzip the content of the file in the desired folder and make note of it.

...

1. Navigate to the STS download page

   Multiexcerpt include
   nopanel true MultiExcerptName ExitDisclaimer PageWithExcerpt wikicontent:Exit Disclaimer to Include

   to download the software. Please note that you don't have to fill out the form. If you do not wish to fill it all, just check the checkbox to accept the license terms and click on the link "Download Page" bellow the "Download Now" button.
2. Choose the appropriate version for your environment and install it. Make sure that you have the Java JDK 1.6 (or less ideally 1.5) installed.
3. During setup, make sure to make a note of where you installed the program. During step 4, make sure "Apache Maven 2..." in selected.
4. You can launch STS and select the location of your workspace. You will then be presented with the Welcome page. You can close it with the "x" next to the tab on top left. This will bring a Spring perspective.

...

The issue has been described in a Spring forum post

...

1. LexEVS jar: Can be found in your local LexEVS install: {LEXEVS_HOME}\runtime-components\lexbig.jar
   • For easier access, copy it to a short location. We will use E:\
2. LexEVS POM file: This includes the information on the dependencies LexEVS will rely on. You can download it Lexevs-6.0.0.pom.zip
   • Unzip it to the same location [E:]
3. LexEVS uses a patched version of the dependency ddlutils. You need to download it here . You need to download it

   Multiexcerpt include
   nopanel true MultiExcerptName ExitDisclaimer PageWithExcerpt wikicontent:Exit Disclaimer to Include

   • Place it in the same directory [E:]
4. This dependency also has a POM file which you can download Ddlutils-1.0-PATCHED.pom.zip
   • Unzip it to the same location [E:]

...

For all the following commands, please change *E:* to the path of the folder chosen to place the four files above.

1. Then enter this command at the command prompt:

   Code Block
   mvn install:install-file -Dfile="E:\ddlUtils-1.0-PATCHED.jar" -DpomFile="E:\ddlutils-1.0-PATCHED.pom"

   You should then see a build successful message. The ddlUtils dependency is now available in your local repository.

2. Now enter this command at the command prompt:

   Code Block
   mvn install:install-file -Dfile="E:\lexbig.jar" -DpomFile="E:\lexevs-6.0.0.pom"

   You should also see a build successful message. The LexEVS dependency is now available in your local repository.

3. Open STS and select the menu Window -> Show View -> Other
4. Scroll down to the folder Maven and select Maven Repositories. Click OK.
   You should now have a Maven Repositories view in the lower part of the window.
5. Select and unfold Local Repositories.
6. Right-click Local Repository and select Rebuild Index from the context menu. Click Ok when asked if you're sure you want to rebuild it.

...

1. Select and unfold the project folder [textlex] in the package explorer.
2. Navigate to src/test/java. You should see an empty package [org.test.test]
3. Right-click on it and select New -> JUnit Test Case
4. Put the name of your test in the name textbox. We will name it LexBigConnect. Click on Finish.

5. Copy this in the file (including the last bracket):

   Code Block

   package org.test.test; import static org.junit.Assert.*; import org.LexGrid.LexBIG.Exceptions.LBInvocationException; import org.LexGrid.LexBIG.Impl.LexBIGServiceImpl; import org.LexGrid.LexBIG.LexBIGService.LexBIGService; import org.LexGrid.LexBIG.DataModel.InterfaceElements.CodingSchemeRendering; import org.junit.Test; public class LexBigConnect { @Test public void test() throws LBInvocationException { LexBIGService lbSvc = LexBIGServiceImpl.defaultInstance(); System.out.println("The currently active terminologies are:"); for(CodingSchemeRendering csr : lbSvc.getSupportedCodingSchemes().getCodingSchemeRendering()) System.out.println(csr.getCodingSchemeSummary().getFormalName()); assertTrue(true); } }

6. Make sure to change the package name if you didn't use org.test.test initially. Save the file.

...

1. In STS, select the menu Run -> Run Configurations...
2. Select JUnit in the left list.
3. Select the new button (white rectangle with a little yellow +)
   The name of the profile will be defaulted to the name of your class [LexBigConnect]

4. Click on the tab Arguments and add this parameter to the VM textbox:

   Code Block
   -DLG_CONFIG_FILE="\{LEXEVS_HOME\}\resources\config\lbconfig.props"

5. Replace {LEXEVS_HOME} by the absolute path to the LexEVS local install done earlier in the process.
6. Then click Apply followed by Run.
   You should then see a successful completion of a JUnit test. The console log will also show "The currently active terminologies are:" followed by the name of the terminologies [Automobiles] if you loaded it.

...

1. This will open the server Overview. Click on the "Open launch configuration" link in the General Information section.

2. Select the Arguments tab and in the VM arguments textbox, at the bottom, after the existing arguments add this:

   Code Block
   -DLG_CONFIG_FILE="\{LEXEVS_HOME\}\resources\config\lbconfig.props"

3. Replace {LEXEVS_HOME} by the absolute path to the LexEVS local install done earlier in the process. Make sure there's a space between the end of the last existing argument and the dash of this one.
4. Click Apply then click OK.

...

1. Navigate the project tree to src/main/java and double-click on HomeController.java to open it.

2. Copy this in the file (including the last bracket):

   Code Block

   package org.test.test; import java.text.DateFormat; import java.util.Date; import java.util.Locale; import org.LexGrid.LexBIG.DataModel.InterfaceElements.CodingSchemeRendering; import org.LexGrid.LexBIG.Exceptions.LBInvocationException; import org.LexGrid.LexBIG.Impl.LexBIGServiceImpl; import org.LexGrid.LexBIG.LexBIGService.LexBIGService; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import org.springframework.stereotype.Controller; import org.springframework.ui.Model; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RequestMethod; /** * Handles requests for the application home page. */ @Controller public class HomeController { private static final Logger logger = LoggerFactory.getLogger(HomeController.class); /** * Simply selects the home view to render by returning its name. * @throws LBInvocationException */ @RequestMapping(value = "/", method = RequestMethod.GET) public String home(Locale locale, Model model) throws LBInvocationException { logger.info("Welcome home! the client locale is "+ locale.toString()); Date date = new Date(); DateFormat dateFormat = DateFormat.getDateTimeInstance(DateFormat.LONG, DateFormat.LONG, locale); String formattedDate = dateFormat.format(date); model.addAttribute("serverTime", formattedDate ); Integer n = 1; LexBIGService lbSvc = LexBIGServiceImpl.defaultInstance(); for(CodingSchemeRendering csr : lbSvc.getSupportedCodingSchemes().getCodingSchemeRendering()){ System.out.println(csr.getCodingSchemeSummary().getFormalName()); model.addAttribute("term"+n.toString(), csr.getCodingSchemeSummary().getFormalName()); n++; } return "home"; } }

3. Make sure to change the package name if you didn't use org.test.test initially. Save the file.

...

1. In the Package Explorer, nagivate to src/main/webapp/WEB-INF/views and open home.jsp by double-clicking.

2. Replace the text in the file with this one:

   Code Block
   <%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c" %> <%@ page session="false" %> <html> <head> <title>Home</title> </head> <body> <h1> Hello world! </h1> <p>The time on the server is ${serverTime}.</p> <p>One of the active terminologies on the LexEVS server is: ${term1}</p> </body> </html>

3. Save the file and close it.

...

This guide was contributed by the TRANSFoRM group

...