Mercurial > hg > nginx-site

comparison xml/en/docs/http/ngx_http_upstream_module.xml @ 1124:d790333947f4

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Upstream: the "resolve" parameter of the "server" directive.
author Yaroslav Zhuravlev <yar@nginx.com>
date Thu, 20 Mar 2014 15:42:32 +0400
parents 9a9aa8e9d12c
children 9a95b9026a16
comparison
equal deleted inserted replaced
1123:9a9aa8e9d12c 1124:d790333947f4
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="15"> 13 rev="16">
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
213 <tag-desc> 213 <tag-desc>
214 marks the server as permanently unavailable; used along with 214 marks the server as permanently unavailable; used along with
215 the <link id="ip_hash"/> directive. 215 the <link id="ip_hash"/> directive.
216 </tag-desc> 216 </tag-desc>
217 217
218 <tag-name id="resolve">
219 <literal>resolve</literal>
220 </tag-name>
221 <tag-desc>
222 monitors changes of the IP addresses
223 that correspond to a domain name of the server,
224 and automatically modifies the upstream configuration
225 without the need of restarting nginx (1.5.12)
226 <para>
227 In order for this parameter to work,
228 the <link doc="ngx_http_core_module.xml" id="resolver"/> directive
229 must be specified in the
230 <link doc="ngx_http_core_module.xml" id="http"/> block.
231 <example>
232 http {
233 resolver 10.0.0.1;
234
235 upstream u {
236 zone ...;
237 ...
238 server example.com resolve;
239 }
240 }
241 </example>
242 </para>
243 <note>
244 This functionality is available as part of our <commercial_version/>.
245 </note>
246 </tag-desc>
247
218 <tag-name><literal>route</literal>=<value>string</value></tag-name> 248 <tag-name><literal>route</literal>=<value>string</value></tag-name>
219 <tag-desc> 249 <tag-desc>
220 sets the server route name. 250 sets the server route name.
221 <note> 251 <note>
222 This functionality is available as part of our <commercial_version/>. 252 This functionality is available as part of our <commercial_version/>.