From 37229df9c118a410c9e677c56d870ef5c743c202 Mon Sep 17 00:00:00 2001 From: Willy Tarreau Date: Mon, 17 Oct 2011 12:24:55 +0200 Subject: DOC: indicate that cookie "prefix" and "indirect" should not be mixed When prefix and indirect are used together, a client which connects to a server with a cookie will never get any cookie update from this server, which will be removed by the "indirect" option. --- doc/configuration.txt | 7 ++++++- 1 files changed, 6 insertions(+), 1 deletions(-) diff --git a/doc/configuration.txt b/doc/configuration.txt index 9bcc16e..653f013 100644 --- a/doc/configuration.txt +++ b/doc/configuration.txt @@ -1898,7 +1898,9 @@ cookie [ rewrite | insert | prefix ] [ indirect ] [ nocache ] requests so that the server still finds the cookie it emitted. Since all requests and responses are subject to being modified, this mode requires the HTTP close mode. The "prefix" keyword is - not compatible with "rewrite" and "insert". + not compatible with "rewrite" and "insert". Note: it is highly + recommended not to use "indirect" with "prefix", otherwise server + cookie updates would not be sent to clients. indirect When this option is specified, no cookie will be emitted to a client which already has a valid one for the server which has @@ -1907,6 +1909,9 @@ cookie [ rewrite | insert | prefix ] [ indirect ] [ nocache ] "insert" mode, this will additionally remove cookies from the requests transmitted to the server, making the persistence mechanism totally transparent from an application point of view. + Note: it is highly recommended not to use "indirect" with + "prefix", otherwise server cookie updates would not be sent to + clients. nocache This option is recommended in conjunction with the insert mode when there is a cache between the client and HAProxy, as it -- 1.7.2.3