1
.TH HAPROXY 8 "17 August 2007"
5
HAProxy \- fast and reliable http reverse proxy
9
haproxy -f <configuration file> [-n maxconn] [-N maxconn] [-d] [-D] [-q] [-V] [-c] [-p <pidfile>] [-sf] [-st] [-s] [-l] [-dk] [-ds] [-de] [-dp] [-db] [-m <megs>]
13
HAProxy is a TCP/HTTP reverse proxy which is particularly suited for
14
high availability environments. Indeed, it can :
15
\- route HTTP requests depending on statically assigned cookies ;
16
\- spread the load among several servers while assuring server
17
persistence through the use of HTTP cookies ;
18
\- switch to backup servers in the event a main one fails ;
19
\- accept connections to special ports dedicated to service
21
\- stop accepting connections without breaking existing ones ;
22
\- add/modify/delete HTTP headers both ways ;
23
\- block requests matching a particular pattern ;
24
\- hold clients to the right application server depending on
26
\- report detailed status as HTML pages to authenticated users from an
27
URI intercepted from the application.
29
It needs very little resource. Its event-driven architecture allows it
30
to easily handle thousands of simultaneous connections on hundreds of
31
instances without risking the system's stability.
36
\fB-f <configuration file>\fP
37
Specify configuration file path.
41
Set the high limit for the total number of simultaneous connections.
45
Set the high limit for the per-listener number of simultaneous connections.
49
Start in foregreound with debugging mode enabled.
50
When the proxy runs in this mode, it dumps every connections,
51
disconnections, timestamps, and HTTP headers to stdout. This should
52
NEVER be used in an init script since it will prevent the system from
61
Disable messages on output.
65
Displays messages on output even when -q or 'quiet' are specified.
69
Only checks config file and exits with code 0 if no error was found, or
70
exits with code 1 if a syntax error was found.
74
Ask the process to write down each of its children's pids to this file
79
Send FINISH signal to the pids in pidlist after startup.
83
Send TERMINATE signal to the pids in pidlist after startup.
87
Show statistics (only if compiled in).
88
Statistics are only available if compiled in with the 'STATTIME' option.
89
It's only used during code optimization phases, and will soon disappear.
93
Show even more statistics (implies '-s').
97
Disable use of kqueue().
101
Disable use of speculative epoll().
105
Disable use of epoll().
109
Disables use of poll().
113
Disables background mode (stays in foreground, useful for debugging).
114
For debugging, the '-db' option is very useful as it temporarily
115
disables daemon mode and multi-process mode. The service can then be
116
stopped by simply pressing Ctrl-C, without having to edit the config nor
121
Enforce a memory usage limit to a maximum of <megs> megabytes.
125
A much better documentation can be found in haproxy-en.txt. On debian
126
systems, you can find this file in
127
/usr/share/doc/haproxy/haproxy-en.txt.gz.
131
HAProxy was written by Willy Tarreau.