Mercurial > hg > nginx-site

comparison xml/en/docs/http/ngx_http_upstream_module.xml @ 1367:f1e14d87d833

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Updated commercial docs for the upcoming release.
author Ruslan Ermilov <ru@nginx.com>
date Mon, 01 Dec 2014 13:40:25 +0300
parents 5e45198fa991
children f08ae1f79000
comparison
equal deleted inserted replaced
1366:f3b7ec81b738 1367:f1e14d87d833
318 <context>upstream</context> 318 <context>upstream</context>
319 <appeared-in>1.7.2</appeared-in> 319 <appeared-in>1.7.2</appeared-in>
320 320
321 <para> 321 <para>
322 Specifies a load balancing method for a server group 322 Specifies a load balancing method for a server group
323 where client-server mapping is based on the hashed <value>key</value> value. 323 where the client-server mapping is based on the hashed <value>key</value> value.
324 The <value>key</value> can contain text, variables, and their combinations. 324 The <value>key</value> can contain text, variables, and their combinations.
325 Note that adding or removing a server from the group 325 Note that adding or removing a server from the group
326 may result in remapping most of the keys to different servers. 326 may result in remapping most of the keys to different servers.
327 The method is compatible with the 327 The method is compatible with the
328 <link url="http://search.cpan.org/perldoc?Cache%3A%3AMemcached">Cache::Memcached</link> 328 <link url="http://search.cpan.org/perldoc?Cache%3A%3AMemcached">Cache::Memcached</link>
329 Perl library. 329 Perl library.
330 </para> 330 </para>
331 331
332 <para> 332 <para>
333 The <literal>consistent</literal> parameter specifies that 333 If the <literal>consistent</literal> parameter is specified
334 the <link url="http://www.last.fm/user/RJ/journal/2007/04/10/392555/">ketama</link> 334 the <link url="http://www.last.fm/user/RJ/journal/2007/04/10/392555/">ketama</link>
335 consistent hashing method should be used instead. 335 consistent hashing method will be used instead.
336 The method ensures that only a few keys 336 The method ensures that only a few keys
337 will be remapped to different servers 337 will be remapped to different servers
338 when a server is added to or removed from the group. 338 when a server is added to or removed from the group.
339 This helps to achieve a higher cache hit ratio for caching servers. 339 This helps to achieve a higher cache hit ratio for caching servers.
340 The method is compatible with the 340 The method is compatible with the
1164 <tag-desc> 1164 <tag-desc>
1165 Same as the “<literal>down</literal>” parameter 1165 Same as the “<literal>down</literal>” parameter
1166 of the <link id="server"/> directive. 1166 of the <link id="server"/> directive.
1167 </tag-desc> 1167 </tag-desc>
1168 1168
1169 <tag-name id="drain"><literal>drain=</literal></tag-name>
1170 <tag-desc>
1171 Puts the upstream server in the “draining” mode (1.7.5).
1172 In this mode, only requests <link id="sticky">bound</link> to the server
1173 will be proxied to it.
1174 </tag-desc>
1175
1169 <tag-name> 1176 <tag-name>
1170 <literal>up=</literal></tag-name> 1177 <literal>up=</literal></tag-name>
1171 <tag-desc> 1178 <tag-desc>
1172 The opposite of the “<literal>down</literal>” parameter 1179 The opposite of the “<literal>down</literal>” parameter
1173 of the <link id="server"/> directive. 1180 of the <link id="server"/> directive.