From e779d7af49a7b7ae79d3fe443725305577630fe5 Mon Sep 17 00:00:00 2001
From: markt <markt@13f79535-47bb-0310-9956-ffa450edef68>
Date: Wed, 15 Jul 2009 06:55:25 +0000
Subject: [PATCH] Remove commented out reference to the balancer web-app. This
 is not included in trunk.

git-svn-id: https://svn.apache.org/repos/asf/tomcat/trunk@794157 13f79535-47bb-0310-9956-ffa450edef68
---
 webapps/docs/balancer-howto.xml | 110 +---------------------------------------
 1 file changed, 1 insertion(+), 109 deletions(-)

diff --git a/webapps/docs/balancer-howto.xml b/webapps/docs/balancer-howto.xml
index 8d6016c73..ed4f768e4 100644
--- a/webapps/docs/balancer-howto.xml
+++ b/webapps/docs/balancer-howto.xml
@@ -36,10 +36,7 @@
 <a href="#Using the JK 1.2.x native connector">
 Using the JK native connector</a><br />
 <a href="#Using Apache HTTP Server 2.x with mod_proxy">
-Using Apache HTTP Server 2.x and mod_proxy</a><br />
-<!--
-<a href="#Using the balancer webapp">Using the balancer webapp</a><br />
--->
+Using Apache HTTP Server 2.x and mod_proxy</a>
 </p>
 </section>
 
@@ -58,111 +55,6 @@ from Apache HTTP Server 2.2.
 
 </section>
 
-<!--
-<section name="Using the balancer webapp">
-
-<subsection name="Overview">
-
-<p>
-Tomcat 5.0.15 and later ships with a webapp named balancer.  This is
-a simple implemention of a rules-based load balancer.  It was not designed
-as a replacement for other load-balancing mechanisms used for high traffic
-environments.  Rather, it is a simple, pure Java, easily extensible, and fast
-way to direct traffic among multiple servers.
-</p>
-<p>
-Although balancer ships with Tomcat, it is not Tomcat-specific and runs
-on other containers without any modification.  The balancer webapp 
-requires a Servlet Specification 2.3 or later container if you wish 
-to use a filter to redirect traffic.  If you wish to redirect traffic
-using a servlet, you may use any servlet container.
-</p>
-</subsection>
-
-<subsection name="Sample Configuration">
-<p>
-The default balancer installation uses a single filter, BalancerFilter,
-mapped to all requests (url-pattern /*).  The filter reads its rules
-from the location specified in the balancer deployment descriptor
-(web.xml file).  The default rules are:
-<ul>
-  <li>Redirect requests with News in the URL to www.cnn.com</li>
-  <li>Redirect requests with a parameter named paramName whose
-value is paramValue to www.yahoo.com.</li>
-  <li>Redirect all other requests to jakarta.apache.org.</li>
-</ul>
-
-Therefore, when you install tomcat, start it, and point your
-browser to http://localhost:8080/balancer, you will be redirected
-to http://jakarta.apache.org.  If you point your browser to
-http://localhost:8080/balancer/News you will be redirected to
-http://www.cnn.com.  The request for 
-http://localhost:8080/balancer/BlahBlah?paramName=paramValue will
-be redirected to http://www.yahoo.com.
-</p>
-</subsection>
-
-<subsection name="Balancer Rules">
-<p>
-A <i>Rule</i> in the balancer system is a combination of
-a request matching criterion and a redirection URL for
-matching requests.  Rules implement the
-org.apache.webapp.balancer.Rule interface.
-</p>
-
-<p>
-The balancer distribution contains a number of useful
-rules.  The framework is also designed for easy extensibility
-so that you can write your own rules quickly.  Rules
-should be JavaBeans (public no-args constructor, public
-setter method setXXX for property xxx), as they are
-instantiated by Jakarta Commons Digester.  Feel free
-to inquire on the tomcat-user mailing list regarding
-the availability of rules or the inclusion of your rules
-in the distribution.
-</p>
-
-<p>
-Rules are assembled into RuleChains.  Each BalancerFilter
-(or Servlet/JSP) refers to one RuleChain when making its
-redirection decisions.  Note that you are not restricted
-to having one filter mapped to /* as done in the sample
-configuration.  You can configure as many filters as
-desired, using the full filter mapping possibilities defined
-in the Servlet Specification.  Each filter will have
-its own RuleChain.
-</p>
-</subsection>
-
-<subsection name="How it Works">
-<p>
-<ol>
-  <li>You write a rules configuration file containing various
-rules and redirection locations.</li>
-  <li>You define the balancer filter in your web.xml, mapping
-it as desired (/* is a common use-case) and configuring it
-with your rules configuration file.</li>
-  <li>The server is started, initializing the filter.</li>
-  <li>A request comes into the server.  The filter consults
-its rule chain to determine where to redirect the request.  Rules
-are consulted in the order in which they are defined in the rules
-configuration file.  The first matching rule will stop the
-evaluation and cause the request to be redirected.</li>
-</ol>
-</p>
-
-</subsection>
-
-<subsection name="Comments">
-<p>
-Please direct questions, comments, suggestions, etc. to the
-tomcat-user mailing list.  Thank you.
-</p>
-</subsection>
-
-</section>
--->
-
 </body>
 
 </document>
-- 
2.11.0