rubbos/app/tomcat-connectors-1.2.32-src/docs/generic_howto/quick.html

   1 <html><head><META http-equiv="Content-Type" content="text/html; charset=iso-8859-1"><title>The Apache Tomcat Connector - Generic HowTo - Quick Start HowTo</title><meta name="author" value="Henri Gomez"><meta name="email" value="hgomez@apache.org"><link href="../style.css" type="text/css" rel="stylesheet"></head><body bgcolor="#ffffff" text="#000000" link="#525D76" alink="#525D76" vlink="#525D76"><table border="0" width="100%" cellspacing="4"><!--PAGE HEADER--><tr><td colspan="2"><!--TOMCAT LOGO--><a href="http://tomcat.apache.org/"><img src="../images/tomcat.gif" align="left" alt="Apache Tomcat" border="0"></a><!--APACHE LOGO--><a href="http://www.apache.org/"><img src="http://www.apache.org/images/asf-logo.gif" align="right" alt="Apache Logo" border="0"></a></td></tr><!--HEADER SEPARATOR--><tr><td colspan="2"><hr noshade size="1"></td></tr><tr><!--LEFT SIDE NAVIGATION--><td width="20%" valign="top" nowrap="true"><p><strong>Links</strong></p><ul><li><a href="../index.html">Docs Home</a></li></ul><p><strong>Reference Guide</strong></p><ul><li><a href="../reference/workers.html">workers.properties</a></li><li><a href="../reference/uriworkermap.html">uriworkermap.properties</a></li><li><a href="../reference/status.html">Status Worker</a></li><li><a href="../reference/apache.html">Apache HTTP Server</a></li><li><a href="../reference/iis.html">IIS</a></li></ul><p><strong>Generic HowTo</strong></p><ul><li><a href="../generic_howto/quick.html">For the impatient</a></li><li><a href="../generic_howto/workers.html">All about workers</a></li><li><a href="../generic_howto/timeouts.html">Timeouts</a></li><li><a href="../generic_howto/loadbalancers.html">Load Balancing</a></li><li><a href="../generic_howto/proxy.html">Reverse Proxy</a></li></ul><p><strong>Webserver HowTo</strong></p><ul><li><a href="../webserver_howto/apache.html">Apache HTTP Server</a></li><li><a href="../webserver_howto/iis.html">IIS</a></li><li><a href="../webserver_howto/nes.html">Netscape/SunOne/Sun</a></li></ul><p><strong>AJP Protocol Reference</strong></p><ul><li><a href="../ajp/ajpv13a.html">AJPv13</a></li><li><a href="../ajp/ajpv13ext.html">AJPv13 Extension Proposal</a></li></ul><p><strong>Miscellaneous Documentation</strong></p><ul><li><a href="../miscellaneous/faq.html">Frequently asked questions</a></li><li><a href="../miscellaneous/changelog.html">Changelog</a></li><li><a href="http://issues.apache.org/bugzilla/buglist.cgi?query_format=advanced&amp;short_desc_type=allwordssubstr&amp;short_desc=&amp;product=Tomcat+Connectors&amp;long_desc_type=substring&amp;long_desc=&amp;bug_file_loc_type=allwordssubstr&amp;bug_file_loc=&amp;keywords_type=allwords&amp;keywords=&amp;bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED&amp;emailassigned_to1=1&amp;emailtype1=substring&amp;email1=&amp;emailassigned_to2=1&amp;emailreporter2=1&amp;emailcc2=1&amp;emailtype2=substring&amp;email2=&amp;bugidtype=include&amp;bug_id=&amp;votes=&amp;chfieldfrom=&amp;chfieldto=Now&amp;chfieldvalue=&amp;cmdtype=doit&amp;order=Reuse+same+sort+as+last+time&amp;field0-0-0=noop&amp;type0-0-0=noop&amp;value0-0-0=">Current Tomcat Connectors bugs</a></li><li><a href="../miscellaneous/doccontrib.html">Contribute documentation</a></li><li><a href="../miscellaneous/jkstatustasks.html">JK Status Ant Tasks</a></li><li><a href="../miscellaneous/reporttools.html">Reporting Tools</a></li><li><a href="http://tomcat.apache.org/connectors-doc-archive/jk2/index.html">Old JK/JK2 documentation</a></li></ul><p><strong>News</strong></p><ul><li><a href="../news/20110701.html">2011</a></li><li><a href="../news/20100101.html">2010</a></li><li><a href="../news/20090301.html">2009</a></li><li><a href="../news/20081001.html">2008</a></li><li><a href="../news/20070301.html">2007</a></li><li><a href="../news/20060101.html">2006</a></li><li><a href="../news/20050101.html">2005</a></li><li><a href="../news/20041100.html">2004</a></li></ul></td><!--RIGHT SIDE MAIN BODY--><td width="80%" valign="top" align="left"><table border="0" width="100%" cellspacing="4"><tr><td align="left" valign="top"><h1>The Apache Tomcat Connector - Generic HowTo</h1><h2>Quick Start HowTo</h2></td><td align="right" valign="top" nowrap="true"><small><a href="printer/quick.html"><img src="../images/printer.gif" border="0" alt="Printer Friendly Version"><br>print-friendly<br>version
   2                     </a></small></td></tr></table><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Introduction"><strong>Introduction</strong></a></font></td></tr><tr><td><blockquote>
   3 <p>
   4   This document describes the configuration files used by JK on the
   5   Web Server side for the 'impatient':
   6     <ul>
   7     <li>
   8     <b>workers.properties</b> is a mandatory file used by the webserver and which
   9     is the same for all JK implementations (Apache/IIS/NES).
  10     </li>
  11     <li>
  12     <b>web server</b> add-ons to be set on the webserver side.
  13     </li>
  14     </ul>
  15 </p>
  16 <p>
  17   We'll give here minimum servers configuration and an example <b>workers.properties</b>
  18   to be able to install and check quickly your configuration.
  19 </p>
  20 </blockquote></td></tr></table><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Minimum workers.properties"><strong>Minimum workers.properties</strong></a></font></td></tr><tr><td><blockquote>
  21 <p>
  22     Here is a minimum <b>workers.properties</b>, using just ajp13 to connect your Apache webserver
  23     to the Tomcat engine, complete documentation is available in <a href="workers.html">Workers HowTo</a>.
  24 </p>
  25 <p>
  26 <div class="example"><pre>
  27
  28   # Define 1 real worker using ajp13
  29   worker.list=worker1
  30   # Set properties for worker1 (ajp13)
  31   worker.worker1.type=ajp13
  32   worker.worker1.host=localhost
  33   worker.worker1.port=8009
  34
  35 </pre></div>
  36 </p>
  37 </blockquote></td></tr></table><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Minimum Apache web server configuration"><strong>Minimum Apache web server configuration</strong></a></font></td></tr><tr><td><blockquote>
  38 <p>
  39    Here is a minimum information about Apache configuration, a
  40    more complete <a href="../webserver_howto/apache.html">separate HowTo for Apache</a> is available.
  41 </p>
  42 <p>
  43   You should first have <b>mod_jk.so</b> (unix) or <b>mod_jk.dll</b> (Windows) installed
  44   in your Apache module directory (see your Apache documentation to locate it).
  45 </p>
  46 <p>
  47   Usual locations for modules directory on Unix:
  48   <ul>
  49   <li>/usr/lib/apache/</li>
  50   <li>/usr/lib/apache2/</li>
  51   <li>/usr/local/apache/libexec/</li>
  52   </ul>
  53 </p>
  54 <p>
  55   Usual locations for modules directory on Windows :
  56   <ul>
  57   <li>C:\Program Files\Apache Group\Apache\modules\</li>
  58   <li>C:\Program Files\Apache Group\Apache2\modules\</li>
  59   </ul>
  60 </p>
  61 <p>
  62   You'll find a link to prebuilt binaries
  63         <a href="http://tomcat.apache.org/download-connectors.cgi/">here</a>
  64 </p>
  65 <p>
  66     Here is the minimum which should be set in <b>httpd.conf</b> directly or
  67     included from another file:
  68 </p>
  69 <p>
  70   Usual locations for configuration directory on Unix:
  71   <ul>
  72   <li>/etc/httpd/conf/</li>
  73   <li>/etc/httpd2/conf/</li>
  74   <li>/usr/local/apache/conf/</li>
  75   </ul>
  76 </p>
  77 <p>
  78   Usual locations for configuration directory on Windows :
  79   <ul>
  80   <li>C:\Program Files\Apache Group\Apache\conf\</li>
  81   <li>C:\Program Files\Apache Group\Apache2\conf\</li>
  82   </ul>
  83 </p>
  84 <p>
  85 <div class="example"><pre>
  86
  87   # Load mod_jk module
  88   # Update this path to match your modules location
  89   LoadModule    jk_module  libexec/mod_jk.so
  90   # Declare the module for &lt;IfModule directive&gt; (remove this line on Apache 2.x)
  91   AddModule     mod_jk.c
  92   # Where to find workers.properties
  93   # Update this path to match your conf directory location (put workers.properties next to httpd.conf)
  94   JkWorkersFile /etc/httpd/conf/workers.properties
  95   # Where to put jk shared memory
  96   # Update this path to match your local state directory or logs directory
  97   JkShmFile     /var/log/httpd/mod_jk.shm
  98   # Where to put jk logs
  99   # Update this path to match your logs directory location (put mod_jk.log next to access_log)
 100   JkLogFile     /var/log/httpd/mod_jk.log
 101   # Set the jk log level [debug/error/info]
 102   JkLogLevel    info
 103   # Select the timestamp log format
 104   JkLogStampFormat "[%a %b %d %H:%M:%S %Y] "
 105   # Send everything for context /examples to worker named worker1 (ajp13)
 106   JkMount  /examples/* worker1
 107
 108 </pre></div>
 109 </p>
 110 </blockquote></td></tr></table><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Minimum IIS web server configuration"><strong>Minimum IIS web server configuration</strong></a></font></td></tr><tr><td><blockquote>
 111 <p>
 112   A separate <a href="../webserver_howto/iis.html">HowTo for the IIS web server</a> is available.
 113 </p>
 114 <p class="todo">
 115       This paragraph has not been written yet, but <b>you</b> can contribute to it.
 116       </p>
 117 </blockquote></td></tr></table><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Minimum NES/iPlanet/Sun web server configuration"><strong>Minimum NES/iPlanet/Sun web server configuration</strong></a></font></td></tr><tr><td><blockquote>
 118 <p>
 119   A separate <a href="../webserver_howto/nes.html">HowTo for the Netscape/iPlanet/Sun web server</a> is available.
 120 <p class="todo">
 121       This paragraph has not been written yet, but <b>you</b> can contribute to it.
 122       </p>
 123 </p>
 124 </blockquote></td></tr></table><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Test your configuration"><strong>Test your configuration</strong></a></font></td></tr><tr><td><blockquote>
 125 <p>
 126   (Re)start the web server and browse to the <a href="http://localhost/examples/">http://localhost/examples/</a>
 127 </p>
 128
 129 </blockquote></td></tr></table></td></tr><!--FOOTER SEPARATOR--><tr><td colspan="2"><hr noshade size="1"></td></tr><!--PAGE FOOTER--><tr><td colspan="2"><div align="center"><font color="#525D76" size="-1"><em>
 130         Copyright &copy; 1999-2011, Apache Software Foundation
 131         </em></font></div></td></tr></table></body></html>