W E B   S E R V I C E S  

Configuring Tomcat 

In this section we ll discuss configuration issues specific to the JBoss/Tomcat 4.x integration 

bundle. The Tomcat 4.x release, which is also known by the name Catalina, is the latest 

Apache Java servlet container. It supports the Servlet 2.3 and JSP 1.2 specifications. The 

JBoss/Tomcat integration layer is controlled by the JBoss MBean service configuration. The 

MBean used to embed the Tomcat 4.x series of web containers is the 

org.jboss.web.catalina.EmbeddedCatalinaServiceSX service, and it is a subclass of the 

AbstractWebContainer class. Its configurable attributes include: 

CatalinaHome, sets the value to use for the catalina.home System property. This is 

used to . If not specified this will be determined based on the location of the jar 

containing the org.apache.catalina.startup.Embedded class assuming a standard 

catalina distribution structure. 

CatalinaBase, sets the value to use for the catalina.base System property. This is 

used to resolve relative paths. If not specified the CatalinaHome attribute value will 

be used. 

Java2ClassLoadingCompliance, enables the standard Java2 parent delegation 

class loading model rather than the servlet 2.3 load from war first model. This is true 

by default as loading from wars that include client jars with classes used by EJBs 

causes class loading conflicts. If you enable the servlet 2.3 class loading model by 

setting this flag to false, you will need to organize your deployment package to avoid 

duplicate classes in the deployment. 

Config, an attribute that provides support for extended configuration using 

constructs from the standard Tomcat server.xml file to specify additional connectors, 

and so on. Note that this is the only mechanism for configuring the embedded Tomcat 

servlet container as none of the Tomcat configuration files such as the conf/server.xml 

file are used. An outline of the configuration DTD that is currently supported is given 

in Figure 13 1, and the elements are described in the following section. 

120