home *** CD-ROM | disk | FTP | other *** search
/ Java Developer's Companion / Java Developer's Companion.iso / binaries / Windows / jsdk / README.apache < prev    next >
Encoding:
Text File  |  1997-07-21  |  3.2 KB  |  98 lines
  1. Servlet support for Apache
  2. --------------------------
  3.  
  4. This package allows servlets to be run in Apache 1.1.3.
  5.  
  6. Installation
  7. ------------
  8.  
  9. Apache installation requires that you install a version of the JDK,
  10. the JSDK, and the Apache servlet module.
  11.  
  12. Installing the Apache servlet module
  13. ------------------------------------
  14.  
  15.  Apache module for running servlets.  This Apache module lets you run servlets
  16.  from your Apache web server.
  17.  
  18.  To install the module:
  19.  
  20. 1) Get the *source* distribution of Apache, not a binary distribution,
  21.    from "http://www.apache.org/dist/".  Unpack it.
  22.  
  23. 2) Copy mod_servlet.c into the Apache src directory.
  24.  
  25. 3) Follow the instructions in the Apache src/INSTALL file:
  26.   3a) Edit Configuration, setting your system customizations as the
  27.       comments direct, and adding this to the list of modules:
  28.       Module servlet_module          mod_servlet.o
  29.   3b) Configure
  30.   3c) make
  31.  
  32. 4) Continue with the instructions in the Apache README file:
  33.   4a) Copy the Apache conf/*.dist files to conf/*.conf.
  34.   4b) Edit conf/*.conf, setting your local system configuration.
  35.   4c) Add this to conf/srm.conf:
  36.       <Location /servlet>
  37.       SetHandler servlet-handler
  38.       </Location>
  39.   4d) Add ServletConfig commands if you want to override the defaults:
  40.       ServletConfig JAVA_HOME /opt/local/pkgs/java
  41.       ServletConfig JAVA_EXE java
  42.       ServletConfig JAVA_EXE_PATH /opt/local/pkgs/java/bin/java
  43.       ServletConfig CLASSPATH /opt/local/pkgs/java/lib/classes.zip
  44.       ServletConfig SERVAPI_HOME /opt/local/pkgs/ServAPI
  45.       ServletConfig SERVLET_HOME /opt/local/pkgs/ServAPI/servlets
  46.           ServletConfig SERVLET_CONFIG /opt/local/pkgs/ServAPI/servlets.properties
  47.       ServletConfig NCGI_CLASS sun.servlet.apache.NcgiServletGate
  48.       ServletConfig NCGI_HOST localhost
  49.       ServletConfig NCGI_PORT 31461
  50.       ServletConfig NCGI_AUTHFILE /tmp/ncgiauth
  51.   4e) Start apache.  You should be able to run the module via
  52.       a "/servlet" URL
  53.  
  54. The Apache home page is http://www.apache.org/
  55. The Apache module API is documented at http://www.apache.org/docs/API.html
  56. The Apache Module Registry: http://www.zyzzyva.com/server/module_registry/
  57. The JavaWebServer home page is http://jserv.javasoft.com
  58.  
  59.  
  60. Configuring Servlets
  61. --------------------
  62.  
  63. Configuring servlets is done through the servlet properties file specified
  64. by the SERVLET_CONFIG option.  The format of this file is explained in the
  65. README file.
  66.  
  67.  
  68. Compiling Servlets
  69. ------------------
  70.  
  71. If you have set up your CLASSPATH variable to include both the standard
  72. Java classes and the Servlet API classes, you should be able to compile
  73. your servlets like any other Java programs.
  74.  
  75.  
  76. Locating the Documentation
  77. --------------------------
  78.  
  79. HTML documentation is in the doc/ directory.  The API documentation is
  80. in doc/apidoc/packages.html
  81.  
  82. Documentation will also be available at the JavaServer home page. Any future
  83. updates to the documentation will be posted to the JavaServer home page.
  84.  
  85. Limitations
  86. -----------
  87.  
  88. Due to incompatable changes to the module API in Apache version 1.2beta,
  89. the servlet module will only run in version 1.1.3.  
  90.  
  91.  
  92. Contacting Us
  93. -------------
  94.  
  95. If you have any comments on this JSDK release then please send email to
  96. java-server-feedback@javasoft.com
  97.  
  98.