Getting Started Guide
=====================

The Dynamic Service Provider project provides the means to deploy a web service, based on
a WSDL definition, and route requests received on the resulting service to a service provider
implementation.

This capability is used within RiftSaw to create a web service dynamically, based on a
deployed BPEL process (and accompanying WSDL), and to route web service requests to the 
process running in a BPEL engine.


Installation Instructions
-------------------------

Installing on JBoss Application Server:

The JBoss Application Server does not require any special pre-configuration. The dynamic service
provider capability can be embedded into any other deployable module, as demonstrated by the
$DSP/samples/example-deployer example.



Installing on Apache Tomcat:

Step 1 - Download and unpack the JAXWS Reference Implementation

The reference implementation can be found at: http://jax-ws.java.net/. Version 2.2.1 has been used for testing.

Step 2 - Setup the environment

Set JAXWS_HOME to the JAXWS Reference Implementation installation folder.
Set CATALINA_HOME to the Apache Tomcat folder.

Step 3 - Install JAXWS into Tomcat

Open a command window and change to the JAXWS-RI root folder (JAXWS_HOME). Then run:

	ant install-api

Step 4 - Copy libraries into Tomcat

Copy all of the jars from $JAXWS_HOME/lib to $CATALINA_HOME/endorsed (folder created as part of "ant install-api").

Copy $CATALINA_HOME/lib/servlet-api.jar to $CATALINA_HOME/endorsed

Install $DSP/lib/commons-logging-1.1.1.jar into $CATALINA_HOME/lib

Install $DSP/samples/example-deployer/deployer/resources/WEB-INF/lib/wsdl4j-1.6.2.jar into $CATALINA_HOME/lib

Install $DSP/lib/dsp-api-<version>.jar into $CATALINA_HOME/lib


The environment is now configured to be able to create a deployer (e.g. as a webapp), such as demonstrated
by the $DSP/samples/example-deployer.

