Date: 2004-12-16T12:37:19 Editor: JacekLaskowski <[EMAIL PROTECTED]> Wiki: Apache Geronimo Wiki Page: Tomcat URL: http://wiki.apache.org/geronimo/Tomcat
Update (no java.endorsed.dirs is required) Change Log: ------------------------------------------------------------------------------ @@ -6,13 +6,15 @@ Check [http://nagoya.apache.org/jira/secure/IssueNavigator.jspa?reset=true&mode=hide&pid=10220&sorter/order=DESC&sorter/field=priority&component=11397 Geronimo JIRA issue tracker] and the page for more information about the integration. -Currently the work is being done to create a complete Tomcat deployer (aka builder) based on the jetty-builder module. The very rough yet working deployer is already done - !TomcatModuleBuilder. +Currently the work is being done to create a complete Tomcat deployer (aka builder) based on the jetty-builder module. The very rough yet working deployer is already done - !TomcatModuleBuilder. The idea behind the builder is to create one builder that manages Jetty, Tomcat or any other web container's deployment. It looks that the code of !TomcatModuleBuilder is pretty much the same as !JettyModuleBuilder, so it's probably a matter of weeks when they come together to build the builder. The version of Apache Tomcat is 5.5.4. = How to run Apache Tomcat = -By default, Geronimo is set up with Jetty as the web deployer (!JettyModuleBuilder). When a webapp is deployed using !JettyModuleBuilder it will reference Jetty as a web container. A module builder chooses what container the webapp will be deployed to. To enable Apache Tomcat as a web container, it's necessary to enable !TomcatModuleBuilder (which will assign Apache Tomcat to the deployed webapps). Uncomment the sections marked: +By default, Geronimo is set up with Jetty as the web deployer (!JettyModuleBuilder). When a webapp is deployed using !JettyModuleBuilder it will reference Jetty as a web container (in other, more technical, words - the plan contains a reference to !JettyContainer). A module builder chooses what container the webapp will be deployed to. To enable Apache Tomcat as a web container, it's necessary to enable !TomcatModuleBuilder (which will assign Apache Tomcat to the deployed webapps). Although at the end two web containers are run (Jetty listens to 8080 whereas Tomcat to 8090), but it's not yet simple to deploy some webapps using !TomcatModuleBuilder and some using !JettyModuleBuilder. + +In order to deploy webapps to Apache Tomcat, uncomment the sections marked: {{{ <!-- @@ -24,14 +26,14 @@ in ''modules/assembly/src/plan/j2ee-deployer-plan.xml'' -Once it's done, rebuild the assembly module and start up Geronimo as follows (see ["Running"]): +Once it's done, rebuild the assembly module, delete Xerces 2.6.0 jars (xercesImpl-2.6.0.jar and xmlParserAPIs-2.2.1.jar) from lib directory of Geronimo build, and start up Geronimo as follows (see ["Running"]): - {{{java -Djava.endorsed.dirs=c:\apps\jakarta-tomcat\common\endorsed -jar bin/server.jar <configuration_id> + {{{java -jar bin/server.jar org/apache/geronimo/Tomcat }}} -'''NOTE''': ''java.endorsed.dirs'' Java property must be specified on the command line as otherwise Tomcat won't be able to find Xerces classes and refuses to deploy web applications. So, before running a Tomcat instance within Geronimo the compat libraries of Tomcat (jakarta-tomcat-compat-5.5.4.*) will have to be installed. Does anyone know how to work it out? +'''NOTE''': Without removing Xerces 2.6.0 jars from lib it won't start up correctly. -'''NOTE''': CATALINA_HOME environment variable is required to run Tomcat. It's set to ''var/catalina/'' via the j2ee-server-tomcat-plan.xml +'''NOTE''': CATALINA_HOME environment variable is required to run Tomcat. It's set to ''var/catalina/'' via the GBean attribute ''catalinaHome'' in j2ee-server-tomcat-plan.xml '''NOTE''': Default HTTP connector listens to 8090 port (it's possible to change it via the j2ee-server-tomcat-plan.xml) @@ -40,7 +42,7 @@ A simple start-up of Geronimo with Apache Tomcat and the !DebugConsole webapp: {{{ -$ java -Djava.endorsed.dirs=c\:/apps/jakarta-tomcat/common/endorsed -jar bin/server.jar org/apache/geronimo/DebugConsole +$ java -jar bin/server.jar org/apache/geronimo/DebugConsole 20:15:37,532 INFO [Daemon] Server startup begun 20:15:37,612 INFO [Kernel] Starting boot 20:15:37,842 INFO [Kernel] Booted
