From: Jim Jagielski Date: Wed, 3 Feb 2016 13:19:39 +0000 (+0000) Subject: Better explanation... use as table X-Git-Tag: 2.5.0-alpha~2214 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=ed782b672025ae12c8f8356986604acf0e0c9861;p=apache Better explanation... use as table git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1728305 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/manual/mod/mod_proxy.xml b/docs/manual/mod/mod_proxy.xml index b27ef9b59f..7e6b358640 100644 --- a/docs/manual/mod/mod_proxy.xml +++ b/docs/manual/mod/mod_proxy.xml @@ -835,7 +835,7 @@ expressions Warning

Keep in mind that the same parameter key can have a different meaning - depending whether it is applied to a balancer or a worker, as shown by + depending whether it is applied to a balancer or a worker, as shown by the two examples above regarding timeout.

@@ -1083,8 +1083,8 @@ ProxyPass "/example" "http://backend.example.com" max=20 ttl=120 retry=300

This parameter should be used when you have a firewall between your Apache httpd and the backend server, which tends to drop inactive connections. This flag will tell the Operating System to send KEEP_ALIVE - messages on inactive connections and thus prevent the firewall - from dropping the connection. + messages on inactive connections and thus prevent the firewall + from dropping the connection. To enable keepalive, set this property value to On.

The frequency of initial and subsequent TCP keepalive probes depends on global OS settings, and may be as high as 2 hours. To be useful, @@ -1152,16 +1152,18 @@ ProxyPass "/example" "http://backend.example.com" max=20 ttl=120 retry=300 Single letter value defining the initial status of this worker. - - - - + + + - - + -
D: Worker is disabled and will not accept any requests.
S: Worker is administratively stopped.
I: Worker is in ignore-errors mode and will always be considered available.
H: Worker is in hot-standby mode and will only be used if no other +
DWorker is disabled and will not accept any requests; will be + automatically retried.
SWorker is administratively stopped; will not accept requests + and will not be automatically retried
IWorker is in ignore-errors mode and will always be considered available.
HWorker is in hot-standby mode and will only be used if no other viable workers are available.
E: Worker is in an error state.
N: Worker is in drain mode and will only accept existing sticky sessions +
EWorker is in an error state.
NWorker is in drain mode and will only accept existing sticky sessions destined for itself and ignore all other requests.
Status - can be set (which is the default) by prepending with '+' or + + 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. @@ -1319,7 +1321,7 @@ ProxyPass "/" "balancer://hotcluster/" But this may be incompatible with some backends, particularly those that make use of PATH_INFO. The optional nocanon keyword suppresses this and passes the URL path "raw" to the - backend. Note that this keyword may affect the security of your backend, + backend. Note that this keyword may affect the security of your backend, as it removes the normal limited protection against URL-based attacks provided by the proxy.

@@ -1470,7 +1472,7 @@ ProxyPassReverseCookiePath "/" "/mirror/foo/"

will not only cause a local request for the http://example.com/mirror/foo/bar to be internally converted into a proxy request to http://backend.example.com/bar - (the functionality which ProxyPass provides here). + (the functionality which ProxyPass provides here). It also takes care of redirects which the server backend.example.com sends when redirecting http://backend.example.com/bar to http://backend.example.com/quux . Apache httpd adjusts this to