Apache-SOAP Version 2.3: Installing the Server-Side Under JRun 3.0

IMPORTANT: JRun comes with an XML parser, which will by default hide Xerces and therefore cause problems with your SOAP installation. Please follow step 1 below!

  1. Open up JRun's global.properties file (in path-to-JRun/lib) and add the Xerces .jar file to the beginning of the jrun.classpath line. Mine looks like this:
    jrun.classpath=E:/xerces-1_2_3/xerces.jar;{jrun.rootdir}/lib/ext;{jrun.rootdir}/lib/jrun.jar;{jrun.rootdir}/lib/install.jar
  2. Go into the JMC, and select the "Web Applications" section of your server (I use the JRun Default Server). Click on "deploy an application".

  3. Select the Apache-SOAP /webapps/soap directory (under java/ in the source distribution, or off the root directory of the binary dist.) in the "Servlet War File or Directory" box.

  4. Name the application (I call it "xml-soap"), and pick a base URL (I use "/soap")

  5. Select a deploy directory (I use the default, which is JRun's default server directory, plus the name of the app, so for me it ends up being C:/JRun/servers/default/xml-soap

  6. Click "deploy"
    (at this point you should get a message telling you the app has been successfully deployed)

  7. Go to the "java settings" area of your default server, and add the Apache-SOAP jar file and base directory to the classpath. For the source distribution, these would be SOAPROOT/java/build/lib/soap.jar and SOAPROOT/java/build. For the binary distribution, they would be SOAPROOT/lib/soap.jar and SOAPROOT. Mine looks like this (source dist, living at D:/xml-soap):
    {jrun.rootdir}/servers/lib
{jrun.server.rootdir}/lib
D:/xml-soap/java/build/lib/soap.jar
D:/xml-soap/java/build
  8. Restart the server. NOTE: You must shut down and restart BOTH the admin server and the default server for the change you made to the global.properties file to take. That only needs to be done once.

  9. Try it out - access http://localhost/soap/servlet/rpcrouter and see if you get the "I can't do GET" message.
If the above worked, you know the servlet was succesfully installed. You should now be able to deploy services by pointing your browser at:
http://localhost/soap/index.html

Happy SOAP-ing!