You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@httpd.apache.org by Jim Jagielski <ji...@jaguNET.com> on 2016/02/09 13:25:44 UTC
balancer-manager docs
We currently have really really little info about the balancer-
manager in our docs, just a short little blurb on how to enable
it and a brief description of what it does [1]. I'd like to extend
that, but does it make sense to add it to the mod_proxy_balancer
module page, or have a separate page dedicated to it which we can
link to?
1. https://httpd.apache.org/docs/trunk/mod/mod_proxy_balancer.html
Re: balancer-manager docs
Posted by Tim Bannister <is...@c8h10n4o2.org.uk>.
On 9 Feb 2016, at 17:55, Tim Bannister <is...@c8h10n4o2.org.uk> wrote:
>
> The module pages can document the module; I think that's appropriate for reference documentation.
>
> What's missing is more of a “how do I set up X” guide. I think the topics could be:
>
> • forward proxy (and access control) with or without cacheing
> • reverse proxy with or without cacheing
> • balancing and high availability for reverse proxies
>
> I think this is me volunteering to at least draft some text, if people agree this approach makes sense.
Draft attached. I hope it's useful.
I've not been able to get the docs build to work (having only tried it today), and my limited previous experience with Ant makes me suspect if it's not a quick fix it's going to be a much longer haul. I know the XML is valid, I don't know what it might look like post-transformation.
Also, there is no images/forward-proxy-arch.svg – I just put that in as a placeholder.
Tim
Re: balancer-manager docs
Posted by Luca Toscano <to...@gmail.com>.
I like the how-to a lot!
Would it be useful to add a "logging" section explaining best practices
about how to enable logging of the various modules?
A lot of people ask for instruction about how to track what mod_proxy does
in the background, plus I think it would be really useful to have a history
of the status of each BalancerMember over time (for example to correlate
when a backend server was put out of the Balancer set due to health check
failures with access/error/etc.. logs after an outage - a balancer-manager
history written down somewhere).
Hope that this make sense!
Luca
2016-02-12 10:04 GMT+01:00 Daniel <df...@gmail.com>:
> Looks very nice indeed! For being a "rough" version looks quite complete.
> Also the diagram is a cool addition to help people understand how reverse
> proxying works.
>
> I think the examples may need some adjusting with the matching slashes:
>
> ProxyPass "/" "http://www.example.com"
> should be:
> ProxyPass / http://www.example.com/
> (I removed the quotes because they are not necessary)
>
> and
> ProxyPass "/images" "http://www.example.com"
> should be:
> ProxyPass /images/ http://www.example.com/
>
>
> Cheers!
>
>
>
>
> El vie., 12 feb. 2016 a las 9:48, Stefan Eissing (<
> stefan.eissing@greenbytes.de>) escribió:
>
>> Very nice!
>>
>> > Am 11.02.2016 um 18:46 schrieb Jim Jagielski <ji...@apache.org>:
>> >
>> > A rough and very brief framework of such a guide is now available...
>> >
>> > http://httpd.apache.org/docs/trunk/howto/reverse_proxy.html
>> >
>> > On 2016-02-10 06:21, Luca Toscano <to...@gmail.com> wrote:
>> >> 2016-02-10 10:33 GMT+01:00 Stefan Eissing <
>> stefan.eissing@greenbytes.de>:
>> >>
>> >>> If you write one, I write one for http2! :-)
>> >>>
>> >>>
>> >> +1+1+1+1 :)
>> >>
>> > ------
>> > Sent via Pony Mail for dev@httpd.apache.org.
>> > View this email online at:
>> > https://pony-poc.apache.org/list.html?dev@httpd.apache.org
>>
>>
Re: balancer-manager docs
Posted by Daniel <df...@gmail.com>.
Looks very nice indeed! For being a "rough" version looks quite complete.
Also the diagram is a cool addition to help people understand how reverse
proxying works.
I think the examples may need some adjusting with the matching slashes:
ProxyPass "/" "http://www.example.com"
should be:
ProxyPass / http://www.example.com/
(I removed the quotes because they are not necessary)
and
ProxyPass "/images" "http://www.example.com"
should be:
ProxyPass /images/ http://www.example.com/
Cheers!
El vie., 12 feb. 2016 a las 9:48, Stefan Eissing (<
stefan.eissing@greenbytes.de>) escribió:
> Very nice!
>
> > Am 11.02.2016 um 18:46 schrieb Jim Jagielski <ji...@apache.org>:
> >
> > A rough and very brief framework of such a guide is now available...
> >
> > http://httpd.apache.org/docs/trunk/howto/reverse_proxy.html
> >
> > On 2016-02-10 06:21, Luca Toscano <to...@gmail.com> wrote:
> >> 2016-02-10 10:33 GMT+01:00 Stefan Eissing <stefan.eissing@greenbytes.de
> >:
> >>
> >>> If you write one, I write one for http2! :-)
> >>>
> >>>
> >> +1+1+1+1 :)
> >>
> > ------
> > Sent via Pony Mail for dev@httpd.apache.org.
> > View this email online at:
> > https://pony-poc.apache.org/list.html?dev@httpd.apache.org
>
>
Re: balancer-manager docs
Posted by Stefan Eissing <st...@greenbytes.de>.
Very nice!
> Am 11.02.2016 um 18:46 schrieb Jim Jagielski <ji...@apache.org>:
>
> A rough and very brief framework of such a guide is now available...
>
> http://httpd.apache.org/docs/trunk/howto/reverse_proxy.html
>
> On 2016-02-10 06:21, Luca Toscano <to...@gmail.com> wrote:
>> 2016-02-10 10:33 GMT+01:00 Stefan Eissing <st...@greenbytes.de>:
>>
>>> If you write one, I write one for http2! :-)
>>>
>>>
>> +1+1+1+1 :)
>>
> ------
> Sent via Pony Mail for dev@httpd.apache.org.
> View this email online at:
> https://pony-poc.apache.org/list.html?dev@httpd.apache.org
Re: balancer-manager docs
Posted by Jim Jagielski <ji...@apache.org>.
A rough and very brief framework of such a guide is now available...
http://httpd.apache.org/docs/trunk/howto/reverse_proxy.html
On 2016-02-10 06:21, Luca Toscano <to...@gmail.com> wrote:
> 2016-02-10 10:33 GMT+01:00 Stefan Eissing <st...@greenbytes.de>:
>
> > If you write one, I write one for http2! :-)
> >
> >
> +1+1+1+1 :)
>
------
Sent via Pony Mail for dev@httpd.apache.org.
View this email online at:
https://pony-poc.apache.org/list.html?dev@httpd.apache.org
Re: balancer-manager docs
Posted by Luca Toscano <to...@gmail.com>.
2016-02-10 10:33 GMT+01:00 Stefan Eissing <st...@greenbytes.de>:
> If you write one, I write one for http2! :-)
>
>
+1+1+1+1 :)
Re: balancer-manager docs
Posted by Luca Toscano <to...@gmail.com>.
2016-02-10 10:33 GMT+01:00 Stefan Eissing <st...@greenbytes.de>:
> If you write one, I write one for http2! :-)
>
>
+1+1+1+1 :)
Re: balancer-manager docs
Posted by Stefan Eissing <st...@greenbytes.de>.
If you write one, I write one for http2! :-)
> Am 09.02.2016 um 21:36 schrieb Luca Toscano <to...@gmail.com>:
>
> Hi Jim,
>
> 2016-02-09 21:25 GMT+01:00 Jim Jagielski <ji...@jagunet.com>:
> The more I think of it, a HowTo guide, like the ones we have
> for public_html, Authn&Authz, etc regarding reverse proxy
> makes the most sense...
>
> > On Feb 9, 2016, at 12:55 PM, Tim Bannister <is...@c8h10n4o2.org.uk> wrote:
> >
> > On 9 Feb 2016, at 16:02, Rainer Jung <ra...@kippdata.de> wrote:
> > The module pages can document the module; I think that's appropriate for reference documentation.
> >
> > What's missing is more of a “how do I set up X” guide. I think the topics could be:
> >
> > • forward proxy (and access control) with or without cacheing
> > • reverse proxy with or without cacheing
> > • balancing and high availability for reverse proxies
> >
> > I think this is me volunteering to at least draft some text, if people agree this approach makes sense.
>
> +1 for the howto guides suggested by Tim and separate pages for each module for whoever is interested to dive deep into options.
>
> Ideally the howto summary page (https://httpd.apache.org/docs/trunk/howto/) could be linked to https://httpd.apache.org/download.cgi as "suggested list" of things to bookmark for whoever is interested in httpd.
>
> Also I volunteer for helping writing/reviewing the new docs if needed :)
>
> Luca
>
>
>
>
Re: balancer-manager docs
Posted by Luca Toscano <to...@gmail.com>.
Hi Jim,
2016-02-09 21:25 GMT+01:00 Jim Jagielski <ji...@jagunet.com>:
> The more I think of it, a HowTo guide, like the ones we have
> for public_html, Authn&Authz, etc regarding reverse proxy
> makes the most sense...
>
> > On Feb 9, 2016, at 12:55 PM, Tim Bannister <is...@c8h10n4o2.org.uk>
> wrote:
> >
> > On 9 Feb 2016, at 16:02, Rainer Jung <ra...@kippdata.de> wrote:
> > The module pages can document the module; I think that's appropriate for
> reference documentation.
> >
> > What's missing is more of a “how do I set up X” guide. I think the
> topics could be:
> >
> > • forward proxy (and access control) with or without cacheing
> > • reverse proxy with or without cacheing
> > • balancing and high availability for reverse proxies
> >
> > I think this is me volunteering to at least draft some text, if people
> agree this approach makes sense.
>
+1 for the howto guides suggested by Tim and separate pages for each module
for whoever is interested to dive deep into options.
Ideally the howto summary page (https://httpd.apache.org/docs/trunk/howto/)
could be linked to https://httpd.apache.org/download.cgi as "suggested
list" of things to bookmark for whoever is interested in httpd.
Also I volunteer for helping writing/reviewing the new docs if needed :)
Luca
Re: balancer-manager docs
Posted by Daniel <df...@gmail.com>.
Sorry for the intrusion.
Since you guys are on it, a brief description telling that mod_slotmem_XXX
is REQUIRED if you choose to load any type of mod_lbmethod would also be a
good tip to add in the docs.
Cheers!
El mié., 10 feb. 2016 a las 22:08, Jim Jagielski (<ji...@jagunet.com>)
escribió:
> Work in progress in:
>
> docs/manual/howto/reverse_proxy.xml
>
> cheers!
>
Re: balancer-manager docs
Posted by Jim Jagielski <ji...@jaguNET.com>.
Work in progress in:
docs/manual/howto/reverse_proxy.xml
cheers!
Re: balancer-manager docs
Posted by Luca Toscano <to...@gmail.com>.
Hi Jim,
2016-02-09 21:25 GMT+01:00 Jim Jagielski <ji...@jagunet.com>:
> The more I think of it, a HowTo guide, like the ones we have
> for public_html, Authn&Authz, etc regarding reverse proxy
> makes the most sense...
>
> > On Feb 9, 2016, at 12:55 PM, Tim Bannister <is...@c8h10n4o2.org.uk>
> wrote:
> >
> > On 9 Feb 2016, at 16:02, Rainer Jung <ra...@kippdata.de> wrote:
> > The module pages can document the module; I think that's appropriate for
> reference documentation.
> >
> > What's missing is more of a “how do I set up X” guide. I think the
> topics could be:
> >
> > • forward proxy (and access control) with or without cacheing
> > • reverse proxy with or without cacheing
> > • balancing and high availability for reverse proxies
> >
> > I think this is me volunteering to at least draft some text, if people
> agree this approach makes sense.
>
+1 for the howto guides suggested by Tim and separate pages for each module
for whoever is interested to dive deep into options.
Ideally the howto summary page (https://httpd.apache.org/docs/trunk/howto/)
could be linked to https://httpd.apache.org/download.cgi as "suggested
list" of things to bookmark for whoever is interested in httpd.
Also I volunteer for helping writing/reviewing the new docs if needed :)
Luca
Re: balancer-manager docs
Posted by Jim Jagielski <ji...@jaguNET.com>.
Work in progress in:
docs/manual/howto/reverse_proxy.xml
cheers!
---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org
Re: balancer-manager docs
Posted by Jim Jagielski <ji...@jaguNET.com>.
The more I think of it, a HowTo guide, like the ones we have
for public_html, Authn&Authz, etc regarding reverse proxy
makes the most sense...
> On Feb 9, 2016, at 12:55 PM, Tim Bannister <is...@c8h10n4o2.org.uk> wrote:
>
> On 9 Feb 2016, at 16:02, Rainer Jung <ra...@kippdata.de> wrote:
>> Am 09.02.2016 um 13:25 schrieb Jim Jagielski:
>>> We currently have really really little info about the balancer-manager in our docs, just a short little blurb on how to enable it and a brief description of what it does [1]. I'd like to extend that, but does it make sense to add it to the mod_proxy_balancer module page, or have a separate page dedicated to it which we can link to?
>>>
>>> 1. https://httpd.apache.org/docs/trunk/mod/mod_proxy_balancer.html
>>
>> Adding even more questions:
>>
>> I always think it is confusing for newbies, that all configuration directives for any mod_proxy_* are documented on the mod_proxy page. Although this reflects the code, config is done by mod_proxy, it is not what a user would expect. If e.g. He is working with a balancer, he would expect more info about how to configure a balancer in the mod_proxy_balancer page.
>
> Cc: to docs@
>
> The module pages can document the module; I think that's appropriate for reference documentation.
>
> What's missing is more of a “how do I set up X” guide. I think the topics could be:
>
> • forward proxy (and access control) with or without cacheing
> • reverse proxy with or without cacheing
> • balancing and high availability for reverse proxies
>
> I think this is me volunteering to at least draft some text, if people agree this approach makes sense.
>
> --
> Tim Bannister – isoma@c8h10n4o2.org.uk
>
Re: balancer-manager docs
Posted by Jim Jagielski <ji...@jaguNET.com>.
The more I think of it, a HowTo guide, like the ones we have
for public_html, Authn&Authz, etc regarding reverse proxy
makes the most sense...
> On Feb 9, 2016, at 12:55 PM, Tim Bannister <is...@c8h10n4o2.org.uk> wrote:
>
> On 9 Feb 2016, at 16:02, Rainer Jung <ra...@kippdata.de> wrote:
>> Am 09.02.2016 um 13:25 schrieb Jim Jagielski:
>>> We currently have really really little info about the balancer-manager in our docs, just a short little blurb on how to enable it and a brief description of what it does [1]. I'd like to extend that, but does it make sense to add it to the mod_proxy_balancer module page, or have a separate page dedicated to it which we can link to?
>>>
>>> 1. https://httpd.apache.org/docs/trunk/mod/mod_proxy_balancer.html
>>
>> Adding even more questions:
>>
>> I always think it is confusing for newbies, that all configuration directives for any mod_proxy_* are documented on the mod_proxy page. Although this reflects the code, config is done by mod_proxy, it is not what a user would expect. If e.g. He is working with a balancer, he would expect more info about how to configure a balancer in the mod_proxy_balancer page.
>
> Cc: to docs@
>
> The module pages can document the module; I think that's appropriate for reference documentation.
>
> What's missing is more of a “how do I set up X” guide. I think the topics could be:
>
> • forward proxy (and access control) with or without cacheing
> • reverse proxy with or without cacheing
> • balancing and high availability for reverse proxies
>
> I think this is me volunteering to at least draft some text, if people agree this approach makes sense.
>
> --
> Tim Bannister – isoma@c8h10n4o2.org.uk
>
---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org
Re: balancer-manager docs
Posted by Tim Bannister <is...@c8h10n4o2.org.uk>.
On 9 Feb 2016, at 16:02, Rainer Jung <ra...@kippdata.de> wrote:
> Am 09.02.2016 um 13:25 schrieb Jim Jagielski:
>> We currently have really really little info about the balancer-manager in our docs, just a short little blurb on how to enable it and a brief description of what it does [1]. I'd like to extend that, but does it make sense to add it to the mod_proxy_balancer module page, or have a separate page dedicated to it which we can link to?
>>
>> 1. https://httpd.apache.org/docs/trunk/mod/mod_proxy_balancer.html
>
> Adding even more questions:
>
> I always think it is confusing for newbies, that all configuration directives for any mod_proxy_* are documented on the mod_proxy page. Although this reflects the code, config is done by mod_proxy, it is not what a user would expect. If e.g. He is working with a balancer, he would expect more info about how to configure a balancer in the mod_proxy_balancer page.
Cc: to docs@
The module pages can document the module; I think that's appropriate for reference documentation.
What's missing is more of a “how do I set up X” guide. I think the topics could be:
• forward proxy (and access control) with or without cacheing
• reverse proxy with or without cacheing
• balancing and high availability for reverse proxies
I think this is me volunteering to at least draft some text, if people agree this approach makes sense.
--
Tim Bannister – isoma@c8h10n4o2.org.uk
Re: balancer-manager docs
Posted by Rainer Jung <ra...@kippdata.de>.
Am 09.02.2016 um 13:25 schrieb Jim Jagielski:
> We currently have really really little info about the balancer-
> manager in our docs, just a short little blurb on how to enable
> it and a brief description of what it does [1]. I'd like to extend
> that, but does it make sense to add it to the mod_proxy_balancer
> module page, or have a separate page dedicated to it which we can
> link to?
>
>
> 1. https://httpd.apache.org/docs/trunk/mod/mod_proxy_balancer.html
Adding even more questions:
I always think it is confusing for newbies, that all configuration
directives for any mod_proxy_* are documented on the mod_proxy page.
Although this reflects the code, config is done by mod_proxy, it is not
what a user would expect. If e.g. He is working with a balancer, he
would expect more info about how to configure a balancer in the
mod_proxy_balancer page.
So I wonder whether proxy is an example, where the config reference
should move to the docs page, for the module that is actually being
configured, not the module that handles the configuration. I guess
that's not possible without some redundancy and it's not an easy call to
decide, what should go to the central mod_proxy page, and what to
individual mod_proxy_xyz pages.
There are other cases as well (ajp, fcgi, ...).
Regards,
Rainer