cvs commit: jakarta-tomcat/proposals/web-connector/native README

[hg...@apache.org]

hgomez      01/05/03 06:50:13

  Added:       proposals/web-connector/native README
  Log:
  Initial readme
  
  Revision  Changes    Path
  1.1                  jakarta-tomcat/proposals/web-connector/native/README
  
  Index: README
  ===================================================================
  README for web-connector
  
  $Id: README,v 1.1 2001/05/03 13:50:11 hgomez Exp $
  
  Please see doc/mod_jk-howto.html for more verbose instructions
  
  * What is web-connector ?
  
  web-connector is a new project to release web-servers connector
  for the jakarta Tomcat servlet engine.
  
  This project didn't start from null since it reuse the latest code from
  mod_jk for the native parts and tomcat 3.3 for the java side of the 
  force.
  
  From mod_jk we gain :
  
  * A connector (plugin) for many Web Server, including
    Apache HTTP Server, Netscape/IPLanet NES and Microsoft IIS
    It also support JNI (and seems to used at least by IBM under 
    AS/400 for Apache/WebSphere connectivity).
    
  * Fault-tolerance and load-balancing. mod_jk use the concept of 
    workers which handle a particular request, and a special worker
    , the lb worker, is a group (cluster ?) of physical workers.
  
  * Direct access to Tomcat 3.2/3.3 servlet engine via ajp12/ajp13
    protocol. 
  
  * OK, then how do I build web-connector ?
  
  For Unix:
  
  Change to the apache1.3 or apache2.0 directory,
  depending on which version of Apache you are running.
  
  Execute "./build-unix.sh"  This script sets some environment variables
  and then calls Apache's apxs script to do the actual compile.
  
  If this doesn't work, please check the source for build-unix.sh.  You
  may have to edit some variables.
  
  Alternately, you may have more luck with the makefiles.  Execute them
  with e.g. "make -f Makefile.linux mod_jk.so"
  
  For Windows:
  
  [need more info feel free to contact me]
  
  * How do I install mod_jk.so?
  
  Copy mod_jk.so into your APACHE_HOME/libexec
  
  Add the following line to APACHE_HOME/conf/httpd.conf.  Replace
  "TOMCAT_HOME" with the actual directory name.
  
     Include TOMCAT_HOME/conf/mod_jk.conf-auto
  
  That's it!
  
  When Tomcat starts, it automatically writes out mod_jk.conf-auto based
  on your server.xml settings.  If this is inadequate for your needs,
  you can copy mod_jk.conf-auto to a new file called "mod_jk.conf" and
  then change httpd.conf to read
  
     Include TOMCAT_HOME/conf/mod_jk.conf
  
  Note that Tomcat must be started *before* Apache for mod_jk to
  initialize correctly.  Since "tomcat.sh start" launches Tomcat in the
  background, you may have to do something like the following in your
  startup script:
  
  	cd $TOMCAT_HOME/bin
  	./tomcat.sh start
  	sleep 4
  	$APACHE_HOME/bin/apachectl start
  
  [Note: apachectl should be run as root, but Tomcat should be run as a
  local user; this means that the above script would lead to a security
  problem. Any suggestions to fix?]
  
  * Where do I report bugs/errors?
   
  See http://jakarta.apache.org/getinvolved/mail.html and
  http://jakarta.apache.org/bugs/index.html for information.
  
  ---
  Credits:
  mod_jk written by Gal Shachor and many others
  README and .sh scripts written by Alex Chaffee