cvs commit: jakarta-tomcat-connectors/jk/doc mod_jk-howto.html

[hg...@apache.org]

hgomez      01/06/22 07:44:53

  Modified:    jk/doc   mod_jk-howto.html
  Log:
  Updated mod_jk documentation. Add in FAQ the explanation
  about EAPI/STD, garbled and might crash !
  
  Revision  Changes    Path
  1.3       +24 -2     jakarta-tomcat-connectors/jk/doc/mod_jk-howto.html
  
  Index: mod_jk-howto.html
  ===================================================================
  RCS file: /home/cvs/jakarta-tomcat-connectors/jk/doc/mod_jk-howto.html,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- mod_jk-howto.html	2001/05/18 16:30:15	1.2
  +++ mod_jk-howto.html	2001/06/22 14:44:52	1.3
  @@ -794,6 +794,8 @@
   Tomcat 3.3. The Binary Distributions of mod_jk are available at the same
   location as the Binary Distribution of Tomcat.  The mod_jk binaries are
   located in subdirectories by platform.
  +But in May 2001, the jakarta-tomcat-connectors was started and you'll find here
  +up to date featured mod_jk (ie: new protocols AJP14/WARP) 
   
   <h3>Q. Which protocol should I use? Ajp12 or Ajp13?</h3>
   A. Ajp13 is a newer protocol, it's faster, and it works better with SSL. You almost
  @@ -801,8 +803,28 @@
   <a href="Tomcat-Workers-HowTo.html">workers.properties howto</a> document.
   
   <h3>Q. Whenever I restart Tomcat, Apache locks up!</h3>
  -A. The Ajp13 protocol keeps an open socket between Tomcat and Apache. When you restart
  -Tomcat, you need to restart Apache as well.
  +A. The Ajp13 protocol keeps an open socket between Tomcat and Apache. The latest
  +release of mod_jk (the one found since Tomcat 3.3-m2 and J-T-C) handle the network failure.
  +But with previous release of mod_jk, you may have to restart Apache as well.
  +
  +<h3>Q. Why did exist two files mod_jk.so (-eapi ad -noeapi) in download dir for Linux ?</h3>
  +A. Many versions of Apache use of modified API, known at Extended API. For example,
  +Apache using mod_ssl or Apache present in certains recent Linux distributions.
  +So if you got such 'Extended Apache', you need to use mod_jk.so-eapi, or use
  +mod_jk.so-noeapi for standard Apache. It's wise to avoid using EAPI modules on STD API Apache or to use standard
  +API modules on EAPI Apache. Allways be sure to have the mod_jk.so for your version of Apache  
  +
  +
  +<h3>Q. What's that message about 'garbled DSO ?'</h3>
  +A. It's related to Apache EAPI, the message 'mod_jk.so is garbled - perhaps this is not an Apache module DSO ?'
  +just told you are trying to install a mod_jk.so DSO module that was compiled on an Apache using EAPI, 
  +like apache-mod_ssl or apache from Redhat distro 6.2/7.0 but your system use the standard apache 
  +with normal API.
  +
  +<h3>Q. And the message about 'module might crash under EAPI! '</h3>
  +A. Also related to EAPI, the message '[warn] Loaded DSO /usr/lib/apache/mod_jk.so uses plain Apache 1.3 API, 
  +this module might crash under EAPI! (please recompile it with -DEAPI)', the mod_jk.so was compiled under normal 
  +Apache with standard API and you try to install the module on an Apache using EAPI. 
   
   <h3>Q. Where can I get more information?</h3>
   A. The <a href="Tomcat-Workers-HowTo.html">workers.properties howto</a> document has