Return-Path: 
 <scm-return-6673-apmail-geronimo-scm-archive=geronimo.apache.org@geronimo.apache.org>
Delivered-To: apmail-geronimo-scm-archive@www.apache.org
Received: (qmail 31017 invoked from network); 6 May 2005 21:14:45 -0000
Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199)
  by minotaur.apache.org with SMTP; 6 May 2005 21:14:45 -0000
Received: (qmail 84671 invoked by uid 500); 6 May 2005 21:17:32 -0000
Delivered-To: apmail-geronimo-scm-archive@geronimo.apache.org
Received: (qmail 84647 invoked by uid 500); 6 May 2005 21:17:32 -0000
Mailing-List: contact scm-help@geronimo.apache.org; run by ezmlm
Precedence: bulk
list-help: <mailto:scm-help@geronimo.apache.org>
list-unsubscribe: <mailto:scm-unsubscribe@geronimo.apache.org>
List-Post: <mailto:scm@geronimo.apache.org>
Reply-To: dev@geronimo.apache.org
Delivered-To: mailing list scm@geronimo.apache.org
Received: (qmail 84629 invoked by uid 99); 6 May 2005 21:17:31 -0000
X-ASF-Spam-Status: No, hits=0.0 required=10.0
	tests=
X-Spam-Check-By: apache.org
Received: from ajax-1.apache.org (HELO ajax.apache.org) (192.87.106.226)
  by apache.org (qpsmtpd/0.28) with ESMTP; Fri, 06 May 2005 14:17:31 -0700
Received: from ajax.apache.org (ajax.apache.org [127.0.0.1])
	by ajax.apache.org (Postfix) with ESMTP id 3434E19F
	for <scm@geronimo.apache.org>; Fri,  6 May 2005 23:14:40 +0200 (CEST)
Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
From: Apache Wiki <wikidiffs@apache.org>
To: scm@geronimo.apache.org
Date: Fri, 06 May 2005 21:14:39 -0000
Message-ID: <20050506211439.4278.49584@ajax.apache.org>
Subject: [Geronimo Wiki] Update of "Tomcat" by jgenender
X-Virus-Checked: Checked
X-Spam-Rating: minotaur.apache.org 1.6.2 0/1000/N

Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Geronimo Wiki" for change notification.

The following page has been changed by jgenender:
http://wiki.apache.org/geronimo/Tomcat

------------------------------------------------------------------------------
  
  = The geronimo-tomcat.xml =
  
- The geronimo-tomcat.xml file is the equivalent of the Tomcat context.xml file.  It allows you to configure specific configurations on a web application by web application basis. It is in this file you will be able to describe the context-root, attach application specific valves and realms, and declare your security mapping.
+ The geronimo-tomcat.xml file is the equivalent of the Tomcat context.xml file.  It allows you to configure specific set-up parameters on a web application by web application basis. It is in this file you will be able to describe the context-root, attach application specific valves and realms, and declare your security mapping.  The Geronimo deployer can deploy with this file internally to the web application, or externally.  For the sake of this section, we will concentrate on an internal configuration.  The geronimo-tomcat.xml is very similar to the geronimo-jetty.xml with a couple of minor enhancements, and this file will normally reside in your war file's WEB-INF directory.
  
- TODO: Explain the geronimo-tomcat.xml
+ The geronimo-tomcat.xml allows you to configure specific attributes regarding your specifc web application.  You may set the context-root, class loader priority, the Tomcat Realm object, the tomcat-valve-chain, security role mappings, resource naming references, and configure Gbeans.
+ 
+ The following is an example geronimo-tomcat.xml file:
+ {{{
+ <web-app
+     xmlns="http://geronimo.apache.org/xml/ns/web/tomcat"
+     xmlns:sec="http://geronimo.apache.org/xml/ns/security"
+     configId="org/apache/geronimo/test">
+ 
+     <context-root>/test</context-root>
+     <context-priority-classloader>false</context-priority-classloader>
+     <virtual-server>www.myexamplehost.com</virtual-server>
+     <tomcat-realm>TomcatJACCRealm</tomcat-realm>
+     <tomcat-valve-chain>FirstValve</tomcat-valve-chain>
+ 
+     <security-realm-name>Geronimo</security-realm-name>
+     <security>
+         <default-principal realm-name="tomcat-properties-realm">
+             <principal class="org.apache.geronimo.security.realm.providers.GeronimoUserPrincipal" name="metro"/>
+         </default-principal>
+     </security>
+ 
+     <gbean name="TomcatJACCRealm" class="org.apache.geronimo.tomcat.RealmGBean">
+         <attribute name="className">org.apache.geronimo.tomcat.realm.TomcatGeronimoRealm</attribute>
+         <attribute name="initParams">
+             userClassNames=org.apache.geronimo.security.realm.providers.GeronimoUserPrincipal
+             roleClassNames=org.apache.geronimo.security.realm.providers.GeronimoGroupPrincipal
+         </attribute>
+     </gbean>
+ 
+     <gbean name="FirstValve" class="org.apache.geronimo.tomcat.ValveGBean">
+         <attribute name="className">org.apache.catalina.authenticator.SingleSignOn</attribute>
+         <reference name="NextValve"><moduleType>J2EEModule</moduleType><name>SecondValve</name></reference>
+     </gbean>
+ 
+     <gbean name="SecondValve" class="org.apache.geronimo.tomcat.ValveGBean">
+         <attribute name="className">org.apache.catalina.valves.AccessLogValve</attribute>
+         <attribute name="initParams">
+             prefix=localhost_access_log.
+             suffix=.txt
+             pattern=common
+         </attribute>
+     </gbean>
+ </web-app>
+ }}}
+ 
+ In this particular file, we have configured a web application that responds to a URL context of /test and only for the virtual host www.myexamplehost.com.  It has set up a simple security mapping that uses the tomcat-properties-realm (which is declared in the included j2ee-server-tomcat-plan.xml that came with the Geronimo source).  Declaring this security configuration also assumes we will be using JACC, so we have created the TomcatGeronimoRealm Gbean and added the reference to the {{{<tomcat-realm>}}} parameter.  We are also using some valves that are specific to this context, so we have created the {{{FirstValve}}} and {{{SecondValve}}} Gbeans as a chain, and set set the {{{<tomvat-valve-chain>}}} to the fir first valve in the chain ({{{FirstValve}}}).
+ 
+ TODO: Explain more on the parameters here...
  
  = Status =