home *** CD-ROM | disk | FTP | other *** search
/ Java - The Ultimate Resource for Java Developers / Java_The_Ultimate_Resource_for_Java_Developers_IBM_1998.iso / ServletExpress / readme.txt next >
Text File  |  1998-03-01  |  10KB  |  217 lines
  1. ######################################################################
  2. #  (C) Copyright IBM Corporation 1998.
  3. #  All rights reserved.
  4. ######################################################################
  5.  
  6. Welcome to IBM ServletExpress Version 1.0 Beta 2!
  7.  
  8. This README includes the following topics:
  9. >> THE JAVAONE CD
  10. >> SUPPORTED PLATFORMS
  11. >> DOCUMENTATION
  12. >> PRODUCT FORUM
  13. >> SERVICE AND PRODUCT SUPPORT
  14. >> BROWSER REQUIREMENT FOR SERVLETEXPRESS MANAGER
  15. >> PAGE COMPILATION
  16. >> ENABLING LOGGING
  17. >> KNOWN DEFECTS
  18.  
  19. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  20. >> THE JAVAONE CD
  21. The JavaOne CD contains ServletExpress Version 1.0 Beta 2 for Windows NT only.
  22. Information in this README file concerning ServletExpress on other platforms does
  23. not apply to the JavaOne CD. The following defects are specific to the JavaOne CD:
  24. - The ServletExpress sample servlets and applications do not work.
  25. - Netscape Enterprise Server and FastTrack Server Version 3.51 are not supported.
  26. - IBM ServletExpress CORBA Support is not supported.
  27. - The Stop and Restart buttons in the ServletExpress Manager do not work.
  28. - Servlet chaining and filtering is not supported.
  29. To obtain fixes to these and other defects described in this README file,
  30. please download the the latest ServletExpress code package from the Web site:
  31.     http://www.ibm.com/java/servexp/
  32.  
  33. >> SUPPORTED PLATFORMS
  34. IBM ServletExpress Version 1.0 Beta 2 supports:
  35. - Domino Go Webserver 4.6.1 and 4.6.2 for Windows NT, Sun Solaris, and AIX
  36. - Netscape Enterprise Server Version 2.01 and higher
  37.   for Windows NT, Sun Solaris, and AIX
  38. - Netscape FastTrack Server Version 2.01 and higher
  39.   for Windows NT, Sun Solaris, and AIX
  40. - Microsoft Internet Information Server Version 2.x, 3.x, or 4.0 for Windows NT
  41. - Apache Server Version 1.2.4 for Sun Solaris and AIX
  42.  
  43.  
  44. >> DOCUMENTATION
  45. When you install IBM ServletExpress, HTML copies of the 
  46. ServletExpress Webmaster's Guide, Web Programmer's Guide,
  47. and this README file are installed on your Domino Go Webserver.
  48. Use your browser to open:
  49. - For Windows NT, open <servletexpress_root>\system\en_US\doc\index.html,
  50. where <servletexpress_root> is the path where ServletExpress is installed.
  51. - For AIX, open /usr/lpp/ServletExpress/system/en_US/doc/index.html.
  52. - For Sun Solaris, open /opt/ServletExpress/system/en_US/doc/index.html.
  53.  
  54. For the most current level of ServletExpress documentation for Domino Go
  55. Webserver, refer to the Documentation page of the Web site:
  56.     http://www.ibm.com/java/servexp/sedoco.html
  57.  
  58. The Documentation page contains links for the following documents:
  59. - ServletExpress Webmaster's Guide (HTML and PDF)
  60. - ServletExpress Web Programmer's Guide (HTML and PDF)
  61. - JavaSoft Java Servlet API Whitepaper
  62. - JavaSoft Page Compilation tutorial
  63. - Javadoc for Java Servlet API
  64. - Javadoc for the ServletExpress extensions
  65. - This README
  66.  
  67.  
  68. >> PRODUCT FORUM
  69. Use the ServletExpress Forum to communicate with other users and get
  70. answers to questions.  Use your browser to open:
  71.     http://www.ibm.com/java/servexp/sesupport.html
  72.  
  73. >> SERVICE AND PRODUCT SUPPORT
  74. If you need service for ServletExpress, use the ServletExpress Forum to
  75. submit your request.
  76.  
  77.  
  78. >> BROWSER REQUIREMENT FOR SERVLETEXPRESS MANAGER
  79. ServletExpress Manager is the user interface for managing servlets.  To run the
  80. Manager, you need an appletviewer or a browser that supports Java Development 
  81. Kit (JDK) 1.1. Examples of browsers that support JDK 1.1 are:
  82. - Netscape Communicator 4.03 or 4.04 with the JDK 1.1 patch (available at
  83. http://developer.netscape.com/software/jdk/download.html).
  84. - Microsoft Internet Explorer 4
  85. - Sun HotJava 1.1
  86.  
  87. >> PAGE COMPILATION
  88. If your your servlets are invoked from SHTML and JHTML files, place those files
  89. in the <servletexpress_root>\public_html directory, where <servletexpress_root>
  90. is the path where ServletExpress is installed.
  91.  
  92. >> ENABLING LOGGING
  93. This section contains instructions for enabling the ServletExpress engine logging.
  94.   >>> Native DLL Logging
  95.   These log messages are produced by the Web server C code before entering Java.
  96.   To control this type of logging:
  97.   1. Open the jvm.properties file, which is in the following path: 
  98.   <servletexpress_root>\properties\server\ServletExpress\servletservice
  99.   
  100.   2. To enable logging:
  101.   a. Set the property ncf.native.logison=true.
  102.   b. Set the property ncf.native.logfile=<servletexpress_root>\logs\native.log.
  103.   c. Restart your Web server.
  104.   
  105.   3. To disable logging:
  106.   a. Set the property ncf.native.logison=false.
  107.   b. Restart your Web server.
  108.   
  109.   >>> Java Standard Out Log
  110.   Any System.out and System.err prints go to this log.
  111.   To control this type of logging:
  112.   1. Open the jvm.properties file, which is in the following path: 
  113.   <servletexpress_root>\properties\server\ServletExpress\servletservice
  114.   
  115.   2. To enable logging to a file:
  116.   a. Set the property ncf.jvm.stdoutlog.enabled=true.
  117.   b. Set the property ncf.jvm.stdoutlog.file=true
  118.   c. Set the property ncf.jvm.stdoutlog.filename=<servletexpress_root>\logs\ncf.log.
  119.   
  120.   3. To enable logging to a Java console window:
  121.   a. Set the property ncf.jvm.stdoutlog.enabled=true.
  122.   b. Set the property ncf.jvm.stdoutlog.file=false.
  123.   
  124.   4. To disable logging:
  125.   a. Set the property ncf.jvm.stdoutlog.enabled=false.
  126.   b. Set the property ncf.jvm.stdoutlog.file=false.
  127.   
  128.  
  129. >> KNOWN DEFECTS
  130. The defects listed below are organized by server and platform.
  131. There are workarounds for most of the defects.
  132.   >>> Session Support
  133.   Session support is enabled by default. However, the following defects are known:
  134.   - URL rewriting is not working.
  135.   - The ServletExpress Manager does not yet support configuring session support.
  136.   To configure session support, you must edit the session properties file, which is
  137.   <servletexpress_root>\properties\server\ServletExpress\servletservice\sessions.properties.
  138.   After you edit the file, you must restart the service or the Web server for the 
  139.   changes to take effect. For a detailed description of session support,
  140.   refer to the Java Server information at http://java.sun.com. The session properties are:
  141.  
  142. enable.sessions - set to true by default
  143. enable.urlrewriting - set to false by default, but not working yet
  144. enable.cookies - set to true by default
  145. enable.protocolswitchrewriting - set to false by default;
  146.  
  147. session.inavalidationinterval - set to 10000 by default (in milliseconds)
  148. session.swapinterval - set to 10000 (in ms)
  149. session.persistence - set to true
  150. session.swapdirectory - must an accessible path name. If commented out with a #,
  151.     ServletExpress will create a directory under the
  152.     <servletexpress_install_root>\logs directory.
  153. session.maxresidents - default at 1024
  154. session.invalidationtime - default 1800000 in ms
  155.  
  156. session.cookie.name- default sesessionid
  157. session.cookie.comment - default ServletExpress Session Support
  158. session.cookie.domain - leave commented out with a # unless you want to restrict who
  159.     can have sessions with cookies
  160. session.cookie.maxage - leave commented out with a # unless you want to restrict who
  161.     can have sessions with cookies
  162. session.cookie.path - leave commented out with a # unless you want to restrict who
  163.     can have sessions with cookies
  164. session.cookie.secure - leave commented out with a # unless you want to restrict who
  165.     can have sessions with cookies
  166.  
  167. // new for clustering
  168. session.server.host - the hostname or IP address of the instance of ServletExpress
  169.     that will be contacted for sessions.  If this property is not present, is
  170.     commented out with a #, or its value is blank, this instance of ServletExpress
  171.     operates either as a potential server or a standalone session server
  172.     (that is, the original session support).
  173. session.cluster.host - for protocol switch rewriting in a clustered, session sharing
  174.     environment, this is the hostname used to query your cluster. This host name
  175.     will be used to determine whether protocol switching is occurring. 
  176.     You can leave the value blank, comment out the property with a #,
  177.     or delete the property from the file.
  178.  
  179.   >>> Servlet chaining and filtering is non-functional.
  180.  
  181.   >>> Domino Go Webserver on AIX
  182.   If the ServletExpress Manager is running when you try to run a servlet,
  183.   the Domino Go Webserver will core dump. To avoid this problem, perform
  184.   one of the following procedures:
  185.   - Do not run the ServletExpress Manager and servlets at the same time.
  186.     After you finish using the ServletExpress Manager, 
  187.     be sure to log off before you run any servlets.
  188.   - If you are not using any of the Session Management features, disable
  189.     the sessionManager servlet. In the ServletExpress Manager, set
  190.     "Load on Startup"for the sessionManager servlet to No.
  191.     Restart your Domino Go Webserver.  You can now run servlets at the same
  192.     time as the ServletExpress Manager.
  193.  
  194.   >>> Apache on AIX and Sun
  195.   ServletExpress does not shutdown when Apache server is shutdown. In such
  196.   a case, you run ServletExpress Manager and not realize that the
  197.   Apache server is not available. If this happens, perform one of the following
  198.   procedures:
  199.   - Restart the system.
  200.   - Determine the pid of the ServletExpress Java Virtual Machine (JVM) by using
  201.     the command ps -eaf. Stop the JVM and then change the ncf.native.outofproc.port
  202.     in the ServletExpress configuration file (jvm.properties).
  203.  
  204.  
  205. >>> INSTALLATION PROBLEMS
  206.   >>> Installation for IIS 4.0 for this ServletExpress Beta 2.0 release 
  207.       requires the following steps:
  208.         1.  Open the Services Applet in the Control Panel.
  209.         2.  Stop the World Wide Web Publishing Service
  210.         3.  Install ServletExpress 
  211.         4.  Restart the World Wide Web Publishing Service.
  212.       
  213.   
  214. Upgrade to ServletExpress Beta 2.1 by downloading the new version from the
  215. download website --
  216.          http://www.ibm.com/java/servexp
  217.