[DOC] Restore ability to search a keyword at the beginning of a line

This commit is contained in:
Krzysztof Piotr Oledzki 2010-01-06 10:50:42 +01:00 committed by Willy Tarreau
parent 90deb18916
commit c53601c878

View File

@ -724,7 +724,7 @@ capture response header - X X -
clitimeout X X X - (deprecated) clitimeout X X X - (deprecated)
contimeout X - X X (deprecated) contimeout X - X X (deprecated)
cookie X - X X cookie X - X X
default-server X - X - default-server X - X X
default_backend - X X - default_backend - X X -
description - X X X description - X X X
disabled X X X X disabled X X X X
@ -4724,8 +4724,7 @@ address if they are used:
server <name> <address>[:port] [settings ...] server <name> <address>[:port] [settings ...]
default-server [settings ...] default-server [settings ...]
The currently supported settings are the following ones, the ones marked with The currently supported settings are the following ones.
"[D]" are also upported for default-server.
addr <ipv4> addr <ipv4>
Using the "addr" parameter, it becomes possible to use a different IP address Using the "addr" parameter, it becomes possible to use a different IP address
@ -4734,6 +4733,8 @@ addr <ipv4>
suitable to health-checks than the application. This parameter is ignored if suitable to health-checks than the application. This parameter is ignored if
the "check" parameter is not set. See also the "port" parameter. the "check" parameter is not set. See also the "port" parameter.
Supported in default-server: No
backup backup
When "backup" is present on a server line, the server is only used in load When "backup" is present on a server line, the server is only used in load
balancing when all other non-backup servers are unavailable. Requests coming balancing when all other non-backup servers are unavailable. Requests coming
@ -4742,6 +4743,8 @@ backup
the "allbackups" option is set in the backend. See also the "allbackups" the "allbackups" option is set in the backend. See also the "allbackups"
option. option.
Supported in default-server: No
check check
This option enables health checks on the server. By default, a server is This option enables health checks on the server. By default, a server is
always considered available. If "check" is set, the server will receive always considered available. If "check" is set, the server will receive
@ -4755,6 +4758,8 @@ check
and "ssl-hello-chk" options. Please refer to those options and parameters for and "ssl-hello-chk" options. Please refer to those options and parameters for
more information. more information.
Supported in default-server: No
cookie <value> cookie <value>
The "cookie" parameter sets the cookie value assigned to the server to The "cookie" parameter sets the cookie value assigned to the server to
<value>. This value will be checked in incoming requests, and the first <value>. This value will be checked in incoming requests, and the first
@ -4764,26 +4769,34 @@ cookie <value>
the same cookie value, and it is in fact somewhat common between normal and the same cookie value, and it is in fact somewhat common between normal and
backup servers. See also the "cookie" keyword in backend section. backup servers. See also the "cookie" keyword in backend section.
[D] error-limit <count> Supported in default-server: No
error-limit <count>
If health observing is enabled, the "error-limit" parameter specifies the number If health observing is enabled, the "error-limit" parameter specifies the number
of consecutive errors that triggers event selected by the "on-error" option. of consecutive errors that triggers event selected by the "on-error" option.
By default it is set to 10 consecutive errors. By default it is set to 10 consecutive errors.
See also the "check", "error-limit" and "on-error". Supported in default-server: Yes
[D] fall <count> See also the "check", "error-limit" and "on-error".
fall <count>
The "fall" parameter states that a server will be considered as dead after The "fall" parameter states that a server will be considered as dead after
<count> consecutive unsuccessful health checks. This value defaults to 3 if <count> consecutive unsuccessful health checks. This value defaults to 3 if
unspecified. See also the "check", "inter" and "rise" parameters. unspecified. See also the "check", "inter" and "rise" parameters.
Supported in default-server: Yes
id <value> id <value>
Set a persistent ID for the server. This ID must be positive and unique for Set a persistent ID for the server. This ID must be positive and unique for
the proxy. An unused ID will automatically be assigned if unset. The first the proxy. An unused ID will automatically be assigned if unset. The first
assigned value will be 1. This ID is currently only returned in statistics. assigned value will be 1. This ID is currently only returned in statistics.
[D] inter <delay> Supported in default-server: No
[D] fastinter <delay>
[D] downinter <delay> inter <delay>
fastinter <delay>
downinter <delay>
The "inter" parameter sets the interval between two consecutive health checks The "inter" parameter sets the interval between two consecutive health checks
to <delay> milliseconds. If left unspecified, the delay defaults to 2000 ms. to <delay> milliseconds. If left unspecified, the delay defaults to 2000 ms.
It is also possible to use "fastinter" and "downinter" to optimize delays It is also possible to use "fastinter" and "downinter" to optimize delays
@ -4810,7 +4823,9 @@ id <value>
keyword. This makes sense for instance when a lot of backends use the same keyword. This makes sense for instance when a lot of backends use the same
servers. servers.
[D] maxconn <maxconn> Supported in default-server: Yes
maxconn <maxconn>
The "maxconn" parameter specifies the maximal number of concurrent The "maxconn" parameter specifies the maximal number of concurrent
connections that will be sent to this server. If the number of incoming connections that will be sent to this server. If the number of incoming
concurrent requests goes higher than this value, they will be queued, waiting concurrent requests goes higher than this value, they will be queued, waiting
@ -4820,7 +4835,9 @@ id <value>
which means unlimited. See also the "minconn" and "maxqueue" parameters, and which means unlimited. See also the "minconn" and "maxqueue" parameters, and
the backend's "fullconn" keyword. the backend's "fullconn" keyword.
[D] maxqueue <maxqueue> Supported in default-server: Yes
maxqueue <maxqueue>
The "maxqueue" parameter specifies the maximal number of connections which The "maxqueue" parameter specifies the maximal number of connections which
will wait in the queue for this server. If this limit is reached, next will wait in the queue for this server. If this limit is reached, next
requests will be redispatched to other servers instead of indefinitely requests will be redispatched to other servers instead of indefinitely
@ -4829,7 +4846,9 @@ id <value>
default value is "0" which means the queue is unlimited. See also the default value is "0" which means the queue is unlimited. See also the
"maxconn" and "minconn" parameters. "maxconn" and "minconn" parameters.
[D] minconn <minconn> Supported in default-server: Yes
minconn <minconn>
When the "minconn" parameter is set, the maxconn limit becomes a dynamic When the "minconn" parameter is set, the maxconn limit becomes a dynamic
limit following the backend's load. The server will always accept at least limit following the backend's load. The server will always accept at least
<minconn> connections, never more than <maxconn>, and the limit will be on <minconn> connections, never more than <maxconn>, and the limit will be on
@ -4839,6 +4858,8 @@ id <value>
overloading the server during exceptional loads. See also the "maxconn" overloading the server during exceptional loads. See also the "maxconn"
and "maxqueue" parameters, as well as the "fullconn" backend keyword. and "maxqueue" parameters, as well as the "fullconn" backend keyword.
Supported in default-server: Yes
observe <mode> observe <mode>
This option enables health adjusting based on observing communication with This option enables health adjusting based on observing communication with
the server. By default this functionality is disabled and enabling it also the server. By default this functionality is disabled and enabling it also
@ -4848,9 +4869,11 @@ observe <mode>
received from server are verified, like valid/wrong http code, unparsable received from server are verified, like valid/wrong http code, unparsable
headers, a timeout, etc. headers, a timeout, etc.
Supported in default-server: No
See also the "check", "on-error" and "error-limit". See also the "check", "on-error" and "error-limit".
[D] on-error <mode> on-error <mode>
Select what should happen when enough consecutive errors are detected. Select what should happen when enough consecutive errors are detected.
Currently, four modes are available: Currently, four modes are available:
- fastinter: force fastinter - fastinter: force fastinter
@ -4859,9 +4882,11 @@ observe <mode>
check will mark a server down, forces fastinter check will mark a server down, forces fastinter
- mark-down: mark the server immediately down and force fastinter - mark-down: mark the server immediately down and force fastinter
Supported in default-server: Yes
See also the "check", "observe" and "error-limit". See also the "check", "observe" and "error-limit".
[D] port <port> port <port>
Using the "port" parameter, it becomes possible to use a different port to Using the "port" parameter, it becomes possible to use a different port to
send health-checks. On some servers, it may be desirable to dedicate a port send health-checks. On some servers, it may be desirable to dedicate a port
to a specific component able to perform complex tests which are more suitable to a specific component able to perform complex tests which are more suitable
@ -4869,6 +4894,8 @@ observe <mode>
inetd for instance. This parameter is ignored if the "check" parameter is not inetd for instance. This parameter is ignored if the "check" parameter is not
set. See also the "addr" parameter. set. See also the "addr" parameter.
Supported in default-server: Yes
redir <prefix> redir <prefix>
The "redir" parameter enables the redirection mode for all GET and HEAD The "redir" parameter enables the redirection mode for all GET and HEAD
requests addressing this server. This means that instead of having HAProxy requests addressing this server. This means that instead of having HAProxy
@ -4887,12 +4914,16 @@ redir <prefix>
Example : server srv1 192.168.1.1:80 redir http://image1.mydomain.com check Example : server srv1 192.168.1.1:80 redir http://image1.mydomain.com check
[D] rise <count> Supported in default-server: No
rise <count>
The "rise" parameter states that a server will be considered as operational The "rise" parameter states that a server will be considered as operational
after <count> consecutive successful health checks. This value defaults to 2 after <count> consecutive successful health checks. This value defaults to 2
if unspecified. See also the "check", "inter" and "fall" parameters. if unspecified. See also the "check", "inter" and "fall" parameters.
[D] slowstart <start_time_in_ms> Supported in default-server: Yes
slowstart <start_time_in_ms>
The "slowstart" parameter for a server accepts a value in milliseconds which The "slowstart" parameter for a server accepts a value in milliseconds which
indicates after how long a server which has just come back up will run at indicates after how long a server which has just come back up will run at
full speed. Just as with every other time-based parameter, it can be entered full speed. Just as with every other time-based parameter, it can be entered
@ -4912,6 +4943,8 @@ redir <prefix>
trouble to running servers. It only applies when a server has been previously trouble to running servers. It only applies when a server has been previously
seen as failed. seen as failed.
Supported in default-server: Yes
source <addr>[:<pl>[-<ph>]] [usesrc { <addr2>[:<port2>] | client | clientip } ] source <addr>[:<pl>[-<ph>]] [usesrc { <addr2>[:<port2>] | client | clientip } ]
source <addr>[:<pl>[-<ph>]] [interface <name>] ... source <addr>[:<pl>[-<ph>]] [interface <name>] ...
The "source" parameter sets the source address which will be used when The "source" parameter sets the source address which will be used when
@ -4927,6 +4960,8 @@ source <addr>[:<pl>[-<ph>]] [interface <name>] ...
total concurrent connections. The limit will then reach 64k connections per total concurrent connections. The limit will then reach 64k connections per
server. server.
Supported in default-server: No
track [<proxy>/]<server> track [<proxy>/]<server>
This option enables ability to set the current state of the server by This option enables ability to set the current state of the server by
tracking another one. Only a server with checks enabled can be tracked tracking another one. Only a server with checks enabled can be tracked
@ -4934,7 +4969,9 @@ track [<proxy>/]<server>
one. If <proxy> is omitted the current one is used. If disable-on-404 is one. If <proxy> is omitted the current one is used. If disable-on-404 is
used, it has to be enabled on both proxies. used, it has to be enabled on both proxies.
[D] weight <weight> Supported in default-server: No
weight <weight>
The "weight" parameter is used to adjust the server's weight relative to The "weight" parameter is used to adjust the server's weight relative to
other servers. All servers will receive a load proportional to their weight other servers. All servers will receive a load proportional to their weight
relative to the sum of all weights, so the higher the weight, the higher the relative to the sum of all weights, so the higher the weight, the higher the
@ -4945,6 +4982,8 @@ track [<proxy>/]<server>
can both grow and shrink, for instance between 10 and 100 to leave enough can both grow and shrink, for instance between 10 and 100 to leave enough
room above and below for later adjustments. room above and below for later adjustments.
Supported in default-server: Yes
6. HTTP header manipulation 6. HTTP header manipulation
--------------------------- ---------------------------