This is an XML Schema Definition for Geronimo tomcat web application
deployment plan. In case the web application deployment plan is
provided internally in the web archive, it should be named
META-INF/geronimo-web.xml. In case the web application deployment
plan is provided externally, the deployment descriptor can be named
anything and provided to the deploy tool. Alternatively, it can be
included in the EAR and referenced by an alt-dd element of the EAR
deployment plan. All the web application deployment plan must
specify the top level element as web-app with namespace specified as
xmlns="http://geronimo.apache.org/xml/ns/j2ee/tomcat-1.2". The
default location for this document is
http://geronimo.apache.org/schemas-1.2/geronimo-tomcat-2.0.xsd
Import partial schema containing common naming elements, the
imported plan declares elements like ejb-ref, ejb-local-ref,
service-ref, resource-ref, and resource-env-ref required by this
plan schema.
Import Geronimo application deployment plans. The imported plan
includes abstract complex types security required by this plan
schema.
Import Geronimo Services deployment plans. The imported plan
includes complex types like moduleType, environmentType,
dependenciesType, etc. required by this plan schema.
The web-app element is the root of the deployment descriptor for
a Geronimo tomcat web application. Note that the sub-elements of
this element should be as in the given order in a sequence.
Reference to environment element defined in imported
"geronimo-module-1.2.xsd"
This is the first part of the URL used to access the web
application. For example context-root of "Sample-App"
will have URL of http://host:port/Sample-App" and a
context-root of "/" would make this the default web
application to the server.
If the web application is packaged as an EAR that can
use application context in the "application.xml". This
element is necessary unless you want context root to
default to the WAR name.
This is the work directory that will be used by this
application. The directory location will be relative
to "catalina.home".
Reference to abstract clustering element defined in
imported "geronimo-application-2.0.xsd"
Reference to web-container element defined in imported
"geronimo-naming-1.2.xsd"
The host element maps the web application to this
particular host name.
The cross-context is an indicative element to specify
that the web application will use dispatch request to
other applications and this cross context should be
enabled.
The presence of disable-cookies element indicates the
cookies will not be used by tomcat web application and
should be disabled.
The valve-chain provides the list of first element
tomcat valves chain for this web application.
The listener-chain provides the list of first element
tomcat lifecycle listener chain for this web application.
The tomcat-realm provides the tomcat security realm used
by this web application.
The manager provides the clustering implementation used
by this web application.
The cluster provides the name of cluster this web
application belongs to.
Reference to jndiEnvironmentRefsGroup group defined in
imported "geronimo-naming-1.2.xsd"
Reference to message-destination element defined in
imported "geronimo-naming-1.2.xsd"
The security-realm-name element provides the name of
security realm that will be used by JAAS
authentication. The name should match the your
security realm GBean.
Reference to security element defined in imported
"geronimo-security-2.0.xsd"
Reference to abstract service element defined in imported
"geronimo-module-1.2.xsd"