Mercurial > hg > nginx-site

comparison xml/en/docs/http/ngx_http_upstream_module.xml @ 1122:594093ef96b1

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Upstream: documented the "queue" directive.
author Yaroslav Zhuravlev <yar@nginx.com>
date Fri, 14 Mar 2014 14:17:07 +0000
parents 15f48e365f43
children 9a9aa8e9d12c
comparison
equal deleted inserted replaced
1121:7d3d2bf39190 1122:594093ef96b1
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> 8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
9 9
10 <module name="Module ngx_http_upstream_module" 10 <module name="Module ngx_http_upstream_module"
11 link="/en/docs/http/ngx_http_upstream_module.html" 11 link="/en/docs/http/ngx_http_upstream_module.html"
12 lang="en" 12 lang="en"
13 rev="13"> 13 rev="14">
14 14
15 <section id="summary"> 15 <section id="summary">
16 16
17 <para> 17 <para>
18 The <literal>ngx_http_upstream_module</literal> module 18 The <literal>ngx_http_upstream_module</literal> module
189 <note> 189 <note>
190 This functionality is available as part of our <commercial_version/>. 190 This functionality is available as part of our <commercial_version/>.
191 </note> 191 </note>
192 </tag-desc> 192 </tag-desc>
193 193
194 <tag-name><literal>max_conns</literal>=<value>number</value></tag-name> 194 <tag-name id="max_conns">
195 <literal>max_conns</literal>=<value>number</value>
196 </tag-name>
195 <tag-desc> 197 <tag-desc>
196 limits the maximum <value>number</value> of simultaneous connections to the 198 limits the maximum <value>number</value> of simultaneous connections to the
197 proxied server (1.5.9). 199 proxied server (1.5.9).
198 Default value is zero, meaning there is no limit. 200 Default value is zero, meaning there is no limit.
199 <note> 201 <note>
844 <note> 846 <note>
845 <literal>sticky cookie</literal> <value>name</value> 847 <literal>sticky cookie</literal> <value>name</value>
846 [<literal>expires=</literal><value>time</value>] 848 [<literal>expires=</literal><value>time</value>]
847 [<literal>domain=</literal><value>domain</value>] 849 [<literal>domain=</literal><value>domain</value>]
848 [<literal>path=</literal><value>path</value>]; 850 [<literal>path=</literal><value>path</value>];
851 </note>
852 </para>
853
854 </directive>
855
856
857 <directive name="queue">
858 <syntax>
859 <value>number</value>
860 [<literal>timeout</literal>=<value>time</value>]</syntax>
861 <default/>
862 <context>upstream</context>
863 <appeared-in>1.5.12</appeared-in>
864
865 <para>
866 If an upstream server cannot be selected immediately
867 while processing a request,
868 and there are the servers in the group that have reached the
869 <link id="max_conns"/> limit,
870 the request will be placed into the queue.
871 The directive specifies the maximum number of requests that can be in the queue
872 at the same time.
873 If the queue is filled up,
874 or the server to pass the request to cannot been selected within
875 the time period specified in the <literal>timeout</literal> parameter,
876 an error will be returned to the client.
877 </para>
878
879 <para>
880 The default value of the <literal>timeout</literal> parameter is 60 seconds.
881 </para>
882
883 <para>
884 <note>
885 This directive is available as part of our <commercial_version/>.
849 </note> 886 </note>
850 </para> 887 </para>
851 888
852 </directive> 889 </directive>
853 890