Setting Up JWSDP 2 With Tomcat 6

Aim
To set up the Java Web Services Development Pack 2 (JWSDP2) and configure Tomcat. There are versions of tomcat that come pre-configured with JSWDP support for the container. These can be downloaded from the Sun site - but this means a fresh install. We will be using vanilla tomcat install from Apache. Leave any questions or problems as comments and I will endeavour to answer them. The JWSDP is an alternative to using Axis.

Assumption
This article assumes that you have the JDK 1.5 already installed. Also you have a working and compatible version of tomcat installed and running. Tomcat is using port 8080 for this tutorial.

Versions used in this example

Sofware/Component	Image
Windows XP SP2	N/A
JWSDP 2	jwsdp-2_0-windows-i586.exe
tomcat 6	apache-tomcat-6.0.18.zip
Java JDK 1.5.0	N/A

Links to these files can be found here.

Unzip/install JWSDP

• You may wish to take a copy of your tomcat's 'bin' directory as files here will get replaced.
• Download and install the jwsdp 2 (jwsdp-2_0-windows-i586.exe) make a note of the directory. 'C:\Sun\jwsdp-2.0' for this example. During the installation it will ask you whether you wish to download the tomcat conatiner - say no.
• Go to jwsdp-shared\bin directory in your jwsdp install.
• Edit the setenv.bat file. make sure all everything is pointing to the right places. This is what my environment looks like.
  

  set JAVA_HOME=D:\jdk1.5.0 set ANT_HOME=C:\Sun\jwsdp-2.0\apache-ant set ANT_OPTS=-Djava.endorsed.dirs=C:\Sun\jwsdp-2.0\jaxp\lib\endorsed;C:\Sun\jwsdp-2.0\jaxp\lib set JWSDP_HOME=C:\Sun\jwsdp-2.0 set CATALINA_HOME=C:\apache-tomcat-6.0.18

  
  
• If you are using tomcat 6 then edit the jwsdpontomcat.bat file and make the change given below. Should be around line 52. basically get rid of the 'server.'
  

  original	<available property="CATALINA_HOME" value="${catalina.home}" file="${catalina.home}/server/lib/catalina.jar" />
  modified	<available property="CATALINA_HOME" value="${catalina.home}" file="${catalina.home}/lib/catalina.jar" />

  Tomcat six has a slightly altered directory structure from previous versions.
• If you are using tomcat 6, edit jwsdpontomcat.xml and make the changes below. Should be round about line 43. Remove the 'server' from this line.
  

  original	<available property="CATALINA_HOME" value="${catalina.home}" file="${catalina.home}/server/lib/catalina.jar" />
  modified	<available property="CATALINA_HOME" value="${catalina.home}" file="${catalina.home}/lib/catalina.jar" />

  
  
• Open a command prompt and 'cd' to the jwsdp-shared\bin directory in your jwsdp install.
• Run setenv.bat.
• Run jwsdpontomcat.bat. This will basically run ant on the jwsdpontomcat.xml file. It will copy everyting required over to your tomcat directory. At the end you should get the usual 'BUILD SUCCESSFUL' message.
• Use a command prompt and cd into your tomcat bin directory. Your catalina.bat will now have been replaced with a new jwsdp version of if, have a look.
• Run startup.bat. This should fire up your bootloader. You should see a small window open up in the right bottom hand side of your screen. The LauncheBootstrap will read the launcher.xml from your jswdb-shared\bin directory under your tomcat directory.
• Go to your ./log directory under tomcat home and have a look at your 'launcher.server.log.' You may see a few ClassNotFound errors. Fix these by copying these files from your tomcat root directory to your tomcat lib directory.
  Tomcat
  _|_lib
  _|_saaj
  _|__|_lib
  _|__.__|_*.jar
  _|_jaxrpc
  _|__|_lib
  _|__.__|_*.jar
  _|_jwsdp-shared
  _|__|_lib
  _|__.__|_activation.jar
  _|_fastinfoset
  _|__|_lib
  _|__.__|_fastinfoset.jar
  _|_sjsxp
  _|__|_lib
  _.__.__|_*.jar
• Also note that you may need the mail.jar file for MultiPartMime related classes.
• Check your launcher.server.log again. All the errors should have disappeared and you are now done.

Test installation

• Go to http://127.0.0.1:8080/jaxrpc-HelloWorld/hello?WSDL. You should see an xml file.
• http://127.0.0.1:8080/saaj-book/

Back to the tutorial trail | Home