Configuring the Servlet Container

Link To

Toggle Frames

Print

Feedback

Configuring the Servlet Container

Overview

Before you can deploy a FUSE Services Framework endpoint to your servlet container you must make the FUSE Services Framework runtime libraries available to the container. There are two ways to accomplish this:

Add the required libraries to the container's shared library folder
This approach has the advantage of keeping individual WAR files small. It also ensures that all of the FUSE Services Framework servlets are using the same version of the libraries.
Add the required libraries to each application's WAR file
This approach has the advantage of flexibility. Each WAR can contain the versions of the libraries it requires.

Required libraries

FUSE Services Framework endpoints require all of the JAR files in the InstallDir/lib directory except the following:

servlet-api*.jar
geronimo-servlet_*.jar
jetty-*.jar

	Tip
	The `InstallDir/modules` folder contains the FUSE Services Framework libraries broken into component JAR files. Using these component jars can shrink the amount of code that needs to be imported into the servlet environment. However, using the component JAR files requires knowing exactly which FUSE Services Framework components are in use.

Automating servlet container configuration

The FUSE Services Framework samples directory, InstallDir/samples, includes a common_build.xml file that contains utilities that automates the configuration of the servlet environment.

One utility is the copy-war-libs Ant target. It copies the required libraries to the folder specified in the war-lib. For example, to install the required libraries into a Tomcat 6 installation enter ant copy-war-libs -Dwar-lib=CATALINA_HOME\lib.

The other utility is the cxfwar macro. The macro is used to build the WAR files for all of the FUSE Services Framework samples. Its default result is to make a WAR containing all of the required libraries. This behavior can be changed by setting the without.libs property to true.