~ubuntu-branches/ubuntu/vivid/haproxy/vivid

« back to all changes in this revision

Viewing changes to doc/haproxy-en.txt

  • Committer: Package Import Robot
  • Author(s): Apollon Oikonomopoulos
  • Date: 2014-06-20 11:05:17 UTC
  • mfrom: (1.1.15) (15.1.12 experimental)
  • Revision ID: package-import@ubuntu.com-20140620110517-u6q5p9kyy2f3ozw9
Tags: 1.5.0-1
* New upstream stable series. Notable changes since the 1.4 series:
  + Native SSL support on both sides with SNI/NPN/ALPN and OCSP stapling.
  + IPv6 and UNIX sockets are supported everywhere
  + End-to-end HTTP keep-alive for better support of NTLM and improved
    efficiency in static farms
  + HTTP/1.1 response compression (deflate, gzip) to save bandwidth
  + PROXY protocol versions 1 and 2 on both sides
  + Data sampling on everything in request or response, including payload
  + ACLs can use any matching method with any input sample
  + Maps and dynamic ACLs updatable from the CLI
  + Stick-tables support counters to track activity on any input sample
  + Custom format for logs, unique-id, header rewriting, and redirects
  + Improved health checks (SSL, scripted TCP, check agent, ...)
  + Much more scalable configuration supports hundreds of thousands of
    backends and certificates without sweating

* Upload to unstable, merge all 1.5 work from experimental. Most important
  packaging changes since 1.4.25-1 include:
  + systemd support.
  + A more sane default config file.
  + Zero-downtime upgrades between 1.5 releases by gracefully reloading
    HAProxy during upgrades.
  + HTML documentation shipped in the haproxy-doc package.
  + kqueue support for kfreebsd.

* Packaging changes since 1.5~dev26-2:
  + Drop patches merged upstream:
    o Fix-reference-location-in-manpage.patch
    o 0001-BUILD-stats-workaround-stupid-and-bogus-Werror-forma.patch
  + d/watch: look for stable 1.5 releases
  + systemd: respect CONFIG and EXTRAOPTS when specified in
    /etc/default/haproxy.
  + initscript: test the configuration before start or reload.
  + initscript: remove the ENABLED flag and logic.

Show diffs side-by-side

added added

removed removed

Lines of Context:
51
51
       = 'maxconn' in 'listen' or 'default' sections
52
52
    -d starts in foregreound with debugging mode enabled
53
53
    -D starts in daemon mode
 
54
    -Ds starts in systemd daemon mode
54
55
    -q disable messages on output
55
56
    -V displays messages on output even when -q or 'quiet' are specified.
56
57
    -c only checks config file and exits with code 0 if no error was found, or
62
63
    -s shows statistics (only if compiled in)
63
64
    -l shows even more statistics (implies '-s')
64
65
    -dk disables use of kqueue()
65
 
    -ds disables use of speculative epoll()
66
66
    -de disables use of epoll()
67
67
    -dp disables use of poll()
68
68
    -db disables background mode (stays in foreground, useful for debugging)
130
130
  - daemon
131
131
  - debug
132
132
  - nokqueue
133
 
  - nosepoll
134
133
  - noepoll
135
134
  - nopoll
136
135
  - quiet
357
356
Haproxy will use kqueue() or speculative epoll() when available, then epoll(),
358
357
and will fall back to poll(), then to select(). However, if for any reason you
359
358
need to disable epoll() or poll() (eg. because of a bug or just to compare
360
 
performance), new global options have been created for this matter : 'nosepoll',
361
 
'nokqueue', 'noepoll' and 'nopoll'.
 
359
performance), new global options have been created for this matter : 'nopoll',
 
360
'nokqueue', and 'noepoll'.
362
361
 
363
362
Example :
364
363
---------
378
377
To make debugging easier, the '-de' runtime argument disables epoll support,
379
378
the '-dp' argument disables poll support, '-dk' disables kqueue and '-ds'
380
379
disables speculative epoll(). They are respectively equivalent to 'noepoll',
381
 
'nopoll', 'nokqueue' and 'nosepoll'.
 
380
'nopoll', and 'nokqueue'.
382
381
 
383
382
 
384
383
2) Declaration of a listening service
408
407
  descriptors with a simple range. The <addr:port> couple must be used only once
409
408
  among all instances running on a same system. Please note that attaching to
410
409
  ports lower than 1024 need particular priviledges to start the program, which
411
 
  are independant of the 'uid' parameter.
 
410
  are independent of the 'uid' parameter.
412
411
 
413
412
- the <IP_address>:<port_range> couple may be repeated indefinitely to require
414
413
  the proxy to listen to other addresses and/or ports. To achieve this, simply
630
629
2.5) Connections expiration time
631
630
--------------------------------
632
631
It is possible (and recommended) to configure several time-outs on TCP
633
 
connections. Three independant timers are adjustable with values specified
 
632
connections. Three independent timers are adjustable with values specified
634
633
in milliseconds. A session will be terminated if either one of these timers
635
634
expire.
636
635