tomcat-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject cvs commit: jakarta-tomcat/proposals/web-connector/native README
Date Thu, 03 May 2001 13:50:13 GMT
hgomez      01/05/03 06:50:13

  Added:       proposals/web-connector/native README
  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 
  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
  * 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 "./"  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  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"
  For Windows:
  [need more info feel free to contact me]
  * How do I install
  Copy 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 " start" launches Tomcat in the
  background, you may have to do something like the following in your
  startup script:
  	cd $TOMCAT_HOME/bin
  	./ 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 and for information.
  mod_jk written by Gal Shachor and many others
  README and .sh scripts written by Alex Chaffee

View raw message