home *** CD-ROM | disk | FTP | other *** search
/ PC Professionell 2007 April / PCpro_2007_04.ISO / files / dsl / ManageEngineWiFiManager.exe / Disk1 / data1.cab / SourceFiles / WiFiManager.exe / tomcat / RELEASE-NOTES < prev    next >
Encoding:
Text File  |  2004-10-29  |  6.3 KB  |  176 lines
  1.  
  2.  
  3.                      Apache Tomcat Version @VERSION@
  4.                             Release Notes
  5.  
  6.  
  7. $Id: RELEASE-NOTES,v 1.24 2004/09/09 16:56:59 yoavs Exp $
  8.  
  9.  
  10. =============================
  11. KNOWN ISSUES IN THIS RELEASE:
  12. =============================
  13.  
  14. * Dependency Changes
  15. * JNI Based Applications
  16. * Bundled APIs
  17. * Web application reloading and static fields in shared libraries
  18. * Tomcat on Linux
  19. * Enabling SSI and CGI Support
  20. * Security manager URLs
  21. * Symlinking static resources
  22. * Enabling invoker servlet
  23. * Viewing the Tomcat Change Log
  24. * When all else fails
  25.  
  26.  
  27. ===================
  28. Dependency Changes:
  29. ===================
  30. Tomcat 5.5 is designed to run on J2SE 5.0 and later, and requires
  31. configuration to run on J2SE 1.4.  Make sure to read the "RUNNING.txt" 
  32. file in this directory if you are using J2SE 1.4.
  33.  
  34. In addition, Tomcat 5.5 uses the Eclipse JDT Java compiler for compiling
  35. JSP pages.  This means you no longer need to have the complete
  36. Java Development Kit (JDK) to run Tomcat, but a Java Runtime Environment
  37. (JRE) is sufficient.  The Eclipse JDT Java compiler is bundled with the 
  38. binary Tomcat distributions.  Tomcat can also be configured to use the
  39. compiler from the JDK to compile JSPs, or any other Java compiler supported 
  40. by Apache Ant.
  41.  
  42.  
  43. =======================
  44. JNI Based Applications:
  45. =======================
  46. Applications that require native libraries must ensure that the libraries have
  47. been loaded prior to use.  Typically, this is done with a call like:
  48.  
  49.   static {
  50.     System.loadLibrary("path-to-library-file");
  51.   }
  52.  
  53. in some class.  However, the application must also ensure that the library is
  54. not loaded more than once.  If the above code were placed in a class inside
  55. the web application (i.e. under /WEB-INF/classes or /WEB-INF/lib), and the
  56. application were reloaded, the loadLibrary() call would be attempted a second
  57. time.
  58.  
  59. To avoid this problem, place classes that load native libraries outside of the
  60. web application, and ensure that the loadLibrary() call is executed only once
  61. during the lifetime of a particular JVM.
  62.  
  63.  
  64. =============
  65. Bundled APIs:
  66. =============
  67. A standard installation of Tomcat 5.5 makes all of the following APIs available
  68. for use by web applications (by placing them in "common/lib" or "shared/lib"):
  69. * commons-el.jar (Commons Expression Language 1.0)
  70. * commons-logging-api.jar (Commons Logging API 1.0.3 or later)
  71. * jasper-compiler.jar (Jasper 2 Compiler)
  72. * jasper-compiler-jdt.jar (Eclipse JDT Java compiler)
  73. * jasper-runtime.jar (Jasper 2 Runtime)
  74. * jsp-api.jar (JSP 2.0 API)
  75. * commons-el.jar (JSP 2.0 Expression Language)
  76. * naming-common.jar (JNDI Context implementation)
  77. * naming-factory.jar (JNDI object factories for J2EE ENC support)
  78. * naming-factory-dbcp.jar (DataSource implementation based on commons-dbcp)
  79. * naming-resources.jar (JNDI DirContext implementations)
  80. * servlet-api.jar (Servlet 2.4 API)
  81.  
  82. Installing the compatibility package will add the following to the list, which are
  83. needed when running on J2SE 1.4:
  84. * jmx.jar (Java Management Extensions API 1.2 or later)
  85. * xercesImpl.jar (Xerces XML Parser, version 2.6.2 or later)
  86.  
  87. You can make additional APIs available to all of your web applications by
  88. putting unpacked classes into a "classes" directory (not created by default),
  89. or by placing them in JAR files in the "lib" directory.
  90.  
  91. To override the XML parser implementation or interfaces, use the endorsed
  92. mechanism of the JVM. The default configuration defines JARs located in 
  93. "common/endorsed" as endorsed.
  94.  
  95.  
  96. ================================================================
  97. Web application reloading and static fields in shared libraries:
  98. ================================================================
  99. Some shared libraries (many are part of the JDK) keep references to objects
  100. instantiated by the web application. To avoid class loading related problems
  101. (ClassCastExceptions, messages indicating that the classloader
  102. is stopped, etc.), the shared libraries state should be reinitialized.
  103.  
  104. Something which might help is to avoid putting classes which would be
  105. referenced by a shared static field in the web application classloader,
  106. and putting them in the shared classloader instead (JARs should be put in the
  107. "lib" folder, and classes should be put in the "classes" folder).
  108.  
  109.  
  110. ================
  111. Tomcat on Linux:
  112. ================
  113. GLIBC 2.2 / Linux 2.4 users should define an environment variable:
  114. export LD_ASSUME_KERNEL=2.2.5
  115.  
  116. Redhat Linux 9.0 users should use the following setting to avoid
  117. stability problems:
  118. export LD_ASSUME_KERNEL=2.4.1
  119.  
  120.  
  121. =============================
  122. Enabling SSI and CGI Support:
  123. =============================
  124. Because of the security risks associated with CGI and SSI available
  125. to web applications, these features are disabled by default.  
  126.  
  127. To enable and configure CGI support, please see the cgi-howto.html page.
  128.  
  129. To enable and configue SSI support, please see the ssi-howto.html page.
  130.  
  131.  
  132. ======================
  133. Security manager URLs:
  134. ======================
  135. In order to grant security permissions to JARs located inside the
  136. web application repository, use URLs of of the following format
  137. in your policy file:
  138.  
  139. file:${catalina.home}/webapps/examples/WEB-INF/lib/driver.jar
  140.  
  141.  
  142. ============================
  143. Symlinking static resources:
  144. ============================
  145. By default, Unix symlinks will not work when used in a web application to link
  146. resources located outside the web application root directory.
  147.  
  148. This behavior is optional, and the "allowLinking" flag may be used to disable
  149. the check.
  150.  
  151.  
  152. =========================
  153. Enabling invoker servlet:
  154. =========================
  155. Starting with Tomcat 4.1.12, the invoker servlet is no longer available by
  156. default in all webapps. Enabling it for all webapps is possible by editing
  157. $CATALINA_HOME/conf/web.xml to uncomment the "/servlet/*" servlet-mapping
  158. definition.
  159.  
  160. Using the invoker servlet in a production environment is not recommended and
  161. is unsupported.  More details are available on the Tomcat FAQ at
  162. http://jakarta.apache.org/tomcat/faq/misc.html#invoker.
  163.  
  164.  
  165. ==============================
  166. Viewing the Tomcat Change Log:
  167. ==============================
  168. See changelog.html in this directory.
  169.  
  170.  
  171. ====================
  172. When all else fails:
  173. ====================
  174. See the FAQ
  175. http://jakarta.apache.org/tomcat/faq/
  176.