Web Services

Setting up Opal On Win32

1. Required software
   1. Java 1.5 (jdk-1_5_0_09-windows-i586-p.exe)
      • Just install
   2. Apache [ANT] (apache-ant-1.6.5-bin.zip)
      • Extract into Program Files directory.

   3. Axis (axis-1_2_1.zip) I don’t think we really need this…

   4. Tomcat (jakarta-tomcat-5_0_30.zip)
      • Extract into Program files directory
   5. Opal (opal-ws-1.0RC1.zip)
2. Environment variables
   • ANT_HOME=C:\Program Files\apache-ant-1.6.5
   • CATALINA_HOME=C:\Program Files\jakarta-tomcat-5_0_30
   • JAVA_HOME=C:\Program Files\Java\jdk1.5.0_09
   • PATH=$PATH;C:\Program Files\apache-ant-1.6.5\bin
3. Testing environment

   • >ant

   • >java

4. Set up Opal
   • cd to opal directory
   • ant -f build-opal.xml compile
   • Leave this shell open for a couple of steps
5. Test setup (taken from Sriram’s powerpoint slide. I think this step is optional)
   • Copy “axis” directory inside “axis-1_2_1\webapps” into “%CATALINA_HOME%\webapps”.
   • Copy “activation-1_0_2.jar” and “mailapi-1_3_1.jar” from “opal-ws-1.0RC1\lib” into “%CATALINA_HOME%\common\lib”
   • Start Tomcat from the command prompt
     • Type “cd %CATALINA_HOME%\bin”
     • Type “startup.bat”
   • Test the Axis deployment

     • http://localhost:8080/axis/happyaxis.jsp

     • Watch for error messages, warnings are OK
6. Opal configuration

   • In opal-ws-1.0RC1\etc\opal.properties change tomcat.url by replacing localhost with the the IP address of your machine

   • In opal-ws-1.0RC1\etc create test_config.xml like this:

     • <appConfig xmlns="http://nbcr.sdsc.edu/opal/types"
                  xmlns:xsd="http://www.w3.org/2001/XMLSchema">
         <metadata>
           <usage><![CDATA[./build_ep_dynamic <filename>]]></usage>
         </metadata>
         <binaryLocation>C:\Docume~1\Fred\Desktop\continuity_svn\pcty\sourceTools\build_EP_dynamic\build_EP_dynamic.bat</binaryLocation>
         <parallel>false</parallel>
       </appConfig>
       

7. Deploying webservice
   • On the command prompt, cd to your Opal installation

     • > ant -f build-opal.xml deploy -DserviceName=TestServicePort -DappConfig=etc\test_config.xml

     • Note: You must be running tomcat during this step.

   • Restart tomcat

   • Check http://localhost:8080/axis/services

8. Running client
   • cd to your Opal installation

   • Set classpath by typing classpath.bat

   • java edu.sdsc.nbcr.opal.GenericServiceClient -l http://localhost:8080/axis/services/TestServicePort -a “ode_model.f” -f ode_model.f

Creating python client

1. Instructions can be found here

2. Notes:
   • You need ZSI 1.7 (2.0 doesn’t seem to work)

   • AppService_services.py and AppService_services_types.py must be placed with your python client. Then you can throw out everything but _xmlplus, ZSI, and of course your python webservice client.

Starting Tomcat On Lys

1. cd /opt/webservices/jakarta-tomcat-5_0_30/bin
2. ./startup.sh
3. su; iptables -I RH-Firewall-1-INPUT -p tcp –dport 8080 -m state –state NEW -j ACCEPT