diff xml/en/docs/http/ngx_http_upstream_module.xml @ 1126:2e28d1c4a0a2

Upstream: revised layout of the "server" directive.
author Ruslan Ermilov <ru@nginx.com>
date Fri, 21 Mar 2014 10:55:50 +0400
parents 9a95b9026a16
children 948c853f5d22
line wrap: on
line diff
--- a/xml/en/docs/http/ngx_http_upstream_module.xml
+++ b/xml/en/docs/http/ngx_http_upstream_module.xml
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_upstream_module"
         link="/en/docs/http/ngx_http_upstream_module.html"
         lang="en"
-        rev="17">
+        rev="18">
 
 <section id="summary">
 
@@ -100,6 +100,8 @@ upstream backend {
     server backend1.example.com weight=5;
     server 127.0.0.1:8080       max_fails=3 fail_timeout=30s;
     server unix:/tmp/backend3;
+
+    server backup1.example.com  backup;
 }
 </example>
 </para>
@@ -178,31 +180,6 @@ and the period of time the server will b
 By default, the parameter is set to 10 seconds.
 </tag-desc>
 
-<tag-name><literal>slow_start</literal>=<value>time</value></tag-name>
-<tag-desc>
-sets the <value>time</value> during which the server will recover its weight
-from zero to a nominal value, when unhealthy server becomes
-<link id="health_check">healthy</link>,
-or when the server becomes available after a period of time
-it was considered unavailable.
-Default value is zero, i.e. slow start is disabled.
-<note>
-This functionality is available as part of our <commercial_version/>.
-</note>
-</tag-desc>
-
-<tag-name id="max_conns">
-<literal>max_conns</literal>=<value>number</value>
-</tag-name>
-<tag-desc>
-limits the maximum <value>number</value> of simultaneous connections to the
-proxied server (1.5.9).
-Default value is zero, meaning there is no limit.
-<note>
-This functionality is available as part of our <commercial_version/> only.
-</note>
-</tag-desc>
-
 <tag-name><literal>backup</literal></tag-name>
 <tag-desc>
 marks the server as a backup server.
@@ -215,6 +192,23 @@ marks the server as permanently unavaila
 the <link id="ip_hash"/> directive.
 </tag-desc>
 
+</list>
+</para>
+
+<para>
+Additionally,
+the following parameters are available as part of our <commercial_version/>:
+<list type="tag">
+
+<tag-name id="max_conns">
+<literal>max_conns</literal>=<value>number</value>
+</tag-name>
+<tag-desc>
+limits the maximum <value>number</value> of simultaneous connections to the
+proxied server (1.5.9).
+Default value is zero, meaning there is no limit.
+</tag-desc>
+
 <tag-name id="resolve">
 <literal>resolve</literal>
 </tag-name>
@@ -240,34 +234,27 @@ http {
 }
 </example>
 </para>
-<note>
-This functionality is available as part of our <commercial_version/>.
-</note>
 </tag-desc>
 
 <tag-name><literal>route</literal>=<value>string</value></tag-name>
 <tag-desc>
 sets the server route name.
-<note>
-This functionality is available as part of our <commercial_version/>.
-</note>
+</tag-desc>
+
+<tag-name><literal>slow_start</literal>=<value>time</value></tag-name>
+<tag-desc>
+sets the <value>time</value> during which the server will recover its weight
+from zero to a nominal value, when unhealthy server becomes
+<link id="health_check">healthy</link>,
+or when the server becomes available after a period of time
+it was considered unavailable.
+Default value is zero, i.e. slow start is disabled.
 </tag-desc>
 
 </list>
 </para>
 
 <para>
-Example:
-<example>
-upstream backend {
-    server backend1.example.com     weight=5;
-    server 127.0.0.1:8080           max_fails=3 fail_timeout=30s;
-    server unix:/tmp/backend3;
-
-    server backup1.example.com:8080 backup;
-}
-</example>
-
 <note>
 If there is only a single server in a group, <literal>max_fails</literal>,
 <literal>fail_timeout</literal> and <literal>slow_start</literal> parameters