]> git.ipfire.org Git - thirdparty/haproxy.git/commit
DOC: config: mention the limitation on server id range for consistent hash
authorWilly Tarreau <w@1wt.eu>
Wed, 4 Feb 2026 09:44:30 +0000 (10:44 +0100)
committerWilly Tarreau <w@1wt.eu>
Wed, 4 Feb 2026 13:54:16 +0000 (14:54 +0100)
commit3edf6008591515db8f7d7bdc4a4906e09345e622
treee5bf50192d8ebf2afdb13f2fc32a58cea27cede5
parentcddeea58cdd141ab9855e5228b282d30500c42e7
DOC: config: mention the limitation on server id range for consistent hash

When using "hash-type consistent", we default to using the server's ID
as the insertion key. However, that key is scaled to avoid collisions
when inserting multiple slots for a server (16 per weight unit), and
that scaling loses the 4 topmost bits of the ID, so the only effective
range of IDs is 1..268435456, and anything above will provide the same
hashing keys again.

Let's mention this in the documentation, and also remind that it can
affect "balance random". This can be backported to all versions.
doc/configuration.txt