Action :
tom.udbrsc (Category :
tom, Name :
udbrsc, By :
kikonf)
Complete Name :
tom.udbrsc.by.kikonf
Version :
5.5 License :
Modified BSD License
Purpose of the tom category :
Easy to customize. This category use in background the Kikonf Repoz tools to create and configure
Apache Tomcat ®
root installs and
Catalina bases at any level (
server.xml,
hosts or
defaults).
You can use it to manage the whole
Tomcat ® Architecture.
Purpose of this udbrsc plugin : This Action configures a Tomcat User Database Resource.
The following shows in what part of a typical Architecture is likely to be found, the Resource configured by Action : tom.udbrsc
This Action configures a Tomcat User Database Resource.
UserDatabase resources are typically configured as global resources for use by a UserDatabase
realm.
A UserDatabase resources is a kind of DataSource but based on an xml file rather than a realtional Database.
Notice :
--------
This documentation contains excerpts from the Tomcat official site http://tomcat.apache.org, jndi-resources-howto.html
This documentation IS NOT the official documentation.
For the offical Tomcat doecumentation please refer to the previous Tomcat official site (http://tomcat.apache.org).
The resource factory will create a new instance for every lookup on it.
1. TOMCAT JNDI RESOURCES NAMESPACES
The following is a general rule for all for all the JNDI Resources configured inside Tomcat >= 5.
JNDI Resources can de declared at the global level or at the context level.
Tomcat 5 maintains a separate namespace of global resources for the entire server.
These are configured in the <GlobalNamingResources> element of $CATALINA_BASE/conf/server.xml.
You may expose these resources to web applications by using a <ResourceLink> to include it in the per-web-application context.
Converted into the Kikonf scheme the previous stanza means that the scope for a JNDI Resource is either :
_ Global using scope resources.global : true
or
_ Local using scope context (and/or an affiliated : context.global, default_context.global, default_context)
Note:
-----
When the Global Scope is requested for an Action setting resources.global to "true" into the Action file.
The use of context (and/or an affiliated : context.global, default_context.global, default_context) is allowed.
In this case the resource is declared at the Global level.
But a ResourceLink is also created for the provided context Scope.
This is the reason why, all the Kikonf Actions for Tomcat JNDI Resources alWays support a "link" tag.
2. USING USER DATABASE RESOURCE WITH TOMCAT
The following is a short tutorial about how to use a User Database Resource with Tomcat.
Tomcat includes a UserDatabaseFactoory that creates UserDatabase resources backed by
an XML file - usually tomcat-users.xml at CATALINA_HOME/conf/tomcat-users.xml.
e.g.:
<?xml version='1.0' encoding='utf-8'?>
<tomcat-users>
<role rolename="tomcat"/>
<role rolename="role1"/>
<user username="tomcat" password="tomcat" roles="tomcat"/>
<user username="both" password="tomcat" roles="tomcat,role1"/>
<user username="role1" password="tomcat" roles="role1"/>
</tomcat-users>
Trademarks :
- "Apache", "Apache Tomcat" and "Tomcat" are trademarks of the Apache Software Foundation.
- "Java" and "JVM" are a registred trademarks of Oracle and/or its affiliates.
- Other names may be trademarks of their respective owners.
