|
2 | 2 | <html lang="en"> |
3 | 3 | <head> |
4 | 4 | <meta charset="utf-8" /> |
5 | | - <title>HAProxy version 3.4-dev7-56 - Configuration Manual</title> |
| 5 | + <title>HAProxy version 3.4-dev7-63 - Configuration Manual</title> |
6 | 6 | <link href="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" rel="stylesheet" /> |
7 | 7 | <link href="https://raw.githubusercontent.com/thomaspark/bootswatch/v3.3.7/cerulean/bootstrap.min.css" rel="stylesheet" /> |
8 | 8 | <link href="../css/page.css?0.4.2-15" rel="stylesheet" /> |
|
4829 | 4829 | You can use <strong>left</strong> and <strong>right</strong> arrow keys to navigate between chapters.<br> |
4830 | 4830 | </p> |
4831 | 4831 | <p class="text-right"> |
4832 | | - <small>Converted with <a href="https://github.com/cbonte/haproxy-dconv">haproxy-dconv</a> v<b>0.4.2-15</b> on <b>2026/03/23</b></small> |
| 4832 | + <small>Converted with <a href="https://github.com/cbonte/haproxy-dconv">haproxy-dconv</a> v<b>0.4.2-15</b> on <b>2026/03/27</b></small> |
4833 | 4833 | </p> |
4834 | 4834 | </div> |
4835 | 4835 | <!-- /.sidebar --> |
|
4840 | 4840 | <div class="text-center"> |
4841 | 4841 | <h1><a href="http://www.haproxy.org/" title="HAProxy"><img src="../img/HAProxyCommunityEdition_60px.png?0.4.2-15" /></a></h1> |
4842 | 4842 | <h2>Configuration Manual</h2> |
4843 | | - <p><strong>version 3.4-dev7-56</strong></p> |
| 4843 | + <p><strong>version 3.4-dev7-63</strong></p> |
4844 | 4844 | <p> |
4845 | 4845 | 2026/03/20<br> |
4846 | 4846 |
|
@@ -10201,21 +10201,21 @@ <h2 id="chapter-3.2" data-target="3.2"><small><a class="small" href="#3.2">3.2.< |
10201 | 10201 | too when headers are encoded to comply to limitation imposed by the |
10202 | 10202 | protocols. This limit is large enough but not documented on purpose. The same |
10203 | 10203 | limit is applied on the first steps of the decoding for the same reason. |
10204 | | -</pre><a class="anchor" name="tune.idle-pool.shared"></a><a class="anchor" name="3-tune.idle-pool.shared"></a><a class="anchor" name="3.2-tune.idle-pool.shared"></a><a class="anchor" name="tune.idle-pool.shared (Global section)"></a><a class="anchor" name="tune.idle-pool.shared (Performance tuning)"></a><div class="keyword"><b><a class="anchor" name="tune.idle-pool.shared"></a><a href="#3.2-tune.idle-pool.shared">tune.idle-pool.shared</a></b> <span style="color: #800">{ on | off }</span></div><pre class="text">Enables ('on') or disables ('off') sharing of idle connection pools between |
10205 | | -threads for a same server. The default is to share them between threads in |
10206 | | -order to minimize the number of persistent connections to a server, and to |
10207 | | -optimize the connection reuse rate. But to help with debugging or when |
| 10204 | +</pre><a class="anchor" name="tune.idle-pool.shared"></a><a class="anchor" name="3-tune.idle-pool.shared"></a><a class="anchor" name="3.2-tune.idle-pool.shared"></a><a class="anchor" name="tune.idle-pool.shared (Global section)"></a><a class="anchor" name="tune.idle-pool.shared (Performance tuning)"></a><div class="keyword"><b><a class="anchor" name="tune.idle-pool.shared"></a><a href="#3.2-tune.idle-pool.shared">tune.idle-pool.shared</a></b> <span style="color: #800">{ auto | on | off }</span></div><pre class="text">Controls sharing idle connection pools between threads for a same server. |
| 10205 | +It can be enabled for all threads in a same thread group ('on'), enabled for |
| 10206 | +all threads ('full') or disabled ('off'). The default is to share them |
| 10207 | +between threads in the same thread group ('on'), in order to minimize the |
| 10208 | +number of persistent connections to a server, and to optimize the connection |
| 10209 | +reuse rate. Sharing with threads from other thread groups can have a |
| 10210 | +performance impact, and is not enabled by default, but can be useful if |
| 10211 | +maximizing connection reuse is a priority. To help with debugging or when |
10208 | 10212 | suspecting a bug in HAProxy around connection reuse, it can be convenient to |
10209 | | -forcefully disable this idle pool sharing between multiple threads, and force |
10210 | | -this option to "off". The default is on. It is strongly recommended against |
10211 | | -disabling this option without setting a conservative value on "<a href="#pool-low-conn">pool-low-conn</a>" |
10212 | | -for all servers relying on connection reuse to achieve a high performance |
10213 | | -level, otherwise connections might be closed very often as the thread count |
10214 | | -increases. Note that in any case, connections are only shared between threads |
10215 | | -of the same thread group. This means that systems with many NUMA nodes may |
10216 | | -show slightly more persistent connections while machines with unified caches |
10217 | | -and many CPU cores per node may experience higher CPU usage. In the latter |
10218 | | -case, the "max-thread-per-group" tunable may be used to improve the behavior. |
| 10213 | +forcefully disable this idle pool sharing between multiple threads, |
| 10214 | +and force this option to "off". It is strongly recommended against disabling |
| 10215 | +this option without setting a conservative value on "<a href="#pool-low-conn">pool-low-conn</a>" for all |
| 10216 | +servers relying on connection reuse to achieve a high performance level, |
| 10217 | +otherwise connections might be closed very often as the thread count |
| 10218 | +increases. |
10219 | 10219 | </pre><a class="anchor" name="tune.idletimer"></a><a class="anchor" name="3-tune.idletimer"></a><a class="anchor" name="3.2-tune.idletimer"></a><a class="anchor" name="tune.idletimer (Global section)"></a><a class="anchor" name="tune.idletimer (Performance tuning)"></a><div class="keyword"><b><a class="anchor" name="tune.idletimer"></a><a href="#3.2-tune.idletimer">tune.idletimer</a></b> <span style="color: #080"><timeout></span></div><pre class="text">Sets the duration after which HAProxy will consider that an empty buffer is |
10220 | 10220 | probably associated with an idle stream. This is used to optimally adjust |
10221 | 10221 | some packet sizes while forwarding large and small data alternatively. The |
@@ -10961,6 +10961,9 @@ <h2 id="chapter-3.2" data-target="3.2"><small><a class="small" href="#3.2">3.2.< |
10961 | 10961 | connections. |
10962 | 10962 | Note that using connections from other thread groups can occur performance |
10963 | 10963 | penalties, so it should not be used unless really needed. |
| 10964 | +Note that this behavior is now controlled by tune.idle-pool.shared, and |
| 10965 | +this keyword is just there for compatibility with older configurations, and |
| 10966 | +will be deprecated. |
10964 | 10967 | </pre><a class="anchor" name="tune.vars.global-max-size"></a><a class="anchor" name="3-tune.vars.global-max-size"></a><a class="anchor" name="3.2-tune.vars.global-max-size"></a><a class="anchor" name="tune.vars.global-max-size (Global section)"></a><a class="anchor" name="tune.vars.global-max-size (Performance tuning)"></a><div class="keyword"><b><a class="anchor" name="tune.vars.global-max-size"></a><a href="#3.2-tune.vars.global-max-size">tune.vars.global-max-size</a></b> <span style="color: #080"><size></span></div><a class="anchor" name="tune.vars.proc-max-size"></a><a class="anchor" name="3-tune.vars.proc-max-size"></a><a class="anchor" name="3.2-tune.vars.proc-max-size"></a><a class="anchor" name="tune.vars.proc-max-size (Global section)"></a><a class="anchor" name="tune.vars.proc-max-size (Performance tuning)"></a><div class="keyword"><b><a class="anchor" name="tune.vars.proc-max-size"></a><a href="#3.2-tune.vars.proc-max-size">tune.vars.proc-max-size</a></b> <span style="color: #080"><size></span></div><a class="anchor" name="tune.vars.reqres-max-size"></a><a class="anchor" name="3-tune.vars.reqres-max-size"></a><a class="anchor" name="3.2-tune.vars.reqres-max-size"></a><a class="anchor" name="tune.vars.reqres-max-size (Global section)"></a><a class="anchor" name="tune.vars.reqres-max-size (Performance tuning)"></a><div class="keyword"><b><a class="anchor" name="tune.vars.reqres-max-size"></a><a href="#3.2-tune.vars.reqres-max-size">tune.vars.reqres-max-size</a></b> <span style="color: #080"><size></span></div><a class="anchor" name="tune.vars.sess-max-size"></a><a class="anchor" name="3-tune.vars.sess-max-size"></a><a class="anchor" name="3.2-tune.vars.sess-max-size"></a><a class="anchor" name="tune.vars.sess-max-size (Global section)"></a><a class="anchor" name="tune.vars.sess-max-size (Performance tuning)"></a><div class="keyword"><b><a class="anchor" name="tune.vars.sess-max-size"></a><a href="#3.2-tune.vars.sess-max-size">tune.vars.sess-max-size</a></b> <span style="color: #080"><size></span></div><a class="anchor" name="tune.vars.txn-max-size"></a><a class="anchor" name="3-tune.vars.txn-max-size"></a><a class="anchor" name="3.2-tune.vars.txn-max-size"></a><a class="anchor" name="tune.vars.txn-max-size (Global section)"></a><a class="anchor" name="tune.vars.txn-max-size (Performance tuning)"></a><div class="keyword"><b><a class="anchor" name="tune.vars.txn-max-size"></a><a href="#3.2-tune.vars.txn-max-size">tune.vars.txn-max-size</a></b> <span style="color: #080"><size></span></div><pre class="text">These five tunes help to manage the maximum amount of memory used by the |
10965 | 10968 | variables system. "global" limits the overall amount of memory available for |
10966 | 10969 | all scopes. "<a href="#proc">proc</a>" limits the memory for the process scope, "sess" limits the |
@@ -34871,7 +34874,7 @@ <h2 id="chapter-12.8" data-target="12.8"><small><a class="small" href="#12.8">12 |
34871 | 34874 | <br> |
34872 | 34875 | <hr> |
34873 | 34876 | <div class="text-right"> |
34874 | | - HAProxy 3.4-dev7-56 – Configuration Manual<br> |
| 34877 | + HAProxy 3.4-dev7-63 – Configuration Manual<br> |
34875 | 34878 | <small>, 2026/03/20</small> |
34876 | 34879 | </div> |
34877 | 34880 | </div> |
|
0 commit comments