You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tomcat.apache.org by cs...@apache.org on 2018/12/14 17:45:50 UTC
svn commit: r1848964 [9/25] - in /tomcat/site/trunk/docs/connectors-doc: ./
ajp/ ajp/printer/ common_howto/ common_howto/printer/ images/ images/fonts/
miscellaneous/ miscellaneous/printer/ news/ news/printer/ printer/
reference/ reference/printer/ web...
Modified: tomcat/site/trunk/docs/connectors-doc/miscellaneous/printer/doccontrib.html
URL: http://svn.apache.org/viewvc/tomcat/site/trunk/docs/connectors-doc/miscellaneous/printer/doccontrib.html?rev=1848964&r1=1848963&r2=1848964&view=diff
==============================================================================
--- tomcat/site/trunk/docs/connectors-doc/miscellaneous/printer/doccontrib.html (original)
+++ tomcat/site/trunk/docs/connectors-doc/miscellaneous/printer/doccontrib.html Fri Dec 14 17:45:49 2018
@@ -1,4 +1,35 @@
-<html><head><META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>The Apache Tomcat Connectors - Miscellaneous Documentation - How to Contribute to the Documentation</title><meta name="author" value="Robert Sowders"><meta name="email" value="rsowders@usgs.gov"><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 Software Foundation" border="0"></a></td></tr><!--HEADER SEPARATOR--><tr><td colspan="2"><hr noshade size="1"></td></tr><tr><!--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 Connectors - Miscellaneous Documentation</h1><h2>How to Contribute to the Documentation</h2></td><td align="right" valign="top" nowrap="true"><img src="../../images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0" alt=" "></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>
+<!DOCTYPE html SYSTEM "about:legacy-compat">
+<html lang="en"><head><META http-equiv="Content-Type" content="text/html; charset=UTF-8"><link href="../../images/docs-stylesheet.css" rel="stylesheet" type="text/css"><title>The Apache Tomcat Connectors: mod_jk, ISAPI redirector, NSAPI redirector (1.2.x) - How to Contribute to the Documentation</title><meta name="author" content="Robert Sowders"><script type="application/javascript" data-comments-identifier="">
+ "use strict"; // Enable strict mode
+
+ (function() {
+ var thisScript = document.currentScript;
+ if (!thisScript) { // Workaround for IE <= 11
+ var scripts = document.getElementsByTagName("script");
+ thisScript = scripts[scripts.length - 1];
+ }
+ document.addEventListener("DOMContentLoaded", (function() {
+ var commentsDiv = document.getElementById("comments_thread");
+ var commentsShortname = "tomcat";
+ var commentsIdentifier = "https://tomcat.apache.org/" +
+ thisScript.getAttribute("data-comments-identifier") + ".html";
+
+ (function(w, d) {
+ if (w.location.hostname.toLowerCase() == "tomcat.apache.org") {
+ var s = d.createElement("script");
+ s.type = "application/javascript";
+ s.async = true;
+ s.src = "https://comments.apache.org/show_comments.lua?site=" +
+ encodeURIComponent(commentsShortname) +
+ "&page=" + encodeURIComponent(commentsIdentifier);
+ d.head.appendChild(s);
+ } else {
+ commentsDiv.appendChild(d.createTextNode("Comments are disabled for this page at the moment."));
+ }
+ })(window, document);
+ }), false);
+ })();
+ </script></head><body><div id="wrapper"><header><div id="header"><div><div><div class="logo noPrint"><a href="http://tomcat.apache.org/"><img alt="Tomcat Home" src="../../images/tomcat.png"></a></div><div style="height: 1px;"></div><div class="asfLogo noPrint"><a href="https://www.apache.org/" target="_blank"><img src="../../images/asf-logo.svg" alt="The Apache Software Foundation" style="width: 266px; height: 83px;"></a></div><h1>The Apache Tomcat Connectors: mod_jk, ISAPI redirector, NSAPI redirector</h1><div style="height: 1px;"></div><div style="clear: left;"></div></div></div></div></header><div id="middle"><div><div id="mainLeft" class="noprint"><div><nav><div><h2>Links</h2><ul><li><a href="index.html">Docs Home</a></li></ul></div><div><h2>Common HowTo</h2><ul><li><a href="common_howto/quick.html">For the impatient</a></li><li><a href="common_howto/workers.html">All about workers</a></li><li><a href="common_howto/timeouts.html">Timeouts</a></li><li><a href="common_howto/load
balancers.html">Load Balancing</a></li><li><a href="common_howto/proxy.html">Reverse Proxy</a></li></ul></div><div><h2>Web Server HowTo</h2><ul><li><a href="webserver_howto/apache.html">Apache HTTP Server (mod_jk)</a></li><li><a href="webserver_howto/iis.html">Microsoft IIS (ISAPI redirector)</a></li><li><a href="webserver_howto/nes.html">iPlanet Web Server (NSAPI redirector)</a></li></ul></div><div><h2>Reference Guide</h2><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 (mod_jk)</a></li><li><a href="reference/iis.html">Microsoft IIS (ISAPI redirector)</a></li></ul></div><div><h2>AJP Protocol Reference</h2><ul><li><a href="ajp/ajpv13a.html">AJPv13 (ajp13)</a></li><li><a href="ajp/ajpv13ext.html">AJPv13 Extension Proposal</a></li></ul></div><div><h2>Miscellaneous Documentation</h2>
<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&short_desc_type=allwordssubstr&short_desc=&product=Tomcat+Connectors&long_desc_type=substring&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&keywords_type=allwords&keywords=&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&emailassigned_to1=1&emailtype1=substring&email1=&emailassigned_to2=1&emailreporter2=1&emailcc2=1&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Reuse+same+sort+as+last+time&field0-0-0=noop&type0-0-0=noop&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></div><div><h2>News</h2><ul><li><a href="news/20180301.html">2018</a></li><li><a href="news/20160901.html">2016</a></li><li><a href="news/20150101.html">2015</a></li><li><a href="news/20140201.html">2014</a></li><li><a href="news/20120301.html">2012</a></li><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></div></nav></div></div><div id="mainRight"><div id="content"><h2>How to Contribute to the Documentation</h2><h3 i
d="Introduction">Introduction</h3><div class="text">
<p>
This document describes how you can easily contribute to the
documentation. I'm going to try to make it easy for everyone to help out with
@@ -27,11 +58,11 @@ html.
</li>
</ul>
</p>
-</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="Getting Started Step by Step"><strong>Getting Started Step by Step</strong></a></font></td></tr><tr><td><blockquote>
+</div><h3 id="Getting_Started_Step_by_Step">Getting Started Step by Step</h3><div class="text">
<p>
After you get these tools they are simple to set up.
</p>
- <table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="STEP 1. Get Ant"><strong>STEP 1. Get Ant</strong></a></font></td></tr><tr><td><blockquote>
+ <div class="subsection"><h4 id="STEP_1._Get_Ant">STEP 1. Get Ant</h4><div class="text">
<p>
Install <a href="http://ant.apache.org/">Ant</a>. The only advice I
have is to choose a simple installation path. Now set an environment variable
@@ -47,8 +78,8 @@ able to see a file called <b>build.xml</
<b>build.xml</b> file there is a target named <b>all</b> that will be used to build
the docs.
</p>
-</blockquote></td></tr></table>
-<table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="STEP 2. Get the sources"><strong>STEP 2. Get the sources</strong></a></font></td></tr><tr><td><blockquote>
+</div></div>
+<div class="subsection"><h4 id="STEP_2.__Get_the_sources">STEP 2. Get the sources</h4><div class="text">
<p>
Get the sources for
<a href="http://svn.apache.org/repos/asf/tomcat/jk/trunk/">tomcat-connectors</a>
@@ -66,33 +97,55 @@ your <b>SVN_HOME</b>. Mine is located i
<p>
Run the following command to <b>checkout</b> the sources for the first time.
You should only need to do this once.
-<p class="screen"><div align="left"><table width="80%" border="1" cellspacing="0" cellpadding="2" bgcolor="#000000"><tr><td bgcolor="#000000" align="left"><code class="screen"><nobr> </nobr></code><br><code class="screen"><nobr>C:\build\>svn checkout http://svn.apache.org/repos/asf/tomcat/jk/trunk/
-tomcat-connectors</nobr></code><br><code class="screen"><nobr> </nobr></code><br></td></tr></table></div></p>
+<div class="codeBox"><pre><code>C:\build\>svn checkout http://svn.apache.org/repos/asf/tomcat/jk/trunk/
+tomcat-connectors
+</code></pre></div>
</p>
<p>
You should now be watching all the downloads come in. Now that you have
the sources on your machine the hard part is over. From now on, to update your
sources all you have to do is cd into any directory in your repository and run
the <b>svn update</b> command.
- <p class="screen"><div align="left"><table width="80%" border="1" cellspacing="0" cellpadding="2" bgcolor="#000000"><tr><td bgcolor="#000000" align="left"><div class="screen"> To update your xdocs directory simply cd into the xdocs directory
-and:</div><code class="screen"><nobr>C:\build\tomcat-connectors\>cd xdocs</nobr></code><br><code class="screen"><nobr>C:\build\tomcat-connectors\xdocs\>svn update</nobr></code><br></td></tr></table></div></p>
+<note>To update your xdocs directory simply cd into the xdocs directory
+and:</note>
+<div class="codeBox"><pre><code>C:\build\tomcat-connectors\> cd xdocs
+C:\build\tomcat-connectors\xdocs\> svn update
+</code></pre></div>
</p>
-</blockquote></td></tr></table>
-<table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="STEP 3. Test your build environment"><strong>STEP 3. Test your build environment</strong></a></font></td></tr><tr><td><blockquote>
+</div></div>
+<div class="subsection"><h4 id="STEP_3.__Test_your_build_environment">STEP 3. Test your build environment</h4><div class="text">
<p>
Open a command prompt window and cd to the directory where you downloaded
the source. Now cd into the xdocs directory so that <b>Ant</b> can see the
<b>build.xml</b> file. Then from a command prompt, run the following:
-<p class="screen"><div align="left"><table width="80%" border="1" cellspacing="0" cellpadding="2" bgcolor="#000000"><tr><td bgcolor="#000000" align="left"><code class="screen"><nobr> </nobr></code><br><code class="screen"><nobr>C:\build\tomcat-connectors>cd xdocs</nobr></code><br><code class="screen"><nobr>C:\build\tomcat-connectors\xdocs>ant all</nobr></code><br><code class="screen"><nobr> </nobr></code><br></td></tr></table></div></p>
+<div class="codeBox"><pre><code>C:\build\tomcat-connectors> cd xdocs
+C:\build\tomcat-connectors\xdocs> ant all
+</code></pre></div>
</p>.
<p>
You should see the ant compiler messages scrolling by rapidly and then stop
with the following:
-<p class="screen"><div align="left"><table width="80%" border="1" cellspacing="0" cellpadding="2" bgcolor="#000000"><tr><td bgcolor="#000000" align="left"><code class="screen"><nobr>[style] Transforming into C:\build\tomcat-connectors\build\docs\news\printer></nobr></code><br><code class="screen"><nobr>[style] Processing C:\build\tomcat-connectors\xdocs\news\20041100.xml
-to</nobr></code><br><code class="screen"><nobr>C:\build\tomcat-connectors\build\docs\news/20041100.html</nobr></code><br><code class="screen"><nobr>[style] Loading stylesheet C:\build\tomcat-connectors\xdocs\style.xsl</nobr></code><br><code class="screen"><nobr>[style] Processing C:\build\tomcat-connectors\xdocs\news\20050101.xml
-to</nobr></code><br><code class="screen"><nobr>C:\build\tomcat-connectors\build\docs\news/20050101.html</nobr></code><br><code class="screen"><nobr>[style] Processing C:\build\tomcat-connectors\xdocs\news\20060101.xml
-to</nobr></code><br><code class="screen"><nobr>C:\build\tomcat-connectors\build\docs\news/20060101.html</nobr></code><br><code class="screen"><nobr>[style] Transforming into C:\build\tomcat-connectors\build\docs></nobr></code><br><code class="screen"><nobr>[style] Processing C:\build\tomcat-connectors\xdocs\index.xml
-to</nobr></code><br><code class="screen"><nobr>C:\build\tomcat-connectors\build\docs\index.html</nobr></code><br><code class="screen"><nobr>[style] Loading stylesheet C:\build\tomcat-connectors\xdocs\style.xsl</nobr></code><br><code class="screen"><nobr> </nobr></code><br><code class="screen"><nobr>BUILD SUCCESSFUL</nobr></code><br><code class="screen"><nobr>Total time: 10 seconds</nobr></code><br><code class="screen"><nobr>C:\build\tomcat-connectors></nobr></code><br></td></tr></table></div></p>
+<div class="codeBox"><pre><code>[style] Transforming into C:\build\tomcat-connectors\build\docs\news\printer>
+[style] Processing C:\build\tomcat-connectors\xdocs\news\20041100.xml
+to
+C:\build\tomcat-connectors\build\docs\news/20041100.html
+[style] Loading stylesheet C:\build\tomcat-connectors\xdocs\style.xsl
+[style] Processing C:\build\tomcat-connectors\xdocs\news\20050101.xml
+to
+C:\build\tomcat-connectors\build\docs\news/20050101.html
+[style] Processing C:\build\tomcat-connectors\xdocs\news\20060101.xml
+to
+C:\build\tomcat-connectors\build\docs\news/20060101.html
+[style] Transforming into C:\build\tomcat-connectors\build\docs>
+[style] Processing C:\build\tomcat-connectors\xdocs\index.xml
+to
+C:\build\tomcat-connectors\build\docs\index.html
+[style] Loading stylesheet C:\build\tomcat-connectors\xdocs\style.xsl
+
+BUILD SUCCESSFUL
+Total time: 10 seconds
+C:\build\tomcat-connectors>
+</code></pre></div>
</p>
<p>
All the xml files present in the xdocs directory structure were transformed
@@ -100,13 +153,18 @@ to html and copied to the <b>SVN_HOME\to
directory. Open one of the
html files in your browser and see how it looks.
</p>
-</blockquote></td></tr></table>
-<table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="STEP 4. The editing process."><strong>STEP 4. The editing process.</strong></a></font></td></tr><tr><td><blockquote>
+</div></div>
+<div class="subsection"><h4 id="STEP_4.___The_editing_process.">STEP 4. The editing process.</h4><div class="text">
<p>
I find it easier to use two windows while doing my updates. One I call my
<b>build</b> window. I keep this one in the <b>SVN_HOME\tomcat-connectors\xdocs</b>
directory and I only run two commands in this window:
-<p class="screen"><div align="left"><table width="80%" border="1" cellspacing="0" cellpadding="2" bgcolor="#000000"><tr><td bgcolor="#000000" align="left"><code class="screen"><nobr> </nobr></code><br><div class="screen"> First I run</div><code class="screen"><nobr>ant clean</nobr></code><br><div class="screen"> Then I run</div><code class="screen"><nobr>ant all</nobr></code><br><code class="screen"><nobr> </nobr></code><br></td></tr></table></div></p>
+<note>First I run</note>
+<div class="codeBox"><pre><code>ant clean
+</code></pre></div>
+<note>Then I run</note>
+<div class="codeBox"><pre><code>ant all
+</code></pre></div>
</p>
<p>
My second window I call my <b>edit</b> window and I keep that one in the
@@ -116,7 +174,10 @@ edits, diffs and svn updates.
<p>
Before you start editing you should always update your local repository to
prevent conflicts.
-<p class="screen"><div align="left"><table width="80%" border="1" cellspacing="0" cellpadding="2" bgcolor="#000000"><tr><td bgcolor="#000000" align="left"><div class="screen"> You only need to update the xdocs directory</div><code class="screen"><nobr>C:\build\tomcat-connectors>cd xdocs</nobr></code><br><code class="screen"><nobr>C:\build\tomcat-connectors\xdocs></nobr></code><br><code class="screen"><nobr>C:\build\tomcat-connectors\xdocs>svn update</nobr></code><br></td></tr></table></div></p>
+<note>You only need to update the xdocs directory</note>
+<div class="codeBox"><pre><code>C:\build\tomcat-connectors> cd xdocs
+C:\build\tomcat-connectors\xdocs> svn update
+</code></pre></div>
</p>
<p>
Now that your repository is up to date you can begin editing. Find
@@ -124,13 +185,15 @@ something in the documentation to edit.
name of the file. In your <b>edit</b> window find and edit the xml source file
with the same name. After you are done return to the <b>build</b> window, and
in the <b>SVN_HOME\tomcat-connectors\xdocs</b> directory run:
-<p class="screen"><div align="left"><table width="80%" border="1" cellspacing="0" cellpadding="2" bgcolor="#000000"><tr><td bgcolor="#000000" align="left"><code class="screen"><nobr> </nobr></code><br><code class="screen"><nobr>C:\build\tomcat-connectors\xdocs> ant clean</nobr></code><br><code class="screen"><nobr> </nobr></code><br></td></tr></table></div></p>
+<div class="codeBox"><pre><code>C:\build\tomcat-connectors\xdocs> ant clean
+</code></pre></div>
</p>
<p>
This will delete all the previous html files and make the area ready for
updated material. Now to make fresh documents that incorporate your changes
run:
-<p class="screen"><div align="left"><table width="80%" border="1" cellspacing="0" cellpadding="2" bgcolor="#000000"><tr><td bgcolor="#000000" align="left"><code class="screen"><nobr> </nobr></code><br><code class="screen"><nobr>C:\build\tomcat-connectors\xdocs>ant all</nobr></code><br><code class="screen"><nobr> </nobr></code><br></td></tr></table></div></p>
+<div class="codeBox"><pre><code>C:\build\tomcat-connectors\xdocs> ant all
+</code></pre></div>
</p>
<p>
Use your browser to view the edits you just made, they will be in the
@@ -138,15 +201,16 @@ run:
good and is ready to go,
all that is left to do is to create a patch and submit it.
</p>
-</blockquote></td></tr></table>
-<table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="STEP 5. Creating a patch and submitting it."><strong>STEP 5. Creating a patch and submitting it.</strong></a></font></td></tr><tr><td><blockquote>
+</div></div>
+<div class="subsection"><h4 id="STEP_5.__Creating_a_patch_and_submitting_it.">STEP 5. Creating a patch and submitting it.</h4><div class="text">
<p>
From your <b>edit</b> window cd into the directory that contains the xml
file you are working on, and run the <b>svn update</b> command. For example,
to produce a diff of the index.xml file and call it patch.txt, you
would cd into the directory containing the index.xml file and:
-<p class="screen"><div align="left"><table width="80%" border="1" cellspacing="0" cellpadding="2" bgcolor="#000000"><tr><td bgcolor="#000000" align="left"><code class="screen"><nobr>C:\build\tomcat-connectors\xdocs\>svn diff index.xml >
-patch.txt.</nobr></code><br><code class="screen"><nobr> </nobr></code><br></td></tr></table></div></p>
+<div class="codeBox"><pre><code>C:\build\tomcat-connectors\xdocs\>svn diff index.xml >
+patch.txt.
+</code></pre></div>
</p>
<p>
Now that you have your patch you are ready to send it in.
@@ -161,8 +225,8 @@ account. At the web site paste your pat
to describe what it is your patch is for. Sooner or later a someone with
commit privileges will review your suggestion.
</p>
-</blockquote></td></tr></table>
-</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="Subversion Basics"><strong>Subversion Basics</strong></a></font></td></tr><tr><td><blockquote>
+</div></div>
+</div><h3 id="Subversion_Basics">Subversion Basics</h3><div class="text">
<p>
After you have checked out the sources the first time it is much easier to
use subversion. You can cd into any directory of the repository and run <b>svn
@@ -203,7 +267,7 @@ for >>>> and merge the chan
system which are not part of the repository. You will normally see this when
you are creating new files for submission.
</p>
-</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="Updating Web site"><strong>Updating Web site</strong></a></font></td></tr><tr><td><blockquote>
+</div><h3 id="Updating_Web_site">Updating Web site</h3><div class="text">
<p>
Only Committers are able to update the web site (http://tomcat.apache.org/connectors-doc/).
To do it:
@@ -217,7 +281,7 @@ you are creating new files for submissio
<li>The changes need around 4 hours to be synced to tomcat.apache.org.</li>
</ul>
</p>
-</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="Guides and Resources"><strong>Guides and Resources</strong></a></font></td></tr><tr><td><blockquote>
+</div><h3 id="Guides_and_Resources">Guides and Resources</h3><div class="text">
<p>
A little help to get you started if you need it
</p>
@@ -243,6 +307,18 @@ Writing Guide</a>
<a href="http://svn.apache.org/repos/asf/tomcat/jk/trunk/xdocs/">JK Docs repository</a>
</li>
</ul>
-</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>
- Copyright © 1999-2018, Apache Software Foundation
- </em></font></div></td></tr></table></body></html>
\ No newline at end of file
+</div><div class="noprint"><h3 id="comments_section">
+ Comments
+ </h3><div class="text"><p class="notice"><strong>Notice:</strong> This comments section collects your suggestions
+ on improving documentation for Apache Tomcat.<br><br>
+ If you have trouble and need help, read
+ <a href="https://tomcat.apache.org/findhelp.html">Find Help</a> page
+ and ask your question on the tomcat-users
+ <a href="https://tomcat.apache.org/lists.html">mailing list</a>.
+ Do not ask such questions here. This is not a Q&A section.<br><br>
+ The Apache Comments System is explained <a href="../../comments.html">here</a>.
+ Comments may be removed by our moderators if they are either
+ implemented or considered invalid/off-topic.
+ </p><div id="comments_thread"></div></div></div></div></div></div></div><footer><div id="footer">
+ Copyright © 1999-yyyy, The Apache Software Foundation
+ </div></footer></div></body></html>
\ No newline at end of file
Modified: tomcat/site/trunk/docs/connectors-doc/miscellaneous/printer/faq.html
URL: http://svn.apache.org/viewvc/tomcat/site/trunk/docs/connectors-doc/miscellaneous/printer/faq.html?rev=1848964&r1=1848963&r2=1848964&view=diff
==============================================================================
--- tomcat/site/trunk/docs/connectors-doc/miscellaneous/printer/faq.html (original)
+++ tomcat/site/trunk/docs/connectors-doc/miscellaneous/printer/faq.html Fri Dec 14 17:45:49 2018
@@ -1,8 +1,39 @@
-<html><head><META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>The Apache Tomcat Connectors - Miscellaneous Documentation - FAQ</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 Software Foundation" border="0"></a></td></tr><!--HEADER SEPARATOR--><tr><td colspan="2"><hr noshade size="1"></td></tr><tr><!--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 Connectors - Miscellaneous Documentation</h1><h2>FAQ</h2></td><td align="right" valign="top" nowrap="true"><img src="../../images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0" alt=" "></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="General"><strong>General</strong></a></font></td></tr><tr><td><blockquote>
+<!DOCTYPE html SYSTEM "about:legacy-compat">
+<html lang="en"><head><META http-equiv="Content-Type" content="text/html; charset=UTF-8"><link href="../../images/docs-stylesheet.css" rel="stylesheet" type="text/css"><title>The Apache Tomcat Connectors: mod_jk, ISAPI redirector, NSAPI redirector (1.2.x) - FAQ</title><meta name="author" content="Henri Gomez"><script type="application/javascript" data-comments-identifier="">
+ "use strict"; // Enable strict mode
+
+ (function() {
+ var thisScript = document.currentScript;
+ if (!thisScript) { // Workaround for IE <= 11
+ var scripts = document.getElementsByTagName("script");
+ thisScript = scripts[scripts.length - 1];
+ }
+ document.addEventListener("DOMContentLoaded", (function() {
+ var commentsDiv = document.getElementById("comments_thread");
+ var commentsShortname = "tomcat";
+ var commentsIdentifier = "https://tomcat.apache.org/" +
+ thisScript.getAttribute("data-comments-identifier") + ".html";
+
+ (function(w, d) {
+ if (w.location.hostname.toLowerCase() == "tomcat.apache.org") {
+ var s = d.createElement("script");
+ s.type = "application/javascript";
+ s.async = true;
+ s.src = "https://comments.apache.org/show_comments.lua?site=" +
+ encodeURIComponent(commentsShortname) +
+ "&page=" + encodeURIComponent(commentsIdentifier);
+ d.head.appendChild(s);
+ } else {
+ commentsDiv.appendChild(d.createTextNode("Comments are disabled for this page at the moment."));
+ }
+ })(window, document);
+ }), false);
+ })();
+ </script></head><body><div id="wrapper"><header><div id="header"><div><div><div class="logo noPrint"><a href="http://tomcat.apache.org/"><img alt="Tomcat Home" src="../../images/tomcat.png"></a></div><div style="height: 1px;"></div><div class="asfLogo noPrint"><a href="https://www.apache.org/" target="_blank"><img src="../../images/asf-logo.svg" alt="The Apache Software Foundation" style="width: 266px; height: 83px;"></a></div><h1>The Apache Tomcat Connectors: mod_jk, ISAPI redirector, NSAPI redirector</h1><div style="height: 1px;"></div><div style="clear: left;"></div></div></div></div></header><div id="middle"><div><div id="mainLeft" class="noprint"><div><nav><div><h2>Links</h2><ul><li><a href="index.html">Docs Home</a></li></ul></div><div><h2>Common HowTo</h2><ul><li><a href="common_howto/quick.html">For the impatient</a></li><li><a href="common_howto/workers.html">All about workers</a></li><li><a href="common_howto/timeouts.html">Timeouts</a></li><li><a href="common_howto/load
balancers.html">Load Balancing</a></li><li><a href="common_howto/proxy.html">Reverse Proxy</a></li></ul></div><div><h2>Web Server HowTo</h2><ul><li><a href="webserver_howto/apache.html">Apache HTTP Server (mod_jk)</a></li><li><a href="webserver_howto/iis.html">Microsoft IIS (ISAPI redirector)</a></li><li><a href="webserver_howto/nes.html">iPlanet Web Server (NSAPI redirector)</a></li></ul></div><div><h2>Reference Guide</h2><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 (mod_jk)</a></li><li><a href="reference/iis.html">Microsoft IIS (ISAPI redirector)</a></li></ul></div><div><h2>AJP Protocol Reference</h2><ul><li><a href="ajp/ajpv13a.html">AJPv13 (ajp13)</a></li><li><a href="ajp/ajpv13ext.html">AJPv13 Extension Proposal</a></li></ul></div><div><h2>Miscellaneous Documentation</h2>
<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&short_desc_type=allwordssubstr&short_desc=&product=Tomcat+Connectors&long_desc_type=substring&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&keywords_type=allwords&keywords=&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&emailassigned_to1=1&emailtype1=substring&email1=&emailassigned_to2=1&emailreporter2=1&emailcc2=1&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Reuse+same+sort+as+last+time&field0-0-0=noop&type0-0-0=noop&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></div><div><h2>News</h2><ul><li><a href="news/20180301.html">2018</a></li><li><a href="news/20160901.html">2016</a></li><li><a href="news/20150101.html">2015</a></li><li><a href="news/20140201.html">2014</a></li><li><a href="news/20120301.html">2012</a></li><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></div></nav></div></div><div id="mainRight"><div id="content"><h2>FAQ</h2><h3 id="General">General</h3><div class=
"text">
<p>
General Informations and FAQ about JK
</p>
-<table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Where can I get help/support for JK ?"><strong>Where can I get help/support for JK ?</strong></a></font></td></tr><tr><td><blockquote>
+<div class="subsection"><h4 id="Where_can_I_get_help/support_for_JK_?">Where can I get help/support for JK ?</h4><div class="text">
<p>
The primary mechanism for support is through the JK
documentation included in the doc directory.
@@ -23,40 +54,39 @@ and go
here</a>
to determine how to subscribe to tomcat mailing list.
</p>
-</blockquote></td></tr></table>
+</div></div>
-<table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="I can't find JK anywhere. Where is it?"><strong>I can't find JK anywhere. Where is it?</strong></a></font></td></tr><tr><td><blockquote>
+<div class="subsection"><h4 id="I_can't_find_JK_anywhere._Where_is_it?">I can't find JK anywhere. Where is it?</h4><div class="text">
<p>
Now that JK moved to the <b>tomcat-connectors</b> repository,
the source and the binaries for JK can be downloaded from a mirror at the
<a href="http://tomcat.apache.org/download-connectors.cgi">
Tomcat Connectors (mod_jk, mod_jk2) Downloads</a> page.
</p>
-</blockquote></td></tr></table>
+</div></div>
-<table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="What's the difference between JK and mod_jk ?"><strong>What's the difference between JK and mod_jk ?</strong></a></font></td></tr><tr><td><blockquote>
-<br>
+<div class="subsection"><h4 id="What's_the_difference_between_JK_and_mod_jk_?">What's the difference between JK and mod_jk ?</h4><div class="text">
<p>
<b>JK</b> is a project covering web servers to Tomcat connectors.
</p>
<p>
-<a href="../../webserver_howto/apache.html">Apache HTTP Server</a> support is implemented on JK, using a plugin
+<a href="../webserver_howto/apache.html">Apache HTTP Server</a> support is implemented on JK, using a plugin
called the <b>mod_jk module</b>.
</p>
<p>
-<a href="../../webserver_howto/iis.html">Microsoft IIS</a> support is implemented on JK, using a plugin
+<a href="../webserver_howto/iis.html">Microsoft IIS</a> support is implemented on JK, using a plugin
called the <b>ISAPI redirector</b>.
</p>
<p>
-<a href="../../webserver_howto/nes.html">iPlanet Web Server</a> support is implemented on JK, using a plugin
+<a href="../webserver_howto/nes.html">iPlanet Web Server</a> support is implemented on JK, using a plugin
called the <b>NSAPI redirector</b>.
</p>
-</blockquote></td></tr></table>
+</div></div>
-<table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Where can I get more information ?"><strong>Where can I get more information ?</strong></a></font></td></tr><tr><td><blockquote>
+<div class="subsection"><h4 id="Where_can_I_get_more_information_?">Where can I get more information ?</h4><div class="text">
<p>
For <b>JK 1.2.x</b>, you should read:
</p>
@@ -64,23 +94,23 @@ For <b>JK 1.2.x</b>, you should read:
<ul>
<li>
-<a href="../../common_howto/quick.html">For the impatient</a>
+<a href="../common_howto/quick.html">For the impatient</a>
</li>
<li>
-<a href="../../webserver_howto/apache.html">Apache HTTP Server and JK (mod_jk)</a>
+<a href="../webserver_howto/apache.html">Apache HTTP Server and JK (mod_jk)</a>
</li>
<li>
-<a href="../../webserver_howto/iis.html">Microsoft IIS and JK (ISAPI redirector)</a>
+<a href="../webserver_howto/iis.html">Microsoft IIS and JK (ISAPI redirector)</a>
</li>
<li>
-<a href="../../webserver_howto/nes.html">iPlanet Web Server and JK (NSAPI redirector)</a>
+<a href="../webserver_howto/nes.html">iPlanet Web Server and JK (NSAPI redirector)</a>
</li>
<li>
-<a href="../../common_howto/workers.html">Workers configuration</a>
+<a href="../common_howto/workers.html">Workers configuration</a>
</li>
</ul>
@@ -88,33 +118,33 @@ For <b>JK 1.2.x</b>, you should read:
For more detailed information, have a look at the Reference Guide.
You could also try searching the mailing list archives for "JK" or look at the source.
</p>
-</blockquote></td></tr></table>
+</div></div>
-<table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Which protocol should I use - ajp12, ajp13 or ajp14?"><strong>Which protocol should I use - ajp12, ajp13 or ajp14?</strong></a></font></td></tr><tr><td><blockquote>
+<div class="subsection"><h4 id="Which_protocol_should_I_use_-_ajp12,_ajp13_or_ajp14?">Which protocol should I use - ajp12, ajp13 or ajp14?</h4><div class="text">
<p>
-<a href="../../ajp/ajpv13a.html">ajp13</a> is the standard. The old
+<a href="../ajp/ajpv13a.html">ajp13</a> is the standard. The old
<strong>ajp12 is deprecated</strong> and <strong>ajp14 is experimental</strong>.
</p>
<p>
Also ajp13 is supported by all Apache Tomcat versions starting with Tomcat 3.2
and by other servlet engines like <b>Jetty</b> and <b>JBoss</b>.
</p>
-</blockquote></td></tr></table>
+</div></div>
-<table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="I've got a firewall between my web server and Tomcat which drops ajp13 connections after some time"><strong>I've got a firewall between my web server and Tomcat which drops ajp13 connections after some time</strong></a></font></td></tr><tr><td><blockquote>
+<div class="subsection"><h4 id="I've_got_a_firewall_between_my_web_server_and_Tomcat_which_drops_ajp13_connections_after_some_time">I've got a firewall between my web server and Tomcat which drops ajp13 connections after some time</h4><div class="text">
<p>
The ajp13 protocol uses persistant connections where the traffic could be null if there is no request to be sent to Tomcat.
Firewalls use to drop inactive connections and will make your web server and Tomcat think the connection is valid.
</p>
<p>
Starting with JK 1.2.0, a <b>socket_keepalive</b> property as been added to ajp13 settings, and you should take a look at
-it in <a href="../../common_howto/workers.html">Workers HowTo</a> and
-<a href="../../reference/workers.html">workers.properties reference</a>.
+it in <a href="../common_howto/workers.html">Workers HowTo</a> and
+<a href="../reference/workers.html">workers.properties reference</a>.
If nothing else helps, you can try <b>JkOptions +DisableReuse</b>, but this will have strong performance implications.
</p>
-</blockquote></td></tr></table>
+</div></div>
-<table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Under heavy load, I've got many threads in Tomcat even if my Apache HTTP Server handles much of the load"><strong>Under heavy load, I've got many threads in Tomcat even if my Apache HTTP Server handles much of the load</strong></a></font></td></tr><tr><td><blockquote>
+<div class="subsection"><h4 id="Under_heavy_load,_I've_got_many_threads_in_Tomcat_even_if_my_Apache_HTTP_Server_handles_much_of_the_load">Under heavy load, I've got many threads in Tomcat even if my Apache HTTP Server handles much of the load</h4><div class="text">
<p>
Under heavy load, the Apache HTTP Server creates many children to handle the load,
which will in turn create many connections
@@ -126,23 +156,23 @@ even if they are no more used.
</p>
<p>
To close connections after some time of inactivity you can use <b>connection_pool_timeout</b>,
-for more informations refer to <a href="../../reference/workers.html">workers.properties reference</a>.
+for more informations refer to <a href="../reference/workers.html">workers.properties reference</a>.
</p>
-</blockquote></td></tr></table>
+</div></div>
-</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="Apache HTTP Server"><strong>Apache HTTP Server</strong></a></font></td></tr><tr><td><blockquote>
+</div><h3 id="Apache_HTTP_Server">Apache HTTP Server</h3><div class="text">
<p>
Informations and FAQ about mod_jk and the Apache HTTP Server.
</p>
-<table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Whenever I restart Tomcat, Apache locks up!"><strong>Whenever I restart Tomcat, Apache locks up!</strong></a></font></td></tr><tr><td><blockquote>
+<div class="subsection"><h4 id="Whenever_I_restart_Tomcat,_Apache_locks_up!">Whenever I restart Tomcat, Apache locks up!</h4><div class="text">
<p>
The ajp13 protocol keeps an open socket between Tomcat and Apache.
Release of mod_jk present in Tomcat Connectors handles the network failure.
But with very ancient releases of mod_jk, you may have to restart Apache as well.
</p>
-</blockquote></td></tr></table>
+</div></div>
-<table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Why do there exist two files mod_jk.so (-eapi ad -noeapi) in download directories for Apache 1.3?"><strong>Why do there exist two files mod_jk.so (-eapi ad -noeapi) in download directories for Apache 1.3?</strong></a></font></td></tr><tr><td><blockquote>
+<div class="subsection"><h4 id="Why_do_there_exist_two_files_mod_jk.so_(-eapi_ad_-noeapi)_in_download_directories_for_Apache_1.3?">Why do there exist two files mod_jk.so (-eapi ad -noeapi) in download directories for Apache 1.3?</h4><div class="text">
<p>
Many versions of Apache use a modified API, known at Extended API, developed for use with the
<a href="http://www.modssl.org">mod_ssl module</a>. Starting with Apache 2.0 there is no more difference.
@@ -165,39 +195,47 @@ You should use <b>mod_jk.so-noeapi</b> o
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 <b>mod_jk.so</b> which match your version of Apache.
</p>
-</blockquote></td></tr></table>
+</div></div>
-<table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="What's that message about 'garbled DSO ?'"><strong>What's that message about 'garbled DSO ?'</strong></a></font></td></tr><tr><td><blockquote>
+<div class="subsection"><h4 id="What's_that_message_about_'garbled_DSO_?'">What's that message about 'garbled DSO ?'</h4><div class="text">
<p>
-It's related to Apache EAPI, the message <b class="code">'mod_jk.so is garbled - perhaps this is not an Apache module DSO ?'</b>
+It's related to Apache EAPI, the message <code>'mod_jk.so is garbled - perhaps this is not an Apache module DSO ?'</code>
just told you, that your're 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.
</p>
-</blockquote></td></tr></table>
+</div></div>
-<table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="And the message about 'module might crash under EAPI!"><strong>And the message about 'module might crash under EAPI!</strong></a></font></td></tr><tr><td><blockquote>
+<div class="subsection"><h4 id="And_the_message_about_'module_might_crash_under_EAPI!">And the message about 'module might crash under EAPI!</h4><div class="text">
<p>
-Also related to EAPI, the message <b class="code">'[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)'</b>, the mod_jk.so was compiled under normal
+Also related to EAPI, the message <code>'[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)'</code>, the mod_jk.so was compiled under normal
Apache with standard API and you try to install the module on an Apache using EAPI.
</p>
-</blockquote></td></tr></table>
+</div></div>
-<table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="APXS is getting an error during the build of mod_jk, like rc=0 or rc=255. I tried all of the steps in the build section, what do I do now ?"><strong>APXS is getting an error during the build of mod_jk, like rc=0 or rc=255. I tried all of the steps in the build section, what do I do now ?</strong></a></font></td></tr><tr><td><blockquote>
+<div class="subsection"><h4 id="APXS_is_getting_an_error_during_the_build_of_mod_jk,_like_rc=0_or_rc=255.__I_tried_all_of_the_steps_in_the_build_section,_what_do_I_do_now_?">APXS is getting an error during the build of mod_jk, like rc=0 or rc=255. I tried all of the steps in the build section, what do I do now ?</h4><div class="text">
<p>
APXS is a Perl script that is created when you build the Apache web server from source.
Chances are that if you are getting these errors and you obtained Apache as a binary distribution,
that APXS is not configured correctly for your system.
Your best bet is to get the Apache source from the <a href="http://httpd.apache.org/">Apache HTTP Server homepage</a> and build it yourself.
Use the following for a basic build (read the Apache docs for other options):
-<p class="screen"><div align="left"><table width="80%" border="1" cellspacing="0" cellpadding="2" bgcolor="#000000"><tr><td bgcolor="#000000" align="left"><code><nobr><em class="screen">[user@host] ~ $ </em><b class="screen">cd /usr/local/src</b></nobr></code><br><code><nobr><em class="screen">[user@host] ~ $ </em><b class="screen">gzip -dc apache_1.3.19.tar.gz|tar xvf -</b></nobr></code><br><code><nobr><em class="screen">[user@host] ~ $ </em><b class="screen">cd apache_1.3.19</b></nobr></code><br><code><nobr><em class="screen">[user@host] ~ $ </em><b class="screen">./configure --prefix=/usr/local/apache \</b></nobr></code><br><code><nobr><em class="screen">[user@host] ~ $ </em><b class="screen"> --enable-module=most \</b></nobr></code><br><code><nobr><em class="screen">[user@host] ~ $ </em><b class="screen"> --enable-shared=max</b></nobr></code><br><code><nobr><em class="screen">[user@host] ~ $ </em><b class="screen">make</b></nobr></code><br><code><nobr><em c
lass="screen">[user@host] ~ $ </em><b class="screen">make install</b></nobr></code><br></td></tr></table></div></p>
+<div class="codeBox"><pre><code>[user@host] ~ $ cd /usr/local/src
+[user@host] ~ $ gzip -dc apache_1.3.19.tar.gz|tar xvf -
+[user@host] ~ $ cd apache_1.3.19
+[user@host] ~ $ ./configure --prefix=/usr/local/apache \
+ --enable-module=most \
+ --enable-shared=max
+[user@host] ~ $ make
+[user@host] ~ $ make install
+</code></pre></div>
</p>
<p>
Note: The above steps assume that you downloaded the Apache source and placed it in your /usr/local/src directory.
</p>
-</blockquote></td></tr></table>
+</div></div>
-<table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Apache complains about incorrect module version"><strong>Apache complains about incorrect module version</strong></a></font></td></tr><tr><td><blockquote>
+<div class="subsection"><h4 id="Apache_complains_about_incorrect_module_version">Apache complains about incorrect module version</h4><div class="text">
<p>
Since the Apache API can change between versions, any Apache module contains the
Apache API version used to compile the module. This is called the Magic Module Number.
@@ -214,9 +252,9 @@ with z smaller than y, use the configure
that the module compiled with any 2.x will never be compatible with 2.y for
x different from y. In this case you need to recompile the module.
</p>
-</blockquote></td></tr></table>
+</div></div>
-<table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Does it work for the latest Apache 2.x?"><strong>Does it work for the latest Apache 2.x?</strong></a></font></td></tr><tr><td><blockquote>
+<div class="subsection"><h4 id="Does_it_work_for_the_latest_Apache_2.x?">Does it work for the latest Apache 2.x?</h4><div class="text">
<p>
mod_jk works well with Apache 2.x from 2.0 to 2.4.
</p>
@@ -225,49 +263,50 @@ Important parts of the functionality of
and mod_proxy_balancer. These are part of the standard distribution of Apache 2.2 and 2.4. The new modules do not contain
all features of mod_jk, but on the other hand you get the modules automatically with every new Apache release.
</p>
-</blockquote></td></tr></table>
+</div></div>
-<table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="JNI doesn't work with Apache 1.3"><strong>JNI doesn't work with Apache 1.3</strong></a></font></td></tr><tr><td><blockquote>
-<p><font color="#ff0000">JNI workers have been deprecated. They will likely not work. Do not use them.</font></p>
+<div class="subsection"><h4 id="JNI_doesn't_work_with_Apache_1.3">JNI doesn't work with Apache 1.3</h4><div class="text">
+<warn>JNI workers have been deprecated. They will likely not work. Do not use them.</warn>
<p>
JNI support requires a multi-threaded environment which is not the general case for Apache 1.3.
You should verify if Apache 1.3 has been build with thread support and if not you could add the
the pthreads library to your <b>httpd.conf</b> file.
</p>
-<div class="example"><pre>
- # Add pthread to Apache in httpd.conf
- LoadModule "/usr/lib/libpthreads.so"
-</pre></div>
+<div class="codeBox"><pre><code># Add pthread to Apache in httpd.conf
+LoadModule "/usr/lib/libpthreads.so"
+</code></pre></div>
<p>
Also keep in mind that JNI is suited for multi-threaded servers and you should consider upgrading
to Apache 2.x to support JNI.
</p>
-</blockquote></td></tr></table>
+</div></div>
-<table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="JNI report that JVM couldn't be started under Linux"><strong>JNI report that JVM couldn't be started under Linux</strong></a></font></td></tr><tr><td><blockquote>
-<p><font color="#ff0000">JNI workers have been deprecated. They will likely not work. Do not use them.</font></p>
+<div class="subsection"><h4 id="JNI_report_that_JVM_couldn't_be_started_under_Linux">JNI report that JVM couldn't be started under Linux</h4><div class="text">
+<warn>JNI workers have been deprecated. They will likely not work. Do not use them.</warn>
<p>
Under Linux, you should set some environment variables BEFORE launching your Apache HTTP Server:
</p>
-<p class="screen"><div align="left"><table width="80%" border="1" cellspacing="0" cellpadding="2" bgcolor="#000000"><tr><td bgcolor="#000000" align="left"><code class="screen"><nobr>export LD_LIBRARY_PATH=$jre/bin:$jre/bin/classic:$LD_LIBRARY_PATH</nobr></code><br></td></tr></table></div></p>
+<div class="codeBox"><pre><code>export LD_LIBRARY_PATH=$jre/bin:$jre/bin/classic:$LD_LIBRARY_PATH
+</code></pre></div>
<p>
Also some Linux distributions have enabled a GLIBC feature called 'floating stacks' which may not works with kernel
less than 2.4.10 on SMP machines. You should disable floating stacks by exporting an environment variable:
</p>
-<p class="screen"><div align="left"><table width="80%" border="1" cellspacing="0" cellpadding="2" bgcolor="#000000"><tr><td bgcolor="#000000" align="left"><code class="screen"><nobr>export LD_ASSUME_KERNEL=2.2.5</nobr></code><br></td></tr></table></div></p>
+<div class="codeBox"><pre><code>export LD_ASSUME_KERNEL=2.2.5
+</code></pre></div>
<p>
You could have to update your service scripts, ie <b>/etc/rc.d/init.d/httpd</b>, to set these env vars
before your Apache server starts.
</p>
-</blockquote></td></tr></table>
+</div></div>
-<table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Mixed errors when building via configure"><strong>Mixed errors when building via configure</strong></a></font></td></tr><tr><td><blockquote>
+<div class="subsection"><h4 id="Mixed_errors_when_building_via_configure">Mixed errors when building via configure</h4><div class="text">
<p>
configure assume you have some GNU tools already installed and configured for your system, and ad minima <b>libtool</b>.
</p>
@@ -278,8 +317,20 @@ c compiler with a jk/jk2 build with gcc.
<p>
In case the make processing doesn't work as expected, you should use a GNU make <b>gmake</b>.
</p>
-</blockquote></td></tr></table>
+</div></div>
-</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>
- Copyright © 1999-2018, Apache Software Foundation
- </em></font></div></td></tr></table></body></html>
\ No newline at end of file
+</div><div class="noprint"><h3 id="comments_section">
+ Comments
+ </h3><div class="text"><p class="notice"><strong>Notice:</strong> This comments section collects your suggestions
+ on improving documentation for Apache Tomcat.<br><br>
+ If you have trouble and need help, read
+ <a href="https://tomcat.apache.org/findhelp.html">Find Help</a> page
+ and ask your question on the tomcat-users
+ <a href="https://tomcat.apache.org/lists.html">mailing list</a>.
+ Do not ask such questions here. This is not a Q&A section.<br><br>
+ The Apache Comments System is explained <a href="../../comments.html">here</a>.
+ Comments may be removed by our moderators if they are either
+ implemented or considered invalid/off-topic.
+ </p><div id="comments_thread"></div></div></div></div></div></div></div><footer><div id="footer">
+ Copyright © 1999-yyyy, The Apache Software Foundation
+ </div></footer></div></body></html>
\ No newline at end of file
Modified: tomcat/site/trunk/docs/connectors-doc/miscellaneous/printer/jkstatustasks.html
URL: http://svn.apache.org/viewvc/tomcat/site/trunk/docs/connectors-doc/miscellaneous/printer/jkstatustasks.html?rev=1848964&r1=1848963&r2=1848964&view=diff
==============================================================================
--- tomcat/site/trunk/docs/connectors-doc/miscellaneous/printer/jkstatustasks.html (original)
+++ tomcat/site/trunk/docs/connectors-doc/miscellaneous/printer/jkstatustasks.html Fri Dec 14 17:45:49 2018
@@ -1,13 +1,43 @@
-<html><head><META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>The Apache Tomcat Connectors - Miscellaneous Documentation - Status Worker Ant Tasks</title><meta name="author" value="Peter Rossbach"><meta name="email" value=""><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 Software Foundation" border="0"></a></td></tr><!--HEADER SEPARATOR--><tr><td colspan="2"><hr noshade size="1"></td></tr><tr><!--RIGHT SIDE MAIN BODY--><td width="80%" valign="top" align="left"><table border="0" width="100%" cellspac
ing="4"><tr><td align="left" valign="top"><h1>The Apache Tomcat Connectors - Miscellaneous Documentation</h1><h2>Status Worker Ant Tasks</h2></td><td align="right" valign="top" nowrap="true"><img src="../../images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0" alt=" "></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>
+<!DOCTYPE html SYSTEM "about:legacy-compat">
+<html lang="en"><head><META http-equiv="Content-Type" content="text/html; charset=UTF-8"><link href="../../images/docs-stylesheet.css" rel="stylesheet" type="text/css"><title>The Apache Tomcat Connectors: mod_jk, ISAPI redirector, NSAPI redirector (1.2.x) - Status Worker Ant Tasks</title><meta name="author" content="Peter Rossbach"><script type="application/javascript" data-comments-identifier="">
+ "use strict"; // Enable strict mode
+
+ (function() {
+ var thisScript = document.currentScript;
+ if (!thisScript) { // Workaround for IE <= 11
+ var scripts = document.getElementsByTagName("script");
+ thisScript = scripts[scripts.length - 1];
+ }
+ document.addEventListener("DOMContentLoaded", (function() {
+ var commentsDiv = document.getElementById("comments_thread");
+ var commentsShortname = "tomcat";
+ var commentsIdentifier = "https://tomcat.apache.org/" +
+ thisScript.getAttribute("data-comments-identifier") + ".html";
+
+ (function(w, d) {
+ if (w.location.hostname.toLowerCase() == "tomcat.apache.org") {
+ var s = d.createElement("script");
+ s.type = "application/javascript";
+ s.async = true;
+ s.src = "https://comments.apache.org/show_comments.lua?site=" +
+ encodeURIComponent(commentsShortname) +
+ "&page=" + encodeURIComponent(commentsIdentifier);
+ d.head.appendChild(s);
+ } else {
+ commentsDiv.appendChild(d.createTextNode("Comments are disabled for this page at the moment."));
+ }
+ })(window, document);
+ }), false);
+ })();
+ </script></head><body><div id="wrapper"><header><div id="header"><div><div><div class="logo noPrint"><a href="http://tomcat.apache.org/"><img alt="Tomcat Home" src="../../images/tomcat.png"></a></div><div style="height: 1px;"></div><div class="asfLogo noPrint"><a href="https://www.apache.org/" target="_blank"><img src="../../images/asf-logo.svg" alt="The Apache Software Foundation" style="width: 266px; height: 83px;"></a></div><h1>The Apache Tomcat Connectors: mod_jk, ISAPI redirector, NSAPI redirector</h1><div style="height: 1px;"></div><div style="clear: left;"></div></div></div></div></header><div id="middle"><div><div id="mainLeft" class="noprint"><div><nav><div><h2>Links</h2><ul><li><a href="index.html">Docs Home</a></li></ul></div><div><h2>Common HowTo</h2><ul><li><a href="common_howto/quick.html">For the impatient</a></li><li><a href="common_howto/workers.html">All about workers</a></li><li><a href="common_howto/timeouts.html">Timeouts</a></li><li><a href="common_howto/load
balancers.html">Load Balancing</a></li><li><a href="common_howto/proxy.html">Reverse Proxy</a></li></ul></div><div><h2>Web Server HowTo</h2><ul><li><a href="webserver_howto/apache.html">Apache HTTP Server (mod_jk)</a></li><li><a href="webserver_howto/iis.html">Microsoft IIS (ISAPI redirector)</a></li><li><a href="webserver_howto/nes.html">iPlanet Web Server (NSAPI redirector)</a></li></ul></div><div><h2>Reference Guide</h2><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 (mod_jk)</a></li><li><a href="reference/iis.html">Microsoft IIS (ISAPI redirector)</a></li></ul></div><div><h2>AJP Protocol Reference</h2><ul><li><a href="ajp/ajpv13a.html">AJPv13 (ajp13)</a></li><li><a href="ajp/ajpv13ext.html">AJPv13 Extension Proposal</a></li></ul></div><div><h2>Miscellaneous Documentation</h2>
<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&short_desc_type=allwordssubstr&short_desc=&product=Tomcat+Connectors&long_desc_type=substring&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&keywords_type=allwords&keywords=&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&emailassigned_to1=1&emailtype1=substring&email1=&emailassigned_to2=1&emailreporter2=1&emailcc2=1&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Reuse+same+sort+as+last+time&field0-0-0=noop&type0-0-0=noop&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></div><div><h2>News</h2><ul><li><a href="news/20180301.html">2018</a></li><li><a href="news/20160901.html">2016</a></li><li><a href="news/20150101.html">2015</a></li><li><a href="news/20140201.html">2014</a></li><li><a href="news/20120301.html">2012</a></li><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></div></nav></div></div><div id="mainRight"><div id="content"><h2>Status Worker Ant Tasks</h2><h3 id="Introduction
">Introduction</h3><div class="text">
<p>Since version 1.2.19 the JK release contains additional ant tasks.
They can be used to manage the JK web server plugins via the special status worker.
</p>
-</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="Manage JK with remote Ant Tasks"><strong>Manage JK with remote Ant Tasks</strong></a></font></td></tr><tr><td><blockquote>
+</div><h3 id="Manage_JK_with_remote_Ant_Tasks">Manage JK with remote Ant Tasks</h3><div class="text">
-<table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Simple antlib integration"><strong>Simple antlib integration</strong></a></font></td></tr><tr><td><blockquote>
+<div class="subsection"><h4 id="Simple_antlib_integration">Simple antlib integration</h4><div class="text">
<p>
-<div class="example"><pre>
-<?xml version="1.0" encoding="UTF-8"?>
+<div class="codeBox"><pre><code><?xml version="1.0" encoding="UTF-8"?>
<project name="modjk-status"
xmlns:jk="urn:org-apache-jk-status"
@@ -39,14 +69,13 @@ They can be used to manage the JK web se
<echoproperties prefix="worker" />
</target>
</project>
-</pre></div>
+</code></pre></div>
</p>
-</blockquote></td></tr></table>
+</div></div>
-<table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Test Result"><strong>Test Result</strong></a></font></td></tr><tr><td><blockquote>
+<div class="subsection"><h4 id="Test_Result">Test Result</h4><div class="text">
<p>
-<div class="example"><pre>
-[echoproperties] #Ant properties
+<div class="codeBox"><pre><code>[echoproperties] #Ant properties
[echoproperties] #Sun Dec 10 20:40:21 CET 2006
[echoproperties] worker.node01.lbmult=1
[echoproperties] worker.loadbalancer.lock=Optimistic
@@ -120,64 +149,73 @@ They can be used to manage the JK web se
[echoproperties] worker.loadbalancer.max_busy=0
[echoproperties] worker.loadbalancer.type=lb
[echoproperties] worker.node02.host=localhost
-</pre></div>
+</code></pre></div>
</p>
-</blockquote></td></tr></table>
+</div></div>
-<table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Update Load Balancer"><strong>Update Load Balancer</strong></a></font></td></tr><tr><td><blockquote>
+<div class="subsection"><h4 id="Update_Load_Balancer">Update Load Balancer</h4><div class="text">
<p>
-<div class="example"><pre>
- <target name="updatelb" >
- <jk:updateloadbalancer url="${jkstatus.url}"
- username="${jkstatus.username}"
- password="${jkstatus.password}"
- loadbalancer="loadbalancer"
- method="Busyness"
- retries="2"
- recoverWaitTime="60"
- lock="Optimistic"
- forceStickySession="false"
- stickySession="false"/>
- </target>
-</pre></div>
+<div class="codeBox"><pre><code><target name="updatelb" >
+<jk:updateloadbalancer url="${jkstatus.url}"
+ username="${jkstatus.username}"
+ password="${jkstatus.password}"
+ loadbalancer="loadbalancer"
+ method="Busyness"
+ retries="2"
+ recoverWaitTime="60"
+ lock="Optimistic"
+ forceStickySession="false"
+ stickySession="false"/>
+</target>
+</code></pre></div>
</p>
-</blockquote></td></tr></table>
+</div></div>
-<table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Update Worker"><strong>Update Worker</strong></a></font></td></tr><tr><td><blockquote>
+<div class="subsection"><h4 id="Update_Worker">Update Worker</h4><div class="text">
<p>
-<div class="example"><pre>
- <target name="updatew" >
- <jk:updateworker url="${jkstatus.url}"
- username="${jkstatus.username}"
- password="${jkstatus.password}"
- loadbalancer="loadbalancer"
- worker="node01"
- lbfactor="2"
- activation="Active"
- redirect=""
- domain=""
- route="node01"
- distance="0"/>
- </target>
-</pre></div>
+<div class="codeBox"><pre><code><target name="updatew" >
+<jk:updateworker url="${jkstatus.url}"
+ username="${jkstatus.username}"
+ password="${jkstatus.password}"
+ loadbalancer="loadbalancer"
+ worker="node01"
+ lbfactor="2"
+ activation="Active"
+ redirect=""
+ domain=""
+ route="node01"
+ distance="0"/>
+</target>
+</code></pre></div>
</p>
-</blockquote></td></tr></table>
+</div></div>
-<table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Reset Worker"><strong>Reset Worker</strong></a></font></td></tr><tr><td><blockquote>
+<div class="subsection"><h4 id="Reset_Worker">Reset Worker</h4><div class="text">
<p>
-<div class="example"><pre>
- <target name="reset" >
- <jk:reset url="${jkstatus.url}"
- username="${jkstatus.username}"
- password="${jkstatus.password}"
- loadbalancer="loadbalancer"
- worker="node01"
- />
- </target>
-</pre></div>
-</p>
-</blockquote></td></tr></table>
-
-</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>
- Copyright © 1999-2018, Apache Software Foundation
- </em></font></div></td></tr></table></body></html>
\ No newline at end of file
+<div class="codeBox"><pre><code><target name="reset" >
+<jk:reset url="${jkstatus.url}"
+ username="${jkstatus.username}"
+ password="${jkstatus.password}"
+ loadbalancer="loadbalancer"
+ worker="node01"
+ />
+</target>
+</code></pre></div>
+</p>
+</div></div>
+
+</div><div class="noprint"><h3 id="comments_section">
+ Comments
+ </h3><div class="text"><p class="notice"><strong>Notice:</strong> This comments section collects your suggestions
+ on improving documentation for Apache Tomcat.<br><br>
+ If you have trouble and need help, read
+ <a href="https://tomcat.apache.org/findhelp.html">Find Help</a> page
+ and ask your question on the tomcat-users
+ <a href="https://tomcat.apache.org/lists.html">mailing list</a>.
+ Do not ask such questions here. This is not a Q&A section.<br><br>
+ The Apache Comments System is explained <a href="../../comments.html">here</a>.
+ Comments may be removed by our moderators if they are either
+ implemented or considered invalid/off-topic.
+ </p><div id="comments_thread"></div></div></div></div></div></div></div><footer><div id="footer">
+ Copyright © 1999-yyyy, The Apache Software Foundation
+ </div></footer></div></body></html>
\ No newline at end of file
Modified: tomcat/site/trunk/docs/connectors-doc/miscellaneous/printer/reporttools.html
URL: http://svn.apache.org/viewvc/tomcat/site/trunk/docs/connectors-doc/miscellaneous/printer/reporttools.html?rev=1848964&r1=1848963&r2=1848964&view=diff
==============================================================================
--- tomcat/site/trunk/docs/connectors-doc/miscellaneous/printer/reporttools.html (original)
+++ tomcat/site/trunk/docs/connectors-doc/miscellaneous/printer/reporttools.html Fri Dec 14 17:45:49 2018
@@ -1,22 +1,53 @@
-<html><head><META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>The Apache Tomcat Connectors - Miscellaneous Documentation - Reporting Tools</title><meta name="author" value="Glenn Nielsen"><meta name="email" value=""><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 Software Foundation" border="0"></a></td></tr><!--HEADER SEPARATOR--><tr><td colspan="2"><hr noshade size="1"></td></tr><tr><!--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 Connectors - Miscellaneous Documentation</h1><h2>Reporting Tools</h2></td><td align="right" valign="top" nowrap="true"><img src="../../images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0" alt=" "></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="Reporting Tools"><strong>Reporting Tools</strong></a></font></td></tr><tr><td><blockquote>
+<!DOCTYPE html SYSTEM "about:legacy-compat">
+<html lang="en"><head><META http-equiv="Content-Type" content="text/html; charset=UTF-8"><link href="../../images/docs-stylesheet.css" rel="stylesheet" type="text/css"><title>The Apache Tomcat Connectors: mod_jk, ISAPI redirector, NSAPI redirector (1.2.x) - Reporting Tools</title><meta name="author" content="Glenn Nielsen"><script type="application/javascript" data-comments-identifier="">
+ "use strict"; // Enable strict mode
+
+ (function() {
+ var thisScript = document.currentScript;
+ if (!thisScript) { // Workaround for IE <= 11
+ var scripts = document.getElementsByTagName("script");
+ thisScript = scripts[scripts.length - 1];
+ }
+ document.addEventListener("DOMContentLoaded", (function() {
+ var commentsDiv = document.getElementById("comments_thread");
+ var commentsShortname = "tomcat";
+ var commentsIdentifier = "https://tomcat.apache.org/" +
+ thisScript.getAttribute("data-comments-identifier") + ".html";
+
+ (function(w, d) {
+ if (w.location.hostname.toLowerCase() == "tomcat.apache.org") {
+ var s = d.createElement("script");
+ s.type = "application/javascript";
+ s.async = true;
+ s.src = "https://comments.apache.org/show_comments.lua?site=" +
+ encodeURIComponent(commentsShortname) +
+ "&page=" + encodeURIComponent(commentsIdentifier);
+ d.head.appendChild(s);
+ } else {
+ commentsDiv.appendChild(d.createTextNode("Comments are disabled for this page at the moment."));
+ }
+ })(window, document);
+ }), false);
+ })();
+ </script></head><body><div id="wrapper"><header><div id="header"><div><div><div class="logo noPrint"><a href="http://tomcat.apache.org/"><img alt="Tomcat Home" src="../../images/tomcat.png"></a></div><div style="height: 1px;"></div><div class="asfLogo noPrint"><a href="https://www.apache.org/" target="_blank"><img src="../../images/asf-logo.svg" alt="The Apache Software Foundation" style="width: 266px; height: 83px;"></a></div><h1>The Apache Tomcat Connectors: mod_jk, ISAPI redirector, NSAPI redirector</h1><div style="height: 1px;"></div><div style="clear: left;"></div></div></div></div></header><div id="middle"><div><div id="mainLeft" class="noprint"><div><nav><div><h2>Links</h2><ul><li><a href="index.html">Docs Home</a></li></ul></div><div><h2>Common HowTo</h2><ul><li><a href="common_howto/quick.html">For the impatient</a></li><li><a href="common_howto/workers.html">All about workers</a></li><li><a href="common_howto/timeouts.html">Timeouts</a></li><li><a href="common_howto/load
balancers.html">Load Balancing</a></li><li><a href="common_howto/proxy.html">Reverse Proxy</a></li></ul></div><div><h2>Web Server HowTo</h2><ul><li><a href="webserver_howto/apache.html">Apache HTTP Server (mod_jk)</a></li><li><a href="webserver_howto/iis.html">Microsoft IIS (ISAPI redirector)</a></li><li><a href="webserver_howto/nes.html">iPlanet Web Server (NSAPI redirector)</a></li></ul></div><div><h2>Reference Guide</h2><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 (mod_jk)</a></li><li><a href="reference/iis.html">Microsoft IIS (ISAPI redirector)</a></li></ul></div><div><h2>AJP Protocol Reference</h2><ul><li><a href="ajp/ajpv13a.html">AJPv13 (ajp13)</a></li><li><a href="ajp/ajpv13ext.html">AJPv13 Extension Proposal</a></li></ul></div><div><h2>Miscellaneous Documentation</h2>
<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&short_desc_type=allwordssubstr&short_desc=&product=Tomcat+Connectors&long_desc_type=substring&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&keywords_type=allwords&keywords=&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&emailassigned_to1=1&emailtype1=substring&email1=&emailassigned_to2=1&emailreporter2=1&emailcc2=1&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Reuse+same+sort+as+last+time&field0-0-0=noop&type0-0-0=noop&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></div><div><h2>News</h2><ul><li><a href="news/20180301.html">2018</a></li><li><a href="news/20160901.html">2016</a></li><li><a href="news/20150101.html">2015</a></li><li><a href="news/20140201.html">2014</a></li><li><a href="news/20120301.html">2012</a></li><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></div></nav></div></div><div id="mainRight"><div id="content"><h2>Reporting Tools</h2><h3 id="Reporting_Tools">Rep
orting Tools</h3><div class="text">
<p>
The mod_jk source distribution contains two perl scripts in the
tools/reports directory which can be used to analyze the mod_jk
logs, save statistical data, and generate report graphs.
</p>
-<p><b class="code">tomcat_trend.pl log_dir archive_dir</b></p>
+<p><code>tomcat_trend.pl log_dir archive_dir</code></p>
<p>
Script for analyzing mod_jk.log data when logging tomcat request data using
-the <b class="code">JkRequestLogFormat</b> Apache mod_jk configuration.
+the <code>JkRequestLogFormat</code> Apache mod_jk configuration.
Generates statistics for request latency and errors. Archives the generated
data to files for later use in long term trend graphs and reports.
</p>
-<p><b class="code">tomcat_reports.pl archive_dir reports_dir</b></p>
+<p><code>tomcat_reports.pl archive_dir reports_dir</code></p>
<p>
Script for generating reports and graphs using statistical data generated
-by the <b class="code">tomcat_trend.pl</b> script.
+by the <code>tomcat_trend.pl</code> script.
The following graphs are created:
<ul>
@@ -56,6 +87,18 @@ These perl scripts depend upon the follo
<li>StatisticsDescriptive perl module</li>
</ul>
</p>
-</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>
- Copyright © 1999-2018, Apache Software Foundation
- </em></font></div></td></tr></table></body></html>
\ No newline at end of file
+</div><div class="noprint"><h3 id="comments_section">
+ Comments
+ </h3><div class="text"><p class="notice"><strong>Notice:</strong> This comments section collects your suggestions
+ on improving documentation for Apache Tomcat.<br><br>
+ If you have trouble and need help, read
+ <a href="https://tomcat.apache.org/findhelp.html">Find Help</a> page
+ and ask your question on the tomcat-users
+ <a href="https://tomcat.apache.org/lists.html">mailing list</a>.
+ Do not ask such questions here. This is not a Q&A section.<br><br>
+ The Apache Comments System is explained <a href="../../comments.html">here</a>.
+ Comments may be removed by our moderators if they are either
+ implemented or considered invalid/off-topic.
+ </p><div id="comments_thread"></div></div></div></div></div></div></div><footer><div id="footer">
+ Copyright © 1999-yyyy, The Apache Software Foundation
+ </div></footer></div></body></html>
\ No newline at end of file
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@tomcat.apache.org
For additional commands, e-mail: dev-help@tomcat.apache.org