home *** CD-ROM | disk | FTP | other *** search
/ PC Professionell 2004 December / PCpro_2004_12.ISO / files / webserver / xampp / xampp-tomcat-addon-1.4.9-installer.exe / RELEASE-NOTES.txt < prev    next >
Encoding:
Text File  |  2004-08-28  |  8.8 KB  |  249 lines
  1.  
  2.  
  3.                      Apache Tomcat Version 5.0.28
  4.                             Release Notes
  5.  
  6.  
  7. $Id: RELEASE-NOTES,v 1.18 2004/06/15 18:42:06 yoavs Exp $
  8.  
  9.  
  10. ============================
  11. KNOWN ISSUES IN THIS RELEASE:
  12. ============================
  13.  
  14. * Tomcat 5.0 and JNI Based Applications
  15. * Tomcat 5.0 Standard APIs Available
  16. * Tomcat 5.0 and XML Parsers
  17. * Web application reloading and static fields in shared libraries
  18. * JAVAC leaking memory
  19. * Tomcat on Linux
  20. * Enabling SSI and CGI Support
  21. * Security manager URLs
  22. * Symlinking static resources
  23. * Enabling invoker servlet
  24. * Viewing the Tomcat Change Log
  25. * When all else fails
  26.  
  27.  
  28. -------------------------------------
  29. Tomcat 5.0 and JNI Based Applications:
  30. -------------------------------------
  31.  
  32. Applications that require native libraries must ensure that the libraries have
  33. been loaded prior to use.  Typically, this is done with a call like:
  34.  
  35.   static {
  36.     System.loadLibrary("path-to-library-file");
  37.   }
  38.  
  39. in some class.  However, the application must also ensure that the library is
  40. not loaded more than once.  If the above code were placed in a class inside
  41. the web application (i.e. under /WEB-INF/classes or /WEB-INF/lib), and the
  42. application were reloaded, the loadLibrary() call would be attempted a second
  43. time.
  44.  
  45. To avoid this problem, place classes that load native libraries outside of the
  46. web application, and ensure that the loadLibrary() call is executed only once
  47. during the lifetime of a particular JVM.
  48.  
  49.  
  50. ----------------------------------
  51. Tomcat 5.0 Standard APIs Available:
  52. ----------------------------------
  53.  
  54. A standard installation of Tomcat 5 makes all of the following APIs available
  55. for use by web applications (by placing them in "common/lib" or "shared/lib"):
  56. * ant.jar (Apache Ant 1.6 or later)
  57. * commons-collections*.jar (Commons Collections 2.1 or later)
  58. * commons-dbcp.jar (Commons DBCP 1.1 or later)
  59. * commons-el.jar (Commons Expression Language 1.0)
  60. * commons-logging-api.jar (Commons Logging API 1.0.3 or later)
  61. * commons-pool.jar (Commons Pool 1.1 or later)
  62. * jasper-compiler.jar (Jasper 2 Compiler)
  63. * jasper-runtime.jar (Jasper 2 Runtime)
  64. * jsp-api.jar (JSP 2.0 API)
  65. * commons-el.jar (JSP 2.0 Expression Language)
  66. * naming-common.jar (JNDI Context implementation)
  67. * naming-factory.jar (JNDI object factories for J2EE ENC support)
  68. * naming-resources.jar (JNDI DirContext implementations)
  69. * servlet-api.jar (Servlet 2.4 API)
  70.  
  71. You can make additional APIs available to all of your web applications by
  72. putting unpacked classes into a "classes" directory (not created by default),
  73. or by placing them in JAR files in the "lib" directory.
  74.  
  75. Tomcat 5.0 also makes Xerces 2 and the Commons Logging API (release 1.0.3)
  76. available to web applications.
  77.  
  78. Please note that the JMX API is available to applications as well.  The jmx.jar
  79. file used to be located in the common/lib directory, but was moved to the bin
  80. directory as part of the Tomcat 5.0.20 release.  The jmx.jar is in Tomcat's
  81. bootstrap classpath (included via the Class Path line in bootstrap.jar's manifest).
  82.  
  83.  
  84. --------------------------
  85. Tomcat 5.0 and XML Parsers:
  86. --------------------------
  87.  
  88. As described above, Tomcat 5.0 makes an XML parser (and many other standard
  89. APIs) available to web applications.  This parser is also used internally
  90. to parse web.xml files and the server.xml configuration file.  If you wish,
  91. you may replace the "xercesImpl.jar" file in "common/endorsed" with another
  92. XML parser, as long as it is compatible with the JAXP 1.2 APIs.
  93.  
  94. Xerces 2.6.2 is included.
  95.  
  96.  
  97. ---------------------------------------------------------------
  98. Web application reloading and static fields in shared libraries:
  99. ---------------------------------------------------------------
  100.  
  101. Some shared libraries (many are part of the JDK) keep references to objects
  102. instantiated by the web application. To avoid class loading related problems
  103. (ClassCastExceptions, messages indicating that the classloader
  104. is stopped, etc.), the shared libraries state should be reinitialized.
  105.  
  106. Something which might help is to avoid putting classes which would be
  107. referenced by a shared static field in the web application classloader,
  108. and putting them in the shared classloader instead (JARs should be put in the
  109. "lib" folder, and classes should be put in the "classes" folder).
  110.  
  111.  
  112. --------------------
  113. JAVAC leaking memory:
  114. --------------------
  115.  
  116. The Java compiler leaks memory each time a class is compiled. Web applications
  117. containing hundreds of JSP files may as a result trigger out of memory errors
  118. once a significant number of pages have been accessed. The memory can only be
  119. freed by stopping Tomcat and then restarting it.
  120.  
  121. The JSP command line compiler (JSPC) can also be used to precompile the JSPs.
  122.  
  123. Note: This issue has been fixed in Sun JDK 1.4.x.
  124.  
  125.  
  126. ---------------
  127. Tomcat on Linux:
  128. ---------------
  129.  
  130. Virtual machine crashes can be experienced when using certain combinations of
  131. kernel / glibc under Linux with Sun Hotspot 1.2 to 1.3. The crashes were
  132. reported to occur mostly on startup. Sun JDK 1.4 does not exhibit the problems,
  133. and neither does IBM JDK for Linux.
  134.  
  135. The problems can be fixed by reducing the default stack size. At bash shell,
  136. do "ulimit -s 2048"; use "limit stacksize 2048" for tcsh.
  137.  
  138. GLIBC 2.2 / Linux 2.4 users should also define an environment variable:
  139. export LD_ASSUME_KERNEL=2.2.5
  140.  
  141. Additionally, Redhat Linux 9.0 users should use the same setting, to avoid
  142. stability problems.
  143.  
  144.  
  145. ----------------------------
  146. Enabling SSI and CGI Support:
  147. ----------------------------
  148.  
  149. Having CGI and SSI available to web applications created security problems when
  150. using a security manager (as a malicious web application could use them to
  151. sidestep the security manager access control). In Tomcat 5.0, they have been
  152. disabled by default, as our goal is to provide a fully secure default
  153. configuration. However, CGI and SSI remain available.
  154.  
  155.  
  156. To enable CGI:
  157. * rename the file $CATALINA_HOME/server/lib/servlets-cgi.renametojar to
  158.   $CATALINA_HOME/server/lib/servlets-cgi.jar.
  159. * in $CATALINA_HOME/conf/web.xml, you will need to uncomment 2 areas, the
  160.   servlet declaration and the servlet mapping. The servlet declaration
  161.   looks similar to this:
  162.     <servlet>
  163.         <servlet-name>cgi</servlet-name>
  164.         ...
  165.     </servlet>
  166.  
  167.   While the servlet mapping looks similar to this:
  168.     <servlet-mapping>
  169.         <servlet-name>cgi</servlet-name>
  170.         <url-pattern>/cgi-bin/*</url-pattern>
  171.     </servlet-mapping>
  172.  
  173.   Alternately, these servlet declarations and mappings
  174.   can be added to your web application deployment descriptor.
  175.  
  176. To enable SSI:
  177. * rename the file $CATALINA_HOME/server/lib/servlets-ssi.renametojar to
  178.   $CATALINA_HOME/server/lib/servlets-ssi.jar.
  179. * in $CATALINA_HOME/conf/web.xml, you will need to uncomment 2 areas, the
  180.   servlet declaration and the servlet mapping. The servlet declaration
  181.   looks similar to this:
  182.     <servlet>
  183.         <servlet-name>ssi</servlet-name>
  184.         ...
  185.     </servlet>
  186.  
  187.   While the servlet mapping looks similar to this:
  188.     <servlet-mapping>
  189.         <servlet-name>ssi</servlet-name>
  190.         <url-pattern>*.shtml</url-pattern>
  191.     </servlet-mapping>
  192.  
  193.   Alternately, these servlet declarations and mappings
  194.   can be added to your web application deployment descriptor.
  195.  
  196.  
  197.  
  198. ---------------------
  199. Security manager URLs:
  200. ---------------------
  201.  
  202. The URLs to be used in the policy file to grant permissions to JARs located
  203. inside the web application repositories have changed as of Tomcat 4.1.
  204.  
  205. In Tomcat 4.0, codeBase URLs for JARs loaded from web application
  206. repositories were:
  207. jar:file:${catalina.home}/webapps/examples/WEB-INF/lib/driver.jar!/-
  208.  
  209. In Tomcat 4.1 and 5.0, they should be:
  210. file:${catalina.home}/webapps/examples/WEB-INF/lib/driver.jar
  211.  
  212.  
  213. ---------------------------
  214. Symlinking static resources:
  215. ---------------------------
  216.  
  217. By default, Unix symlinks will not work when used in a web application to link
  218. resources located outside the web application root directory.
  219.  
  220. This behavior is optional, and the "allowLinking" flag may be used to disable
  221. the check.
  222.  
  223.  
  224. ------------------------
  225. Enabling invoker servlet:
  226. ------------------------
  227.  
  228. Starting with Tomcat 4.1.12, the invoker servlet is no longer available by
  229. default in all webapps. Enabling it for all webapps is possible by editing
  230. $CATALINA_HOME/conf/web.xml to uncomment the "/servlet/*" servlet-mapping
  231. definition.
  232.  
  233. Using the invoker servlet in a production environment is not recommended and
  234. is unsupported.
  235.  
  236. ------------------------
  237. Viewing the Tomcat Change Log 
  238. ------------------------
  239.  
  240. The Change Log for tomcat 5 is available at
  241. http://jakarta.apache.org/tomcat/tomcat-5.0-doc/changelog.html.
  242.  
  243. -------------------
  244. When all else fails:
  245. -------------------
  246.  
  247. See the FAQ
  248. http://jakarta.apache.org/tomcat/faq/
  249.