You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by ji...@apache.org on 2012/09/13 19:14:29 UTC

svn commit: r1384408 - in /httpd/httpd/trunk/docs/manual/mod: mod_proxy.xml mod_proxy_balancer.xml

Author: jim
Date: Thu Sep 13 17:14:28 2012
New Revision: 1384408

URL: http://svn.apache.org/viewvc?rev=1384408&view=rev
Log:
Best practice

Modified:
    httpd/httpd/trunk/docs/manual/mod/mod_proxy.xml
    httpd/httpd/trunk/docs/manual/mod/mod_proxy_balancer.xml

Modified: httpd/httpd/trunk/docs/manual/mod/mod_proxy.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_proxy.xml?rev=1384408&r1=1384407&r2=1384408&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_proxy.xml (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_proxy.xml Thu Sep 13 17:14:28 2012
@@ -696,8 +696,8 @@ expressions</description>
     <example>
         <highlight language="config">
 &lt;Proxy balancer://hotcluster&gt;
-    BalancerMember http://www2.example.com:8080 loadfactor=1
-    BalancerMember http://www3.example.com:8080 loadfactor=2
+    BalancerMember http://www2.example.com:8080/ loadfactor=1
+    BalancerMember http://www3.example.com:8080/ loadfactor=2
     ProxySet lbmethod=bytraffic
 &lt;/Proxy&gt;
       </highlight>
@@ -1111,10 +1111,10 @@ ProxyPass /mirror/foo http://backend.exa
 ProxyPass /special-area http://special.example.com smax=5 max=10
 ProxyPass / balancer://mycluster/ stickysession=JSESSIONID|jsessionid nofailover=On
 &lt;Proxy balancer://mycluster&gt;
-    BalancerMember ajp://1.2.3.4:8009
-    BalancerMember ajp://1.2.3.5:8009 loadfactor=20
+    BalancerMember ajp://1.2.3.4:8009/
+    BalancerMember ajp://1.2.3.5:8009/ loadfactor=20
     # Less powerful server, don't send as many requests there,
-    BalancerMember ajp://1.2.3.6:8009 loadfactor=5
+    BalancerMember ajp://1.2.3.6:8009/ loadfactor=5
 &lt;/Proxy&gt;
     </highlight>
 
@@ -1123,10 +1123,10 @@ ProxyPass / balancer://mycluster/ sticky
     <highlight language="config">
 ProxyPass / balancer://hotcluster/ 
 &lt;Proxy balancer://hotcluster&gt;
-    BalancerMember ajp://1.2.3.4:8009 loadfactor=1
-    BalancerMember ajp://1.2.3.5:8009 loadfactor=2
+    BalancerMember ajp://1.2.3.4:8009/ loadfactor=1
+    BalancerMember ajp://1.2.3.5:8009/ loadfactor=2
     # The server below is on hot standby
-    BalancerMember ajp://1.2.3.6:8009 status=+H
+    BalancerMember ajp://1.2.3.6:8009/ status=+H
     ProxySet lbmethod=bytraffic
 &lt;/Proxy&gt;
     </highlight>

Modified: httpd/httpd/trunk/docs/manual/mod/mod_proxy_balancer.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_proxy_balancer.xml?rev=1384408&r1=1384407&r2=1384408&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_proxy_balancer.xml (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_proxy_balancer.xml Thu Sep 13 17:14:28 2012
@@ -92,12 +92,12 @@
     </p>
 
     <highlight language="config">
-&lt;Proxy balancer://mycluster&gt;
-    BalancerMember http://192.168.1.50:80
-    BalancerMember http://192.168.1.51:80
+&lt;Proxy balancer://mycluster/&gt;
+    BalancerMember http://192.168.1.50:80/
+    BalancerMember http://192.168.1.51:80/
 &lt;/Proxy&gt;
-ProxyPass /test balancer://mycluster
-ProxyPassReverse /test balancer://mycluster
+ProxyPass /test balancer://mycluster/
+ProxyPassReverse /test balancer://mycluster/
     </highlight>
 
     <p>Another example of how to provide load balancing with stickyness
@@ -107,13 +107,13 @@ ProxyPassReverse /test balancer://myclus
 
     <highlight language="config">
 Header add Set-Cookie "ROUTEID=.%{BALANCER_WORKER_ROUTE}e; path=/" env=BALANCER_ROUTE_CHANGED
-&lt;Proxy balancer://mycluster&gt;
-    BalancerMember http://192.168.1.50:80 route=1
-    BalancerMember http://192.168.1.51:80 route=2
+&lt;Proxy balancer://mycluster/&gt;
+    BalancerMember http://192.168.1.50:80/ route=1
+    BalancerMember http://192.168.1.51:80/ route=2
     ProxySet stickysession=ROUTEID
 &lt;/Proxy&gt;
-ProxyPass /test balancer://mycluster
-ProxyPassReverse /test balancer://mycluster
+ProxyPass /test balancer://mycluster/
+ProxyPassReverse /test balancer://mycluster/
     </highlight>
 </section>
 
@@ -140,7 +140,7 @@ ProxyPassReverse /test balancer://myclus
     <dt><var><a name="balancer_name" id="balancer_name">BALANCER_NAME</a></var></dt>
     <dd>
     <p>This is assigned the name of the balancer used for the current
-    request. The value is something like <code>balancer://foo</code>.</p>
+    request. The value is something like <code>balancer://foo/</code>.</p>
     </dd>
 
     <!-- ============= BALANCER_WORKER_NAME ================== -->
@@ -249,10 +249,10 @@ ProxyPassReverse /test balancer://myclus
     configuring the name of the cookie and the name of the URL parameter
     separated by a vertical bar (<code>|</code>) as in the following example:</p>
     <highlight language="config">
-ProxyPass /test balancer://mycluster stickysession=JSESSIONID|jsessionid scolonpathdelim=On
+ProxyPass /test balancer://mycluster/ stickysession=JSESSIONID|jsessionid scolonpathdelim=On
 &lt;Proxy balancer://mycluster&gt;
-    BalancerMember http://192.168.1.50:80 route=node1
-    BalancerMember http://192.168.1.51:80 route=node2
+    BalancerMember http://192.168.1.50:80/ route=node1
+    BalancerMember http://192.168.1.51:80/ route=node2
 &lt;/Proxy&gt;
     </highlight>
     <p>If the cookie and the request parameter both provide routing information



Re: svn commit: r1384408 - in /httpd/httpd/trunk/docs/manual/mod: mod_proxy.xml mod_proxy_balancer.xml

Posted by Ruediger Pluem <rp...@apache.org>.

jim@apache.org wrote:
> Author: jim
> Date: Thu Sep 13 17:14:28 2012
> New Revision: 1384408
> 
> URL: http://svn.apache.org/viewvc?rev=1384408&view=rev
> Log:
> Best practice
> 
> Modified:
>     httpd/httpd/trunk/docs/manual/mod/mod_proxy.xml
>     httpd/httpd/trunk/docs/manual/mod/mod_proxy_balancer.xml
> 
> Modified: httpd/httpd/trunk/docs/manual/mod/mod_proxy.xml
> URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_proxy.xml?rev=1384408&r1=1384407&r2=1384408&view=diff
> ==============================================================================
> --- httpd/httpd/trunk/docs/manual/mod/mod_proxy.xml (original)
> +++ httpd/httpd/trunk/docs/manual/mod/mod_proxy.xml Thu Sep 13 17:14:28 2012
> @@ -696,8 +696,8 @@ expressions</description>
>      <example>
>          <highlight language="config">
>  &lt;Proxy balancer://hotcluster&gt;
> -    BalancerMember http://www2.example.com:8080 loadfactor=1
> -    BalancerMember http://www3.example.com:8080 loadfactor=2
> +    BalancerMember http://www2.example.com:8080/ loadfactor=1
> +    BalancerMember http://www3.example.com:8080/ loadfactor=2
>      ProxySet lbmethod=bytraffic
>  &lt;/Proxy&gt;
>        </highlight>
> @@ -1111,10 +1111,10 @@ ProxyPass /mirror/foo http://backend.exa
>  ProxyPass /special-area http://special.example.com smax=5 max=10
>  ProxyPass / balancer://mycluster/ stickysession=JSESSIONID|jsessionid nofailover=On
>  &lt;Proxy balancer://mycluster&gt;
> -    BalancerMember ajp://1.2.3.4:8009
> -    BalancerMember ajp://1.2.3.5:8009 loadfactor=20
> +    BalancerMember ajp://1.2.3.4:8009/
> +    BalancerMember ajp://1.2.3.5:8009/ loadfactor=20
>      # Less powerful server, don't send as many requests there,
> -    BalancerMember ajp://1.2.3.6:8009 loadfactor=5
> +    BalancerMember ajp://1.2.3.6:8009/ loadfactor=5
>  &lt;/Proxy&gt;
>      </highlight>
>  
> @@ -1123,10 +1123,10 @@ ProxyPass / balancer://mycluster/ sticky
>      <highlight language="config">
>  ProxyPass / balancer://hotcluster/ 
>  &lt;Proxy balancer://hotcluster&gt;
> -    BalancerMember ajp://1.2.3.4:8009 loadfactor=1
> -    BalancerMember ajp://1.2.3.5:8009 loadfactor=2
> +    BalancerMember ajp://1.2.3.4:8009/ loadfactor=1
> +    BalancerMember ajp://1.2.3.5:8009/ loadfactor=2
>      # The server below is on hot standby
> -    BalancerMember ajp://1.2.3.6:8009 status=+H
> +    BalancerMember ajp://1.2.3.6:8009/ status=+H
>      ProxySet lbmethod=bytraffic
>  &lt;/Proxy&gt;
>      </highlight>
> 
> Modified: httpd/httpd/trunk/docs/manual/mod/mod_proxy_balancer.xml
> URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_proxy_balancer.xml?rev=1384408&r1=1384407&r2=1384408&view=diff
> ==============================================================================
> --- httpd/httpd/trunk/docs/manual/mod/mod_proxy_balancer.xml (original)
> +++ httpd/httpd/trunk/docs/manual/mod/mod_proxy_balancer.xml Thu Sep 13 17:14:28 2012
> @@ -92,12 +92,12 @@
>      </p>
>  
>      <highlight language="config">
> -&lt;Proxy balancer://mycluster&gt;
> -    BalancerMember http://192.168.1.50:80
> -    BalancerMember http://192.168.1.51:80
> +&lt;Proxy balancer://mycluster/&gt;
> +    BalancerMember http://192.168.1.50:80/
> +    BalancerMember http://192.168.1.51:80/


IMHO this results in a GET //... to the backend.

>  &lt;/Proxy&gt;
> -ProxyPass /test balancer://mycluster
> -ProxyPassReverse /test balancer://mycluster
> +ProxyPass /test balancer://mycluster/

I think this will lead to double '/'. The master rule is that you should end the same on the left and the right side, so

ProxyPass /test balancer://mycluster

or

ProxyPass /test/ balancer://mycluster/


Regards

RĂ¼diger