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
  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"
            <usage><![CDATA[./build_ep_dynamic <filename>]]></usage>

  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

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