Setting up SOAP --------------- 1. You now need to download the SOAP package so we can use it with Tomcat. This can be found at http://ws.apache.org/soap/index.html The zip file contains some documentation and examples. In addition to this there is a 'soap.war' file located in the webapps directory of the zip archive. Without your Tomcat server running, copy the soap.war file to your webapps directory. eg. C:\Tomcat 5.5\webapps\ 2. Now you need to edit your server.xml file. This is a configuration file for Tomcat. The file is located in your conf directory of your tomcat installation eg. C:\Tomcat 5.5\conf Add the following lines to the Context section: <Context path="/soap" docBase="soap" debug="1" reloadable="true"> </Context> 3. In order for SOAP to run with Tomcat we need some additional libraries that are not in the standard Java SDK installation. Java Mail API is used when processing SOAP messages with attachments. 1. Download javamail from http://java.sun.com/products/javamail/ 2. Extract the archive and inside you will find a file called mail.jar 3. Copy this file to the \server\lib directory of your tomcat installation eg. C:\Tomcat 5.5\server\lib\ Java Beans provides methods for dealing with arbitrary data types. 1. Download java beans activation framework from http://java.sun.com/products/javabeans/glasgow/jaf.html 2. Extract the archive and inside you will find a file called activation.jar 3. Copy this file to the \server\lib directory of your tomcat installation eg. C:\Tomcat 5.5\server\lib\ In addition to this we now need to tell Tomcat where we put these files. To do this open the monitor Tomcat utility that came with the installation. 1. Click on the Java tab 2. Under Java Class Path add a direct link to these .jar files eg. C:\Program Files\Apache Software Foundation\Tomcat 5.5\bin\bootstrap.jar;C:\Program Files\Apache Software Foundation\Tomcat 5.5\server\lib\mail.jar;C:\Program Files\Apache Software Foundation\Tomcat 5.5\server\lib\activation.jar 3. Click Apply. 4. RESTART YOUR SYSTEM 5. Test your installation by going to http://localhost:8080/soap/servlet/rpcrouter You should see the following page displayed: SOAP RPC Router Sorry, I don't speak via HTTP GET- you have to use HTTP POST to talk to me.