Apache-SOAP Version 2.2: 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!
- 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
- Go into the JMC, and select the "Web Applications" section of your server
(I use the JRun Default Server). Click on "deploy an application".
- 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.
- Name the application (I call it "xml-soap"), and pick a base URL (I use
"/soap")
- 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
- Click "deploy"
(at this point you should get a message telling you the app has been successfully deployed)
- 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
- 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.
- 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!