new tomcat

This commit is contained in:
aranganath 2005-05-17 16:50:28 +00:00
parent 879ecc62c4
commit c568828cb8
256 changed files with 19009 additions and 235 deletions

View file

@ -0,0 +1,174 @@
Apache Tomcat Version 5.5.9
Release Notes
$Id: RELEASE-NOTES.txt,v 1.1 2005/05/17 16:51:16 aranganath Exp $
=============================
KNOWN ISSUES IN THIS RELEASE:
=============================
* Dependency Changes
* JNI Based Applications
* Bundled APIs
* Web application reloading and static fields in shared libraries
* Tomcat on Linux
* Enabling SSI and CGI Support
* Security manager URLs
* Symlinking static resources
* Enabling invoker servlet
* Viewing the Tomcat Change Log
* When all else fails
===================
Dependency Changes:
===================
Tomcat 5.5 is designed to run on J2SE 5.0 and later, and requires
configuration to run on J2SE 1.4. Make sure to read the "RUNNING.txt"
file in this directory if you are using J2SE 1.4.
In addition, Tomcat 5.5 uses the Eclipse JDT Java compiler for compiling
JSP pages. This means you no longer need to have the complete
Java Development Kit (JDK) to run Tomcat, but a Java Runtime Environment
(JRE) is sufficient. The Eclipse JDT Java compiler is bundled with the
binary Tomcat distributions. Tomcat can also be configured to use the
compiler from the JDK to compile JSPs, or any other Java compiler supported
by Apache Ant.
=======================
JNI Based Applications:
=======================
Applications that require native libraries must ensure that the libraries have
been loaded prior to use. Typically, this is done with a call like:
static {
System.loadLibrary("path-to-library-file");
}
in some class. However, the application must also ensure that the library is
not loaded more than once. If the above code were placed in a class inside
the web application (i.e. under /WEB-INF/classes or /WEB-INF/lib), and the
application were reloaded, the loadLibrary() call would be attempted a second
time.
To avoid this problem, place classes that load native libraries outside of the
web application, and ensure that the loadLibrary() call is executed only once
during the lifetime of a particular JVM.
=============
Bundled APIs:
=============
A standard installation of Tomcat 5.5 makes all of the following APIs available
for use by web applications (by placing them in "common/lib" or "shared/lib"):
* commons-el.jar (Commons Expression Language 1.0)
* commons-logging-api.jar (Commons Logging API 1.0.x)
* jasper-compiler.jar (Jasper 2 Compiler)
* jasper-compiler-jdt.jar (Eclipse JDT Java compiler)
* jasper-runtime.jar (Jasper 2 Runtime)
* jsp-api.jar (JSP 2.0 API)
* naming-common.jar (JNDI Context implementation)
* naming-factory.jar (JNDI object factories for J2EE ENC support)
* naming-factory-dbcp.jar (DataSource implementation based on commons-dbcp)
* naming-resources.jar (JNDI DirContext implementations)
* servlet-api.jar (Servlet 2.4 API)
Installing the compatibility package will add the following to the list, which are
needed when running on J2SE 1.4:
* jmx.jar (Java Management Extensions API 1.2 or later)
* xercesImpl.jar (Xerces XML Parser, version 2.6.2 or later)
You can make additional APIs available to all of your web applications by
putting unpacked classes into a "classes" directory (not created by default),
or by placing them in JAR files in the "lib" directory.
To override the XML parser implementation or interfaces, use the endorsed
mechanism of the JVM. The default configuration defines JARs located in
"common/endorsed" as endorsed.
================================================================
Web application reloading and static fields in shared libraries:
================================================================
Some shared libraries (many are part of the JDK) keep references to objects
instantiated by the web application. To avoid class loading related problems
(ClassCastExceptions, messages indicating that the classloader
is stopped, etc.), the shared libraries state should be reinitialized.
Something which might help is to avoid putting classes which would be
referenced by a shared static field in the web application classloader,
and putting them in the shared classloader instead (JARs should be put in the
"lib" folder, and classes should be put in the "classes" folder).
================
Tomcat on Linux:
================
GLIBC 2.2 / Linux 2.4 users should define an environment variable:
export LD_ASSUME_KERNEL=2.2.5
Redhat Linux 9.0 users should use the following setting to avoid
stability problems:
export LD_ASSUME_KERNEL=2.4.1
=============================
Enabling SSI and CGI Support:
=============================
Because of the security risks associated with CGI and SSI available
to web applications, these features are disabled by default.
To enable and configure CGI support, please see the cgi-howto.html page.
To enable and configue SSI support, please see the ssi-howto.html page.
======================
Security manager URLs:
======================
In order to grant security permissions to JARs located inside the
web application repository, use URLs of of the following format
in your policy file:
file:${catalina.home}/webapps/examples/WEB-INF/lib/driver.jar
============================
Symlinking static resources:
============================
By default, Unix symlinks will not work when used in a web application to link
resources located outside the web application root directory.
This behavior is optional, and the "allowLinking" flag may be used to disable
the check.
=========================
Enabling invoker servlet:
=========================
Starting with Tomcat 4.1.12, the invoker servlet is no longer available by
default in all webapps. Enabling it for all webapps is possible by editing
$CATALINA_HOME/conf/web.xml to uncomment the "/servlet/*" servlet-mapping
definition.
Using the invoker servlet in a production environment is not recommended and
is unsupported. More details are available on the Tomcat FAQ at
http://jakarta.apache.org/tomcat/faq/misc.html#invoker.
==============================
Viewing the Tomcat Change Log:
==============================
See changelog.html in this directory.
====================
When all else fails:
====================
See the FAQ
http://jakarta.apache.org/tomcat/faq/

Binary file not shown.

View file

@ -0,0 +1,42 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
<!--
Copyright 2004 The Apache Software Foundation
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<web-app xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd"
version="2.4">
<display-name>Welcome to Tomcat</display-name>
<description>
Welcome to Tomcat
</description>
<!-- JSPC servlet mappings start -->
<servlet>
<servlet-name>org.apache.jsp.index_jsp</servlet-name>
<servlet-class>org.apache.jsp.index_jsp</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>org.apache.jsp.index_jsp</servlet-name>
<url-pattern>/index.jsp</url-pattern>
</servlet-mapping>
<!-- JSPC servlet mappings end -->
</web-app>

View file

@ -0,0 +1,14 @@
<!doctype html public "-//w3c//dtd html 4.0 transitional//en" "http://www.w3.org/TR/REC-html40/strict.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<title>Administration</title>
</head>
<body>
Tomcat's administration web application is no longer installed by default. Download and install
the "admin" package to use it.
</body>
</html>

View file

@ -0,0 +1,192 @@
<!doctype html public "-//w3c//dtd html 4.0 transitional//en" "http://www.w3.org/TR/REC-html40/strict.dtd">
<%@ page session="false" %>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<title><%= application.getServerInfo() %></title>
<style type="text/css">
<!--
body {
color: #000000;
background-color: #FFFFFF;
font-family: Arial, "Times New Roman", Times;
font-size: 16px;
}
A:link {
color: blue
}
A:visited {
color: blue
}
td {
color: #000000;
font-family: Arial, "Times New Roman", Times;
font-size: 16px;
}
.code {
color: #000000;
font-family: "Courier New", Courier;
font-size: 16px;
}
-->
</style>
</head>
<body>
<!-- Header -->
<table width="100%">
<tr>
<td align="left" width="130"><a href="http://jakarta.apache.org/tomcat/index.html"><img src="tomcat.gif" height="92" width="130" border="0" alt="The Mighty Tomcat - MEOW!"></td>
<td align="left" valign="top">
<table>
<tr><td align="left" valign="top"><b><%= application.getServerInfo() %></b></td></tr>
</table>
</td>
<td align="right"><a href="http://jakarta.apache.org/"><img src="jakarta-banner.gif" height="48" width="505" border="0" alt="The Jakarta Project"></a></td>
</tr>
</table>
<br>
<table>
<tr>
<!-- Table of Contents -->
<td valign="top">
<table width="100%" border="1" cellspacing="0" cellpadding="3" bordercolor="#000000">
<tr>
<td bgcolor="#D2A41C" bordercolor="#000000" align="left" nowrap>
<font face="Verdana" size="+1"><i>Administration</i>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</font>
</td>
</tr>
<tr>
<td bgcolor="#FFDC75" bordercolor="#000000" nowrap>
<a href="manager/status">Status</a><br>
<a href="admin">Tomcat Administration</a><br>
<a href="manager/html">Tomcat Manager</a><br>
&nbsp;
</td>
</tr>
</table>
<br>
<table width="100%" border="1" cellspacing="0" cellpadding="3" bordercolor="#000000">
<tr>
<td bgcolor="#D2A41C" bordercolor="#000000" align="left" nowrap>
<font face="Verdana" size="+1"><i>Documentation</i>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</font>
</td>
</tr>
<tr>
<td bgcolor="#FFDC75" bordercolor="#000000" nowrap>
<a href="RELEASE-NOTES.txt">Release Notes</a><br>
<a href="tomcat-docs/changelog.html">Change Log</a><br>
<a href="tomcat-docs">Tomcat Documentation</a><br>
&nbsp;
</td>
</tr>
</table>
<br>
<table width="100%" border="1" cellspacing="0" cellpadding="3" bordercolor="#000000">
<tr>
<td bgcolor="#D2A41C" bordercolor="#000000" align="left" nowrap>
<font face="Verdana" size="+1"><i>Tomcat Online</i>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</font>
</td>
</tr>
<tr>
<td bgcolor="#FFDC75" bordercolor="#000000" nowrap>
<a href="http://jakarta.apache.org/tomcat/">Home Page</a><br>
<a href="http://jakarta.apache.org/tomcat/bugreport.html">Bug Database</a><br>
<a href="http://issues.apache.org/bugzilla/buglist.cgi?bug_status=UNCONFIRMED&amp;bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED&amp;bug_status=RESOLVED&amp;resolution=LATER&amp;resolution=REMIND&amp;resolution=---&amp;bugidtype=include&amp;product=Tomcat+5&amp;cmdtype=doit&amp;order=Importance">Open Bugs</a><br>
<a href="http://nagoya.apache.org/eyebrowse/SummarizeList?listId=88">Users Mailing List</a><br>
<a href="http://nagoya.apache.org/eyebrowse/SummarizeList?listId=46">Developers Mailing List</a><br>
<a href="irc://irc.freenode.net/#tomcat">IRC</a><br>
&nbsp;
</td>
</tr>
</table>
<br>
<table width="100%" border="1" cellspacing="0" cellpadding="3" bordercolor="#000000">
<tr>
<td bgcolor="#D2A41C" bordercolor="#000000" align="left" nowrap>
<font face="Verdana" size="+1"><i>Examples</i>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</font>
</td>
</tr>
<tr>
<td bgcolor="#FFDC75" bordercolor="#000000" nowrap>
<a href="jsp-examples/">JSP Examples</a><br>
<a href="servlets-examples/">Servlet Examples</a><br>
<a href="webdav/">WebDAV capabilities</a><br>
&nbsp;
</td>
</tr>
</table>
<br>
<table width="100%" border="1" cellspacing="0" cellpadding="3" bordercolor="#000000">
<tr>
<td bgcolor="#D2A41C" bordercolor="#000000" align="left" nowrap>
<font face="Verdana" size="+1"><i>Miscellaneous</i>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</font>
</td>
</tr>
<tr>
<td bgcolor="#FFDC75" bordercolor="#000000" nowrap>
<a href="http://java.sun.com/products/jsp">Sun's Java Server Pages Site</a><br>
<a href="http://java.sun.com/products/servlet">Sun's Servlet Site</a><br>
&nbsp;
</td>
</tr>
</table>
</td>
<td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
<!-- Body -->
<td align="left" valign="top">
<p><center><b>If you're seeing this page via a web browser, it means you've setup Tomcat successfully. Congratulations!</b></center></p>
<p>As you may have guessed by now, this is the default Tomcat home page. It can be found on the local filesystem at:
<blockquote>
<p class="code">$CATALINA_HOME/webapps/ROOT/index.jsp</p>
</blockquote>
</p>
<p>where "$CATALINA_HOME" is the root of the Tomcat installation directory. If you're seeing this page, and you don't think you should be, then either you're either a user who has arrived at new installation of Tomcat, or you're an administrator who hasn't got his/her setup quite right. Providing the latter is the case, please refer to the <a href="tomcat-docs">Tomcat Documentation</a> for more detailed setup and administration information than is found in the INSTALL file.</p>
<p><b>NOTE:</b> This page is precompiled. If you change it, this page will not change since
it was compiled into a servlet at build time.
(See <tt>$CATALINA_HOME/webapps/ROOT/WEB-INF/web.xml</tt> as to how it was mapped.)
</p>
<p><b>NOTE: For security reasons, using the administration webapp
is restricted to users with role "admin". The manager webapp
is restricted to users with role "manager".</b>
Users are defined in <code>$CATALINA_HOME/conf/tomcat-users.xml</code>.</p>
<p>Included with this release are a host of sample Servlets and JSPs (with associated source code), extensive documentation (including the Servlet 2.4 and JSP 2.0 API JavaDoc), and an introductory guide to developing web applications.</p>
<p>Tomcat mailing lists are available at the Jakarta project web site:</p>
<ul>
<li><b><a href="mailto:tomcat-user-subscribe@jakarta.apache.org">tomcat-user@jakarta.apache.org</a></b> for general questions related to configuring and using Tomcat</li>
<li><b><a href="mailto:tomcat-dev-subscribe@jakarta.apache.org">tomcat-dev@jakarta.apache.org</a></b> for developers working on Tomcat</li>
</ul>
<p>Thanks for using Tomcat!</p>
<p align="right"><font size=-1><img src="tomcat-power.gif" width="77" height="80"></font><br>
&nbsp;
<font size=-1>Copyright &copy; 1999-2004 Apache Software Foundation</font><br>
<font size=-1>All Rights Reserved</font> <br>
&nbsp;</p>
<p align="right">&nbsp;</p>
</td>
</tr>
</table>
</body>
</html>

Binary file not shown.

After

Width:  |  Height:  |  Size: 8.4 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.3 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.9 KiB

View file

@ -0,0 +1,12 @@
<!--
Context configuration file for the Tomcat Balancer Web App
This is only needed to keep the distribution small and avoid duplicating
commons libraries
$Id: context.xml,v 1.1 2005/05/17 16:51:09 aranganath Exp $
-->
<Context privileged="true" antiResourceLocking="false" antiJARLocking="false" />

View file

@ -0,0 +1,18 @@
<?xml version="1.0" encoding="UTF-8"?>
<rules>
<!-- If the URL contains News (case-sensitive), go to CNN.com -->
<rule className="org.apache.webapp.balancer.rules.URLStringMatchRule"
targetString="News"
redirectUrl="http://www.cnn.com" />
<!-- If the request contains a parameter named paramName whose value
is paramValue, go to Yahoo.com. -->
<rule className="org.apache.webapp.balancer.rules.RequestParameterRule"
paramName="paramName"
paramValue="paramValue"
redirectUrl="http://www.yahoo.com" />
<!-- Redirect all requests to jakarta.apache.org. -->
<rule className="org.apache.webapp.balancer.rules.AcceptEverythingRule"
redirectUrl="http://jakarta.apache.org" />
</rules>

View file

@ -0,0 +1,27 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
<web-app xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd"
version="2.4">
<display-name>Tomcat Simple Load Balancer Example App</display-name>
<description>
Tomcat Simple Load Balancer Example App
</description>
<!-- BalancerFilter definition -->
<filter>
<filter-name>BalancerFilter</filter-name>
<filter-class>org.apache.webapp.balancer.BalancerFilter</filter-class>
<init-param>
<param-name>configUrl</param-name>
<param-value>/WEB-INF/config/rules.xml</param-value>
</init-param>
</filter>
<!-- BalancerFilter mapping -->
<filter-mapping>
<filter-name>BalancerFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
</web-app>

View file

@ -0,0 +1,90 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
<!--
Copyright 2004 The Apache Software Foundation
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<web-app xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd"
version="2.4">
<display-name>Webdav Content Management</display-name>
<description>
Webdav Content Management
</description>
<servlet>
<servlet-name>webdav</servlet-name>
<servlet-class>org.apache.catalina.servlets.WebdavServlet</servlet-class>
<init-param>
<param-name>debug</param-name>
<param-value>0</param-value>
</init-param>
<init-param>
<param-name>listings</param-name>
<param-value>true</param-value>
</init-param>
<!-- Uncomment this to enable read and write access -->
<!--
<init-param>
<param-name>readonly</param-name>
<param-value>false</param-value>
</init-param>
-->
<!--load-on-startup>1</load-on-startup-->
</servlet>
<!-- The mapping for the webdav servlet -->
<!-- Using /* as the mapping ensures that jasper, welcome files etc are
over-ridden and all requests are processed by the webdav servlet.
This also overcomes a number of issues with some webdav clients
(including MS Webfolders) that do not respond correctly to the
redirects (302) that result from using a mapping of / -->
<servlet-mapping>
<servlet-name>webdav</servlet-name>
<url-pattern>/*</url-pattern>
</servlet-mapping>
<!-- ================ Security Constraints for Testing =============== -->
<!--
<security-constraint>
<web-resource-collection>
<web-resource-name>The Entire Web Application</web-resource-name>
<url-pattern>/*</url-pattern>
</web-resource-collection>
<auth-constraint>
<role-name>tomcat</role-name>
</auth-constraint>
</security-constraint>
<login-config>
<auth-method>BASIC</auth-method>
<realm-name>Tomcat Supported Realm</realm-name>
</login-config>
<security-role>
<description>
An example role defined in "conf/tomcat-users.xml"
</description>
<role-name>tomcat</role-name>
</security-role>
-->
<welcome-file-list>
<welcome-file/>
</welcome-file-list>
</web-app>

View file

@ -0,0 +1,76 @@
<!doctype html public "-//w3c//dtd html 4.0 transitional//en">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<meta name="GENERATOR" content="Mozilla/4.72 [en] (WinNT; U) [Netscape]">
<meta name="Author" content="Anil K. Vijendran">
<title>Tomcat WebDAV support</title>
</head>
<body bgcolor="#FFFFFF">
<img SRC="tomcat.gif" height=92 width=130 align=LEFT><b><font face="Arial, Helvetica, sans-serif"><font size=+3>Tomcat</font></font></b>
<br>
<b><font face="Arial, Helvetica, sans-serif"><font size=-1>WebDAV support</font></font></b>
<p>This is the home page for the webdav context. This page is located at:
<ul>
<li>
<font face="Courier New, Courier,mono">$TOMCAT_HOME/webapps/webdav/index.html</font></li>
</ul>
<p>Tomcat includes built-in support for WebDAV level 2, which enables
remote authoring of the website. You can test these capabilities using a WebDAV
client like MS WebFolders (included with IE 4.0 and up), MS Office 2000, DAV
Explorer (others are listed on the webpages linked below), and point to the
<b>/webdav</b> path of the server.
<p>This test context is DAV enabled, but has been set up in read-only mode for
safety reasons. It can be put in read-write mode by editing the web
application descriptor file (WEB-INF/web.xml).
<p>To add remote authoring to your web application, you need to make the following
changes:
<ul>
<li>Add the webDAV servlet to your web application. See the web application
deployment descriptor for an example. Don't forget to make it read/write.
<li>Add a servlet mapping for the webDAV servlet with a url pattern of "/webdav/*"
to your web.xml.
<li>Add an appropriate security constraint to prevent unauthorised changes to your
web application.
<li>You can then edit your web application using a webDAV client using a url
like <font face="Courier New, Courier,mono">http://host:port/webapp/webdav</font></li>
</ul>
<p>Working WebDAV clients include :
<ul>
<li>Adobe GoLive 5.0 (and other WebDAV-enabled Adobe products, like
Photoshop)</li>
<li>Cadaver 0.15</li>
<li>DAV Explorer 0.60 and 0.70</li>
<li>Internet Explorer 5 (Windows 2000)</li>
<li>Internet Explorer 5.5 (Windows 2000)</li>
<li>Jakarta Slide 1.0 WebDAV client library</li>
<li>Office 2000 (Windows 2000)</li>
<li>SkunkDAV 1.0</li>
<li>Xythos WebFile Client</li>
</ul>
<p>WebDAV links:</p>
<ul>
<li><b><a href="http://www.webdav.org">General info on WebDAV</a></b></li>
<li><b><a href="http://www.ics.uci.edu/pub/ietf/webdav/">WebDAV working
group</a></b></li>
<li><b><a href="http://www.webdav.org/projects/">WebDAV clients</a></b></li>
<li><b>
<a href="http://jakarta.apache.org/slide/">The Jakarta Slide Project</a>
</b></li>
</ul>
<hr>
<p align="right"><font size=-1><img src="tomcat-power.gif" width="77" height="80"></font><br>
&nbsp;
<font size=-1>Copyright &copy; 1999-2001 Apache Software Foundation</font><br>
<font size=-1>All Rights Reserved</font> <br>
&nbsp;</p>
<p align="right">&nbsp;</p>
</body>
</html>

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.3 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.9 KiB