Skip to content

Commit d2bd0fd

Browse files
author
HAProxy Community
committed
Update docs for dev
1 parent 1cd8006 commit d2bd0fd

3 files changed

Lines changed: 30 additions & 17 deletions

File tree

‎docs/dev/configuration.html‎

Lines changed: 22 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
<html lang="en">
33
<head>
44
<meta charset="utf-8" />
5-
<title>HAProxy version 3.4-dev3-30 - Configuration Manual</title>
5+
<title>HAProxy version 3.4-dev4-1 - Configuration Manual</title>
66
<link href="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" rel="stylesheet" />
77
<link href="https://raw.githubusercontent.com/thomaspark/bootswatch/v3.3.7/cerulean/bootstrap.min.css" rel="stylesheet" />
88
<link href="../css/page.css?0.4.2-15" rel="stylesheet" />
@@ -4787,7 +4787,7 @@
47874787
You can use <strong>left</strong> and <strong>right</strong> arrow keys to navigate between chapters.<br>
47884788
</p>
47894789
<p class="text-right">
4790-
<small>Converted with <a href="https://github.com/cbonte/haproxy-dconv">haproxy-dconv</a> v<b>0.4.2-15</b> on <b>2026/02/03</b></small>
4790+
<small>Converted with <a href="https://github.com/cbonte/haproxy-dconv">haproxy-dconv</a> v<b>0.4.2-15</b> on <b>2026/02/04</b></small>
47914791
</p>
47924792
</div>
47934793
<!-- /.sidebar -->
@@ -4798,9 +4798,9 @@
47984798
<div class="text-center">
47994799
<h1><a href="http://www.haproxy.org/" title="HAProxy"><img src="../img/HAProxyCommunityEdition_60px.png?0.4.2-15" /></a></h1>
48004800
<h2>Configuration Manual</h2>
4801-
<p><strong>version 3.4-dev3-30</strong></p>
4801+
<p><strong>version 3.4-dev4-1</strong></p>
48024802
<p>
4803-
2026/01/22<br>
4803+
2026/02/04<br>
48044804

48054805
</p>
48064806
</div>
@@ -11573,8 +11573,16 @@ <h2 id="chapter-4.2" data-target="4.2"><small><a class="small" href="#4.2">4.2.<
1157311573
will take away N-1 of the highest loaded servers at the
1157411574
expense of performance. With very high values, the algorithm
1157511575
will converge towards the leastconn's result but much slower.
11576+
In addition, for large server farms with very low loads (or
11577+
perfect balance), comparing loads will often lead to a tie,
11578+
so in case of equal loads between all measured servers, their
11579+
request rate over the last second are compared, which allows
11580+
to better balance server usage over time in the same spirit
11581+
as roundrobin does, and smooth consistent hash unfairness.
1157611582
The default value is 2, which generally shows very good
11577-
distribution and performance. This algorithm is also known as
11583+
distribution and performance. For large farms with low loads
11584+
(less than a few requests per second per server), it may help
11585+
to raise it to 3 or even 4. This algorithm is also known as
1157811586
the Power of Two Random Choices and is described here :
1157911587
http://www.eecs.harvard.edu/~michaelm/postscripts/handbook2001.pdf
1158011588

@@ -22674,7 +22682,10 @@ <h2 id="chapter-5.2" data-target="5.2"><small><a class="small" href="#5.2">5.2.<
2267422682

2267522683
id The node keys will be derived from the server's numeric
2267622684
identifier as set from &quot;<span class="dropdown"><a class="dropdown-toggle" data-toggle="dropdown" href="#">id<span class="caret"></span></a><ul class="dropdown-menu"><li class="dropdown-header">This keyword is available in sections :</li><li><a href="#id%20%28Alphabetically%20sorted%20keywords%20reference%29">Alphabetically sorted keywords reference</a></li><li><a href="#id%20%28Bind%20options%29">Bind options</a></li><li><a href="#id%20%28Server%20and%20default-server%20options%29">Server and default-server options</a></li></ul></span>&quot; or which defaults to its position
22677-
in the server list.
22685+
in the server list. This is the default. Note that only the 28
22686+
lowest bits of the ID will be used (i.e. (id % 268435456)), so
22687+
better only use values comprised between 1 and this value to
22688+
avoid overlap.
2267822689

2267922690
addr The node keys will be derived from the server's address, when
2268022691
available, or else fall back on &quot;<span class="dropdown"><a class="dropdown-toggle" data-toggle="dropdown" href="#">id<span class="caret"></span></a><ul class="dropdown-menu"><li class="dropdown-header">This keyword is available in sections :</li><li><a href="#id%20%28Alphabetically%20sorted%20keywords%20reference%29">Alphabetically sorted keywords reference</a></li><li><a href="#id%20%28Bind%20options%29">Bind options</a></li><li><a href="#id%20%28Server%20and%20default-server%20options%29">Server and default-server options</a></li></ul></span>&quot;.
@@ -22686,7 +22697,9 @@ <h2 id="chapter-5.2" data-target="5.2"><small><a class="small" href="#5.2">5.2.<
2268622697
HAProxy processes are balancing traffic to the same set of servers. If the
2268722698
server order of each process is different (because, for example, DNS records
2268822699
were resolved in different orders) then this will allow each independent
22689-
HAProxy processes to agree on routing decisions.
22700+
HAProxy processes to agree on routing decisions. Note: &quot;balance random&quot; also
22701+
uses &quot;hash-type consistent&quot;, and the quality of the distribution will depend
22702+
on the quality of the keys.
2269022703
</pre><a class="anchor" name="id"></a><a class="anchor" name="5-id"></a><a class="anchor" name="5.2-id"></a><a class="anchor" name="id (Bind and server options)"></a><a class="anchor" name="id (Server and default-server options)"></a><div class="keyword"><b><a class="anchor" name="id"></a><a href="#5.2-id">id</a></b> <span style="color: #080">&lt;value&gt;</span></div><pre class="text">May be used in the following contexts: tcp, http, log
2269122704

2269222705
Set a persistent ID for the server. This ID must be positive and unique for
@@ -34524,8 +34537,8 @@ <h2 id="chapter-12.8" data-target="12.8"><small><a class="small" href="#12.8">12
3452434537
<br>
3452534538
<hr>
3452634539
<div class="text-right">
34527-
HAProxy 3.4-dev3-30 &ndash; Configuration Manual<br>
34528-
<small>, 2026/01/22</small>
34540+
HAProxy 3.4-dev4-1 &ndash; Configuration Manual<br>
34541+
<small>, 2026/02/04</small>
3452934542
</div>
3453034543
</div>
3453134544
<!-- /.col-lg-12 -->

‎docs/dev/intro.html‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
<html lang="en">
33
<head>
44
<meta charset="utf-8" />
5-
<title>HAProxy version 3.4-dev3-30 - Starter Guide</title>
5+
<title>HAProxy version 3.4-dev4-1 - Starter Guide</title>
66
<link href="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" rel="stylesheet" />
77
<link href="https://raw.githubusercontent.com/thomaspark/bootswatch/v3.3.7/cerulean/bootstrap.min.css" rel="stylesheet" />
88
<link href="../css/page.css?0.4.2-15" rel="stylesheet" />
@@ -484,7 +484,7 @@
484484
You can use <strong>left</strong> and <strong>right</strong> arrow keys to navigate between chapters.<br>
485485
</p>
486486
<p class="text-right">
487-
<small>Converted with <a href="https://github.com/cbonte/haproxy-dconv">haproxy-dconv</a> v<b>0.4.2-15</b> on <b>2026/02/03</b></small>
487+
<small>Converted with <a href="https://github.com/cbonte/haproxy-dconv">haproxy-dconv</a> v<b>0.4.2-15</b> on <b>2026/02/04</b></small>
488488
</p>
489489
</div>
490490
<!-- /.sidebar -->
@@ -495,7 +495,7 @@
495495
<div class="text-center">
496496
<h1><a href="http://www.haproxy.org/" title="HAProxy"><img src="../img/HAProxyCommunityEdition_60px.png?0.4.2-15" /></a></h1>
497497
<h2>Starter Guide</h2>
498-
<p><strong>version 3.4-dev3-30</strong></p>
498+
<p><strong>version 3.4-dev4-1</strong></p>
499499
<p>
500500
<br>
501501

@@ -2515,7 +2515,7 @@ <h2 id="chapter-4.4" data-target="4.4"><small><a class="small" href="#4.4">4.4.<
25152515
<br>
25162516
<hr>
25172517
<div class="text-right">
2518-
HAProxy 3.4-dev3-30 &ndash; Starter Guide<br>
2518+
HAProxy 3.4-dev4-1 &ndash; Starter Guide<br>
25192519
<small>, </small>
25202520
</div>
25212521
</div>

‎docs/dev/management.html‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
<html lang="en">
33
<head>
44
<meta charset="utf-8" />
5-
<title>HAProxy version 3.4-dev3-30 - Management Guide</title>
5+
<title>HAProxy version 3.4-dev4-1 - Management Guide</title>
66
<link href="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" rel="stylesheet" />
77
<link href="https://raw.githubusercontent.com/thomaspark/bootswatch/v3.3.7/cerulean/bootstrap.min.css" rel="stylesheet" />
88
<link href="../css/page.css?0.4.2-15" rel="stylesheet" />
@@ -688,7 +688,7 @@
688688
You can use <strong>left</strong> and <strong>right</strong> arrow keys to navigate between chapters.<br>
689689
</p>
690690
<p class="text-right">
691-
<small>Converted with <a href="https://github.com/cbonte/haproxy-dconv">haproxy-dconv</a> v<b>0.4.2-15</b> on <b>2026/02/03</b></small>
691+
<small>Converted with <a href="https://github.com/cbonte/haproxy-dconv">haproxy-dconv</a> v<b>0.4.2-15</b> on <b>2026/02/04</b></small>
692692
</p>
693693
</div>
694694
<!-- /.sidebar -->
@@ -699,7 +699,7 @@
699699
<div class="text-center">
700700
<h1><a href="http://www.haproxy.org/" title="HAProxy"><img src="../img/HAProxyCommunityEdition_60px.png?0.4.2-15" /></a></h1>
701701
<h2>Management Guide</h2>
702-
<p><strong>version 3.4-dev3-30</strong></p>
702+
<p><strong>version 3.4-dev4-1</strong></p>
703703
<p>
704704
<br>
705705

@@ -5785,7 +5785,7 @@ <h2 id="chapter-13.1" data-target="13.1"><small><a class="small" href="#13.1">13
57855785
<br>
57865786
<hr>
57875787
<div class="text-right">
5788-
HAProxy 3.4-dev3-30 &ndash; Management Guide<br>
5788+
HAProxy 3.4-dev4-1 &ndash; Management Guide<br>
57895789
<small>, </small>
57905790
</div>
57915791
</div>

0 commit comments

Comments
 (0)