6 - Installing LexEVS 6.x Grid Services

1. Download the latest version of the LexEVS Analytical or Data Services ZIP file from the right. You have a choice between ZIP 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.

2. Unzip the file or files you have downloaded to SAVE_DIRECTORY.

For example extract Data Services to:

C:\scratch\LexEVS 6.0 Analytical Services\wsrf.war

and

C:\scratch\LexEVS 6.0 Data Services\wsrf.war

3. Shut down your application or servlet container. This presumes that you have already installed a web server as outlined in the Supported Software. 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:

    shutdown.bat -S
    

  • Unix:

    ./shutdown.sh -S
    

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

4. Create a directory for the web archive.
Create a directory called wsrf.war inside this directory:

{WEB_SERVER_HOME}\{DEPLOYMENT_HOME}

..where WEB_SERVER_HOME is your application server home directory.
DEPLOYMENT_HOME is the Web Archive deployment directory for your application server.

• JBoss example:

  • Windows:

    c:\jboss-5.1.0.GA\server\default\deploy
    

  • Unix:

    /jboss-5.1.0.GA/server/default/deploy
    

• For example:

  • Windows:

    mkdir wsrf.war
    

  • Unix:

    mkdir wsrf.war
    

5. Unzip the wsrf.war file to the wsrf.war directory.

• JBoss example:
  • Windows:
    From: c:\scratch\wsrf.war
    To: c:\jboss-5.1.0.GA\server\default\deploy\wsrf.war
  • Unix:
    From: /scratch/wsrf.war
    To: /jboss-5.1.0.GA/server/default/deploy\wsrf.war
    Windows does not see WAR files as compressed files, therefore you must obtain an unzip utility such as 7-zip or WinZip. In Unix you should be able to use the unzip command.

1. Download LexEVS_60_client.zip from the right. This is from the client for a Distributed install. Note:Third party dependencies are not required for this installation process.

LexEVS Distributed ClientEnables Java programs to establish a connection to an already-deployed LexEVS Distributed node.LexEVS_60_client.zip LexEVS Distributed Client 3rd Party dependenciesContains all the code required by the LexEVS Distributed Client.lexevsapi60-client-dependencies.zip

2. Unzip LexEVS_60_client.zip to the SAVE_DIRECTORY.

3. Copy the application-config-client.xml file out of the unzipped client and into the deployed wsrf.war directory structure.

copy {SAVE_DIRECTORY}\LexEVS_60_client\conf\application-config-client.xml {WEB_SERVER_HOME}\{DEPLOYMENT_HOME}\wsrf.war\WEB-INF\classes

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

• Windows:

  copy  c:\scratch\LexEVS_61_Remote\conf\application-config-client.xml  c:\jboss-5.1.0.GA\server\default\deploy\wsrf.war\WEB-INF\classes
  

• Unix:

  copy  /scratch/LexEVS_61_Remote/conf/application-config-client.xml  c:/jboss-5.1.0.GA/server/default/deploy/wsrf.war/WEB-INF/classes
  

  Note

  If you are repeating these steps for the other services WAR file then it will have its own separateapplication-config-client.xmlfile that will be similarly placed in the WEB-INF/classes folder of the exploded WAR file.

4. Edit the application-config-client.xml file. There are three lines where you need to have the proper URL as a value. The three lines are found:

1. In the EvsServiceInfo bean with this text <entry key="APPLICATION_SERVICE_URL"
2. In the AppService bean with this text <property name="serviceUrl"

3. (OPTIONAL) in the EvsAuthenticationProviderbean with this text {{<property name="serviceUrl"}}The values each have a URL like this:

   http://{SERVER_ADDRESS}/{WAR_FILE_DEPLOYED}/...
   

   For each you must change the SERVER_ADDRESS and WAR_FILE_DEPLOYED only where {{SERVER_ADDRESS} is the address of your server (domain and optionally the port number).
   WAR_FILE_DEPLOYED is the name of the WAR file you placed in the server directories for deployment.
   Example lines for the file:

4. <entry key="APPLICATION_SERVICE_URL" value="http://localhost:8080/lexevsapi61/http/applicationService"/>
5. <property name="serviceUrl" value="http://localhost:8080/lexevsapi61/http/applicationService"/>
6. <property name="serviceUrl" value="http://localhost:8080/lexevsapi61/http/applicationService"/>

1. Start your application or servlet container if it is not already started. The start command will be web server specific. See the documentation for your web server for information on how to do this.JBoss example:

• Windows:

  Run.bat \-c default
  

• Unix:

  ./Run.sh \-c default
  

2. Verify the installation by opening a browser to either:

http://{SERVER_ADDRESS}/wsrf/services/cagrid/LexEVSDataService

or

http://{SERVER_ADDRESS}/wsrf/services/cagrid/LexEVSGridService

...where SERVER_ADDRESS is the address of your server (domain and optionally the port number)
For example:

http://localhost:8080/wsrf/services/cagrid/LexEVSDataService

or

http://localhost:8080/wsrf/services/cagrid/LexEVSGridService

If you are using localhost then your browser must be running on the same server as LexEVS.