Mercurial > hg > nginx-site

comparison xml/en/docs/http/ngx_http_upstream_module.xml @ 1418:23b409d1f5c7

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Revised usage of "individual server" in upstream_conf.
author Yaroslav Zhuravlev <yar@nginx.com>
date Mon, 16 Feb 2015 11:59:43 +0300
parents f5dcc23b214f
children b3d7cd8d7c06
comparison
equal deleted inserted replaced
1417:e7eb996b113e 1418:23b409d1f5c7
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="34"> 13 rev="35">
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
1049 Configuration commands can be used to: 1049 Configuration commands can be used to:
1050 <list type="bullet"> 1050 <list type="bullet">
1051 1051
1052 <listitem>view the group configuration;</listitem> 1052 <listitem>view the group configuration;</listitem>
1053 1053
1054 <listitem>view, modify, or remove an individual server;</listitem> 1054 <listitem>view, modify, or remove a server;</listitem>
1055 1055
1056 <listitem>add a new server.</listitem> 1056 <listitem>add a new server.</listitem>
1057 1057
1058 </list> 1058 </list>
1059 <note> 1059 <note>
1060 Since addresses in a group are not required to be unique, individual 1060 Since addresses in a group are not required to be unique, specific
1061 servers in a group are referenced by their IDs. 1061 servers in a group are referenced by their IDs.
1062 IDs are assigned automatically and shown when adding a new server 1062 IDs are assigned automatically and shown when adding a new server
1063 or viewing the group configuration. 1063 or viewing the group configuration.
1064 </note> 1064 </note>
1065 </para> 1065 </para>
1085 </tag-desc> 1085 </tag-desc>
1086 1086
1087 <tag-name> 1087 <tag-name>
1088 <literal>id=</literal><value>number</value></tag-name> 1088 <literal>id=</literal><value>number</value></tag-name>
1089 <tag-desc> 1089 <tag-desc>
1090 Selects an individual server for viewing, modifying, or removing. 1090 Selects a server for viewing, modifying, or removing.
1091 </tag-desc> 1091 </tag-desc>
1092 1092
1093 <tag-name> 1093 <tag-name>
1094 <literal>remove=</literal></tag-name> 1094 <literal>remove=</literal></tag-name>
1095 <tag-desc> 1095 <tag-desc>
1096 Removes an individual server from the group. 1096 Removes a server from the group.
1097 </tag-desc> 1097 </tag-desc>
1098 1098
1099 <tag-name> 1099 <tag-name>
1100 <literal>add=</literal></tag-name> 1100 <literal>add=</literal></tag-name>
1101 <tag-desc> 1101 <tag-desc>
1194 </tag-desc> 1194 </tag-desc>
1195 1195
1196 </list> 1196 </list>
1197 1197
1198 The first two parameters select an object. 1198 The first two parameters select an object.
1199 This can be either the whole group or an individual server. 1199 This can be either the whole group or a specific server.
1200 Without other parameters, the configuration of the selected 1200 Without other parameters, the configuration of the selected
1201 group or server is shown. 1201 group or server is shown.
1202 </para> 1202 </para>
1203 1203
1204 <para> 1204 <para>
1205 For example, to view the configuration of the whole group, send: 1205 For example, to view the configuration of the whole group, send:
1206 <example> 1206 <example>
1207 http://127.0.0.1/upstream_conf?upstream=dynamic 1207 http://127.0.0.1/upstream_conf?upstream=dynamic
1208 </example> 1208 </example>
1209 1209
1210 To view the configuration of an individual server, also specify its ID: 1210 To view the configuration of a specific server, also specify its ID:
1211 <example> 1211 <example>
1212 http://127.0.0.1/upstream_conf?upstream=dynamic&amp;id=42 1212 http://127.0.0.1/upstream_conf?upstream=dynamic&amp;id=42
1213 </example> 1213 </example>
1214 </para> 1214 </para>
1215 1215