Name: Corina Java Webservice

Author: Rahim Lila

Version: 2.0

Created: 07/2003

Modified: 08/2007 - updated components; did not test.

Purpose: This example demonstrates how to SOAP wrap Corina and integrate it in Pipeline Pilot.

Requirements: Chemistry Collection, Java SDK 1.4.1 or higher, Apache Tomcat 4.1 or higher, CORINA 2.64 or higher

Limitations: This component has not been tested with PP 6.1

Keyword: Corina, SOAP, webservice

Contents:
CORINA SOAP.xml,
CORINA_Deploy_Descriptor.wsdd,
CORINA_Undeploy_Descriptor.wsdd,
Deploy_CORINA_to_AXIS,
Deploy_CORINA_to_AXIS.sh,
src\com\scitegic\webservices\CORINA.java,
lib\axis.jar,
lib\axis-ant.jar,
lib\commons-discovery,
lib\commons-logging,
lib\jaxrpc,
lib\log4j-1.2.8,
lib\saaj,
lib\wsdl4j

Installation:
1. This web service needs to be setup on the same machine where the CORINA executable exists. Move this folder (CORINA Web Service folder) to that machine.

2. Install CORINA software according to manufacturer instructions.

3. Install Apache TOMCAT Web server With Apache AXIS SOAP engine.  See Pipeline Pilot Online Help, under Administration Guide-->SOAP Servers-->JAVA, for detailed instructions.

4. Verify AXIS and TOMCAT are properly configured by navigating to http://localhost:8080/axis/happyaxis.jsp . Make sure ALL "Needed Components" are present and working before going any further.

5. Do not proceed any further unless steps 1-3 have all been successfully completed.

6. This SOAP Wrapper needs to know where CORINA is located on your file-system and also needs a  location to write temp files. One needs to manually edit 2 lines of code to provide this critical  information. Find the section, below, in the CORINA.java (in the sub folder src\com\scitegic\webservices\) file and edit corinaPath and workingDir variables appropriatly. Save the changes when finished.

See below:

//Set the following two properties to meet your setup/config
File corinaPath = new File("/home/scitegic/corina/corina.lnx");
File workingDir = new File("/home/scitegic/temp");

7. Compile CORINA.java at command-line( using the command "javac CORINA.java" ). If the compiler outputs errors, look at the errors displayed and resolve by editing source in CORINA.java. Otherwise continue by copying  the compiled package(com) into the folder TOMCAT_HOME\webapps\axis\WEB-INF\classes.

8. To registar the CORINA web service into AXIS, execute 'Deploy_CORINA_to_AXIS.bat' (for UNIX execute 'Deploy_CORINA_to_AXIS.sh'). This should be done while tomcat is still running. Verify that the CORINA service has been properly registared by
by opening 'http://localhost:8080/axis/servlet/AxisServlet' in a browser. This page will list all the web services registared in your AXIS instance.

9. Drag 'CORINA SOAP.xml' into your Pipeline Pilot client.

10. Then make sure that the SOAP endpoint CORINA SOAP component, in the protocol, is pointing to your SOAP server.

See below:
change from : http://localhost:8080/axis/services/CORINA
change to: http://mySOAPServerName:8080/axis/services/CORINA

11. Everything should be in place.....just Run the protocol.