Return-Path: X-Original-To: apmail-httpd-cvs-archive@www.apache.org Delivered-To: apmail-httpd-cvs-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 6068776FC for ; Wed, 9 Nov 2011 20:29:28 +0000 (UTC) Received: (qmail 59681 invoked by uid 500); 9 Nov 2011 20:29:28 -0000 Delivered-To: apmail-httpd-cvs-archive@httpd.apache.org Received: (qmail 59626 invoked by uid 500); 9 Nov 2011 20:29:28 -0000 Mailing-List: contact cvs-help@httpd.apache.org; run by ezmlm Precedence: bulk Reply-To: dev@httpd.apache.org list-help: list-unsubscribe: List-Post: List-Id: Delivered-To: mailing list cvs@httpd.apache.org Received: (qmail 59619 invoked by uid 99); 9 Nov 2011 20:29:28 -0000 Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 09 Nov 2011 20:29:28 +0000 X-ASF-Spam-Status: No, hits=-2000.0 required=5.0 tests=ALL_TRUSTED X-Spam-Check-By: apache.org Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 09 Nov 2011 20:29:25 +0000 Received: from eris.apache.org (localhost [127.0.0.1]) by eris.apache.org (Postfix) with ESMTP id B71E623889E2; Wed, 9 Nov 2011 20:29:04 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r1199951 - /httpd/httpd/branches/2.2.x/docs/manual/mod/mod_proxy_ajp.xml Date: Wed, 09 Nov 2011 20:29:04 -0000 To: cvs@httpd.apache.org From: nd@apache.org X-Mailer: svnmailer-1.0.8-patched Message-Id: <20111109202904.B71E623889E2@eris.apache.org> X-Virus-Checked: Checked by ClamAV on apache.org Author: nd Date: Wed Nov 9 20:29:04 2011 New Revision: 1199951 URL: http://svn.apache.org/viewvc?rev=1199951&view=rev Log: examples are block elements and cannot occur within

elements. Modified: httpd/httpd/branches/2.2.x/docs/manual/mod/mod_proxy_ajp.xml Modified: httpd/httpd/branches/2.2.x/docs/manual/mod/mod_proxy_ajp.xml URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.2.x/docs/manual/mod/mod_proxy_ajp.xml?rev=1199951&r1=1199950&r2=1199951&view=diff ============================================================================== --- httpd/httpd/branches/2.2.x/docs/manual/mod/mod_proxy_ajp.xml (original) +++ httpd/httpd/branches/2.2.x/docs/manual/mod/mod_proxy_ajp.xml Wed Nov 9 20:29:04 2011 @@ -54,13 +54,13 @@

Usage

This module is used to reverse proxy to a backend application server (e.g. Apache Tomcat) using the AJP13 protocol. The usage is similar to - an HTTP reverse proxy, but uses the ajp:// prefix: + an HTTP reverse proxy, but uses the ajp:// prefix:

Simple Reverse Proxy ProxyPass /app ajp://backend.example.com:8009/app - Balancers may also be used: +

Balancers may also be used:

Balancer Reverse Proxy <Proxy balancer://cluster>
@@ -71,22 +71,25 @@ </Proxy>
ProxyPass /app balancer://cluster/app -

- Note that usually no +

Note that usually no ProxyPassReverse directive is necessary. The AJP request includes the original host header given to the proxy, and the application server can be expected to generate self-referential headers relative to this host, so no rewriting is necessary. -

- The main exception is when the URL path on the proxy differs from that on the +

+ +

The main exception is when the URL path on the proxy differs from that + on the backend. In this case, a redirect header can be rewritten relative to the - original host URL (not the backend ajp:// URL), for example: + original host URL (not the backend ajp:// URL), for + example:

Rewriting Proxied Path ProxyPass /apps/foo ajp://backend.example.com:8009/foo
ProxyPassReverse /apps/foo http://www.example.com/foo - However, it is usually better to deploy the application on the backend + +

However, it is usually better to deploy the application on the backend server at the same path as the proxy rather than to take this approach.