From: Jim Jagielski Date: Thu, 17 Aug 2006 19:19:22 +0000 (+0000) Subject: Update the proxy module docs to reflect current reality. X-Git-Tag: 2.2.4~218 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=678d414f0fdc587f01e1c2d869dc342dcd4d78fd;p=thirdparty%2Fapache%2Fhttpd.git Update the proxy module docs to reflect current reality. Add in the flush settings, which are part of 2.2.x and reorder params to be in abc order (to make 'em easier to find) git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.2.x@432350 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/manual/mod/mod_proxy.xml b/docs/manual/mod/mod_proxy.xml index e742b62b6ae..bc97abbf1b2 100644 --- a/docs/manual/mod/mod_proxy.xml +++ b/docs/manual/mod/mod_proxy.xml @@ -548,20 +548,6 @@ expressions number of connections will be created on demand. Any connections above smax are subject to a time to live or ttl. - ttl - - - Time To Live for the inactive connections above the - smax connections in seconds. Apache will close all - connections that has not been used inside that time period. - - timeout - Timeout - Connection timeout in seconds. - If not set the Apache will wait until the free connection - is available. This directive is used for limiting the number - of connections to the backend server together with max - parameter. - acquire - If set this will be the maximum time to wait for a free @@ -569,6 +555,20 @@ expressions in the pool the Apache will return SERVER_BUSY status to the client. + flushpackets + off + Determines whether the proxy module will auto-flush the output + brigade after each "chunk" of data. 'off' means that it will flush + only when needed, 'on' means after each chunk is sent and + 'auto' means poll/wait for a period of time and flush if + no input has been received for 'flushwait' milliseconds. + Currently this is in effect only for AJP. + + flushwait + 10 + The time to wait for additional input, in milliseconds, before + flushing the output brigade if 'flushpackets' is 'auto'. + keepalive Off This parameter should be used when you have a firewall between your @@ -578,6 +578,20 @@ expressions generally 120ms), and thus prevent the firewall to drop the connection. To enable keepalive set this property value to On. + loadfactor + 1 + Worker load factor. Used with BalancerMember. + It is a number between 1 and 100 and defines the normalized weighted + load applied to the worker. + + redirect + - + Redirection Route of the worker. This value is usually + set dynamically to enable safe removal of the node from + the cluster. If set all requests without session id will be + redirected to the BalancerMember that has route parametar + equal as this value. + retry 60 Connection pool worker retry timeout in seconds. @@ -586,24 +600,33 @@ expressions expires. This enables to shut down the backend server for maintenance, and bring it back online later. - loadfactor - 1 - Worker load factor. Used with BalancerMember. - It is a number between 1 and 100 and defines the normalized weighted - load applied to the worker. - route - Route of the worker when used inside load balancer. The route is a value appended to seesion id. - redirect + status - - Redirection Route of the worker. This value is usually - set dynamically to enable safe removal of the node from - the cluster. If set all requests without session id will be - redirected to the BalancerMember that has route parametar - equal as this value. + Single letter value defining the initial status of + this worker: 'D' is disabled, 'S' is stopped + and 'E' is in an error state. Status can be set (which is the default) + by prepending with '+' or cleared by prepending with '-'. + Thus, a setting of 'S-E' sets this worker to Stopped and + clears the in-error flag. + + timeout + Timeout + Connection timeout in seconds. + If not set the Apache will wait until the free connection + is available. This directive is used for limiting the number + of connections to the backend server together with max + parameter. + + ttl + - + Time To Live for the inactive connections above the + smax connections in seconds. Apache will close all + connections that has not been used inside that time period. @@ -612,24 +635,23 @@ expressions balancer:// then a virtual worker that does not really communicate with the backend server will be created. Instead it is responsible for the management of several "real" workers. In that case the special set of - parameters can be add to this virtual worker. + parameters can be add to this virtual worker. See mod_proxy_balancer + for more information about how the balancer works.

- + - - - + + @@ -637,17 +659,20 @@ expressions error state or disabled. Set this value to On if backend servers do not support session replication. + + + - - -
Parameter Default Description
lbmethod-byrequests Balancer load-balance method. Select the load-balancing scheduler method to use. Either byrequests, to perform weighted request counting or bytraffic, to perform weighted traffic byte count balancing. Default is byrequests.
stickysession-Balancer sticky session name. The value is usually set to something - like JSESSIONID or PHPSESSIONID, - and it depends on the backend application server that support sessions. +
maxattempts1Maximum number of failover attempts before giving up.
nofailover Off
stickysession-Balancer sticky session name. The value is usually set to something + like JSESSIONID or PHPSESSIONID, + and it depends on the backend application server that support sessions. +
timeout 0 Balancer timeout in seconds. If set this will be the maximum time to wait for a free worker. Default is not to wait.
maxattempts1Maximum number of failover attempts before giving up. -
+

A sample balancer setup

ProxyPass /special-area http://special.example.com/ smax=5 max=10
ProxyPass / balancer://mycluster stickysession=jsessionid nofailover=On