You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@trafficserver.apache.org by bu...@apache.org on 2012/06/19 04:27:30 UTC
svn commit: r822313 - in /websites/staging/trafficserver/trunk/content: ./
docs/trunk/admin/configuration-files/records.config.en.html
docs/trunk/admin/en-tree.nav
Author: buildbot
Date: Tue Jun 19 02:27:29 2012
New Revision: 822313
Log:
Staging update by buildbot for tserver
Modified:
websites/staging/trafficserver/trunk/content/ (props changed)
websites/staging/trafficserver/trunk/content/docs/trunk/admin/configuration-files/records.config.en.html
websites/staging/trafficserver/trunk/content/docs/trunk/admin/en-tree.nav
Propchange: websites/staging/trafficserver/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Tue Jun 19 02:27:29 2012
@@ -1 +1 @@
-1351023
+1351558
Modified: websites/staging/trafficserver/trunk/content/docs/trunk/admin/configuration-files/records.config.en.html
==============================================================================
--- websites/staging/trafficserver/trunk/content/docs/trunk/admin/configuration-files/records.config.en.html (original)
+++ websites/staging/trafficserver/trunk/content/docs/trunk/admin/configuration-files/records.config.en.html Tue Jun 19 02:27:29 2012
@@ -193,16 +193,36 @@ the <code>records.config</code> file.</p
<dl>
<dt id="proxy.local.incoming_ip_to_bind"><em><code>proxy.local.incoming_ip_to_bind</code></em></dt>
<dd><code>STRING</code></dd>
-<dd>Default:</dd>
+<dd>Default: ANY address (0.0.0.0 and ::)</dd>
<dd>
-<p>This variable can be used to bind to a specific IPs in a multi-interface setup. Multiple occurances of this variable mean multiple binds to <em>different</em> IPs.</p>
-<div class="codehilite"><pre><span class="n">LOCAL</span> <span class="n">proxy</span><span class="o">.</span><span class="nb">local</span><span class="o">.</span><span class="n">incoming_ip_to_bind</span> <span class="n">STRING</span> <span class="mf">192.168.101.17</span>
-<span class="n">LOCAL</span> <span class="n">proxy</span><span class="o">.</span><span class="nb">local</span><span class="o">.</span><span class="n">incoming_ip_to_bind</span> <span class="n">STRING</span> <span class="mf">192.168.101.18</span>
+<p>This variable can be used to bind to a specific IP addresses in a multi-interface setup. It sets a global default which is used for all ports unless specifically overridden in a port configuration descriptor. To specify addresses for both IPv4 and IPv6 list both addresses in this value. The defaults for the IP addresses families are handled independently.</p>
+<p>Specify the IPv4 address to use for the local address of client (listening) connections.</p>
+<div class="codehilite"><pre><span class="n">LOCAL</span> <span class="n">proxy</span><span class="o">.</span><span class="nb">local</span><span class="o">.</span><span class="n">incoming_ip_to_bind</span> <span class="n">STRING</span> <span class="mf">192.168.101.18</span>
</pre></div>
-<p>In order to bind to both, the IPv4 and and IPv6 sockets, use the following setup:</p>
-<div class="codehilite"><pre><span class="n">LOCAL</span> <span class="n">proxy</span><span class="o">.</span><span class="nb">local</span><span class="o">.</span><span class="n">incoming_ip_to_bind</span> <span class="n">STRING</span> <span class="mf">192.168.101.18</span> <span class="n">fc07:192:168:101::18</span>
+<p>Specify the IPv4 and IPv6 addresses to use for the local address of client (listening) connections.</p>
+<div class="codehilite"><pre>
+</pre></div>
+
+
+</dd>
+<dt id="proxy.local.outgoing_ip_to_bind"><em><code>proxy.local.outgoing_ip_to_bind</code></em></dt>
+<dd>
+<p><code>STRING</code></p>
+</dd>
+<dd>
+<p>Default: ANY address (0.0.0.0 and ::)</p>
+</dd>
+<dd>
+<p>This sets the default IP address used for the local address when connecting to an origin server. It is used unless specifically overridden in a port configuration descriptor. To specify addresses for both IPv4 and IPv6 list both addresses in this value. The defaults for the IP addresses families are handled independently.</p>
+<p>Specify the IPv4 address to use for the local address of origin server connections.</p>
+<div class="codehilite"><pre><span class="n">LOCAL</span> <span class="n">proxy</span><span class="o">.</span><span class="nb">local</span><span class="o">.</span><span class="n">outgoing_ip_to_bind</span> <span class="n">STRING</span> <span class="mf">192.168.101.18</span>
+</pre></div>
+
+
+<p>Specify the IPv4 and IPv6 addresses to use for the local address of origin server connections.</p>
+<div class="codehilite"><pre>
</pre></div>
@@ -286,13 +306,58 @@ the <code>records.config</code> file.</p
</dl>
<h1 id="HTTPEngine">HTTP Engine</h1>
<dl>
-<dt id="proxy.config.http.server_port"><em><code>proxy.config.http.server_port</code></em></dt>
-<dd><code>INT</code></dd>
+<dt id="proxy.config.http.server_ports"><em><code>proxy.config.http.server_ports</code></em></dt>
+<dd><code>STRING</code></dd>
<dd>Default: <code>8080</code></dd>
-<dd>The port that Traffic Server uses when acting as a web proxy server for web traffic.</dd>
+<dd>
+<p>Ports used for proxying HTTP traffic. This is a list, separated by space or comma, of port descriptors. Each descriptor is a sequence of keywords and values separated by colons. Not all keywords have values, those that do are specifically noted. Keywords with values can have an optional '=' character separating the keyword and value.</p>
+<p><table><tr><td><strong>Keyword</strong></td><td><strong>Meaning</strong></td></tr>
+<tr><td><em>number</em></td><td>IP port. Required.</td></tr>
+<tr><td>ipv6</td><td>Use IPv6.</td></tr>
+<tr><td>ipv4</td><td>Use IPv4. Default.</td></tr>
+<tr><td>tr-in</td><td>Use inbound transparency (to client).</td></tr>
+<tr><td>tr-out</td><td>Use outbound transparency (to server).</td></tr>
+<tr><td>tr-full</td><td>Full transparency, both inbound and outbound.</td></tr>
+<tr><td>ssl</td><td>Use SSL termination.</td></tr>
+<tr><td>blind</td><td>Use as a blind tunnel (for <code>CONNECT</code>).</td></tr>
+<tr><td>ip-in</td><td>Use the keyword value as the local inbound (listening) address. This will also set the address family if not explicitly specified. If the IP address family is specified by <code>ipv4</code> or <code>ipv6</code> it must agree with this address.</td></tr>
+<tr><td>ip-out</td><td>Use the value as the local address when connecting to a server. This may be specified twice, once for IPv4 and once for IPv6. The actual address used will be determined by the family of the origin server address.</td></tr>
+</table></p>
+<p>Examples -</p>
+<p><tt>
+80 80:ipv6
+</tt></p>
+<p>Listen on port 80 on any address for IPv4 and IPv6.</p>
+<p><tt>
+8080:ipv6:tr-full 443:ssl 80:ip-in=192.168.17.1:ip-out=[fc01:10:10:1::1]:ip-out=10.10.10.1
+</tt></p>
+<p>Listen on port 8080 any address for IPv6, fully transparent. Set up an SSL port on 443. Listen on IP address 192.168.17.1, port 80, IPv4, and connect to origin servers using the local address 10.10.10.1 for IPv4 and fc01:10:10:1::1 for IPv6.</p>
+<p>Note: For SSL you must still configure the certificates, this option handles only the port configuration.</p>
+<p>Note: old style configuration of ports should still work but support for that will be removed at some point in the future.</p>
+</dd>
+<dt id="proxy.config.http.server_port"><em><code>proxy.config.http.server_port</code></em></dt>
+<dd>
+<p><code>INT</code></p>
+</dd>
+<dd>
+<p>Default: <code>8080</code></p>
+</dd>
+<dd>
+<p>DEPRECATED: 3.2</p>
+</dd>
+<dd>
+<p>The port that Traffic Server uses when acting as a web proxy server for web traffic.</p>
+</dd>
<dt id="proxy.config.http.server_port_attr"><em><code>proxy.config.http.server_port_attr</code></em></dt>
-<dd><code>STRING</code></dd>
-<dd>Default: <code>X</code></dd>
+<dd>
+<p><code>STRING</code></p>
+</dd>
+<dd>
+<p>Default: <code>X</code></p>
+</dd>
+<dd>
+<p>DEPRECATED: 3.2</p>
+</dd>
<dd>
<p>The server port options. You can specify one of the following:</p>
<ul>
@@ -309,6 +374,9 @@ the <code>records.config</code> file.</p
<p>Default: <code>NULL</code></p>
</dd>
<dd>
+<p>DEPRECATED: 3.2</p>
+</dd>
+<dd>
<p>The ports other than the port specified by the variable <em><code>proxy.config.http.server_port</code></em> to bind for incoming HTTP requests. Example:
CONFIG proxy.config.http.server_other_ports STRING 6060:X 9090:X
would listed to ports <code>6060</code>, <code>9090</code>, and the port specified by <em><code>proxy.config.http.server_port</code></em>.</p>
@@ -321,6 +389,9 @@ would listed to ports <code>6060</code>,
<p>Default: <code>443 563</code></p>
</dd>
<dd>
+<p>DEPRECATED: 3.2</p>
+</dd>
+<dd>
<p>The range of ports used for tunneling. Traffic Server allows tunnels only to the specified ports. For example: to retrieve an object using HTTPS via Traffic Server, a tunnel must be established to an origin server via Traffic Server.</p>
</dd>
<dt id="proxy.config.http.insert_request_via_str"><em><code>proxy.config.http.insert_request_via_str</code></em></dt>
Modified: websites/staging/trafficserver/trunk/content/docs/trunk/admin/en-tree.nav
==============================================================================
--- websites/staging/trafficserver/trunk/content/docs/trunk/admin/en-tree.nav (original)
+++ websites/staging/trafficserver/trunk/content/docs/trunk/admin/en-tree.nav Tue Jun 19 02:27:29 2012
@@ -1 +1 @@
-<ul><li><a href="/docs/trunk/admin/index.en.html" >Administrators's Guide - Overview</a><ul><li><a href="/docs/trunk/admin/getting-started/index.en.html" >Gettting Started</a></li><li><a href="/docs/trunk/admin/http-proxy-caching/index.en.html" >HTTP Proxy Caching</a></li><li><a href="/docs/trunk/admin/reverse-proxy-http-redirects/index.en.html" >Reverse Proxy and HTTP Redirects</a></li><li><a href="/docs/trunk/admin/forward-proxy/index.en.html" >Forward Proxy</a></li><li><a href="/docs/trunk/admin/transparent-proxy/index.en.html" >Transparent Proxying</a><ul><li><a href="/docs/trunk/admin/transparent-proxy/build.en.html" >Building ATS for transparency</a></li><li><a href="/docs/trunk/admin/transparent-proxy/bridge.en.html" >Inline on a Linux Bridge</a></li><li><a href="/docs/trunk/admin/transparent-proxy/router-inline.en.html" >Inline on a Linux router</a></li><li><a href="/docs/trunk/admin/transparent-proxy/wccp-configuration.en.html" >WCCP Configuration</a></li></ul></li>
<li><a href="/docs/trunk/admin/explicit-proxy-caching/index.en.html" >Explicit Proxy Caching</a></li><li><a href="/docs/trunk/admin/hierachical-caching/index.en.html" >Hierarchical Caching</a></li><li><a href="/docs/trunk/admin/configuring-cache/index.en.html" >Configuring the cache</a></li><li><a href="/docs/trunk/admin/monitoring-traffic/index.en.html" >Monitoring Traffic</a></li><li><a href="/docs/trunk/admin/configuring-traffic-server/index.en.html" >Configuring Traffic Server</a></li><li><a href="/docs/trunk/admin/cluster-howto/index.en.html" >Traffic Server Cluster</a></li><li><a href="/docs/trunk/admin/security-options/index.en.html" >Security Options</a></li><li><a href="/docs/trunk/admin/working-log-files/index.en.html" >Working with Log Files</a><ul><li><a href="/docs/trunk/admin/working-log-files/netscape-common-format.en.html" >Netscape Common</a></li><li><a href="/docs/trunk/admin/working-log-files/netscape-extended2-format.en.html" >Netscape Extended-2</a></li>
<li><a href="/docs/trunk/admin/working-log-files/netscape-extended-format.en.html" >Netscape Extended</a></li><li><a href="/docs/trunk/admin/working-log-files/squid-format.en.html" >Squid Format</a></li></ul></li><li><a href="/docs/trunk/admin/event-logging-formats/index.en.html" >Event Logging Formats</a></li><li><a href="/docs/trunk/admin/configuration-files/index.en.html" >Configuration Files</a><ul><li><a href="/docs/trunk/admin/configuration-files/bypass.config.en.html" >bypass.config</a></li><li><a href="/docs/trunk/admin/configuration-files/cache.config.en.html" >cache.config</a></li><li><a href="/docs/trunk/admin/configuration-files/congestion.config.en.html" >congestion.config</a></li><li><a href="/docs/trunk/admin/configuration-files/hosting.config.en.html" >hosting.config</a></li><li><a href="/docs/trunk/admin/configuration-files/icp.config.en.html" >icp.config</a></li><li><a href="/docs/trunk/admin/configuration-files/ip_allow.config.en.html" >ip_allow.config</a>
</li><li><a href="/docs/trunk/admin/configuration-files/log_hosts.config.en.html" >log_hosts.config</a></li><li><a href="/docs/trunk/admin/configuration-files/logs_xml.config.en.html" >logs_xml.config</a></li><li><a href="/docs/trunk/admin/configuration-files/parent.config.en.html" >parent.config</a></li><li><a href="/docs/trunk/admin/configuration-files/volume.config.en.html" >volume.config</a></li><li><a href="/docs/trunk/admin/configuration-files/records.config.en.html" >records.config</a></li><li><a href="/docs/trunk/admin/configuration-files/remap.config.en.html" >remap.config</a></li><li><a href="/docs/trunk/admin/configuration-files/splitdns.config.en.html" >splitdns.config</a></li><li><a href="/docs/trunk/admin/configuration-files/ssl_multicert.config.en.html" >ssl_multicert.config</a></li><li><a href="/docs/trunk/admin/configuration-files/storage.config.en.html" >storage.config</a></li><li><a href="/docs/trunk/admin/configuration-files/update.config.en.html" >update
.config</a></li></ul></li><li><a href="/docs/trunk/admin/traffic-line-commands/index.en.html" >Traffic Line Commands</a></li><li><a href="/docs/trunk/admin/traffic-server-error-messages/index.en.html" >Error Messages</a></li><li><a href="/docs/trunk/admin/faqs/index.en.html" >FAQ and Troubleshooting Tips</a></li><li><a href="/docs/trunk/admin/plugins/index.en.html" >Plugins</a><ul><li><a href="/docs/trunk/admin/plugins/balancer/index.en.html" >Balancer</a></li><li><a href="/docs/trunk/admin/plugins/buffer_upload/index.en.html" >Buffer Upload</a></li><li><a href="/docs/trunk/admin/plugins/cacheurl/index.en.html" >CacheURL</a></li><li><a href="/docs/trunk/admin/plugins/combo_handler/index.en.html" >Combohandler</a></li><li><a href="/docs/trunk/admin/plugins/esi/index.en.html" >ESI</a></li><li><a href="/docs/trunk/admin/plugins/geoip_acl/index.en.html" >GeoIP ACLs</a></li><li><a href="/docs/trunk/admin/plugins/header_filter/index.en.html" >Header Filter</a></li><li><a href="/do
cs/trunk/admin/plugins/hipes/index.en.html" >HIPES system</a></li><li><a href="/docs/trunk/admin/plugins/mysql_remap/index.en.html" >MySQL Remap</a></li><li><a href="/docs/trunk/admin/plugins/regex_remap/index.en.html" >Regex Remap</a></li><li><a href="/docs/trunk/admin/plugins/stale_while_revalidate/index.en.html" >Stale While Revalidate</a></li><li><a href="/docs/trunk/admin/plugins/stats_over_http/index.en.html" >Stats over HTTP</a></li><li><a href="/docs/trunk/admin/plugins/gzip/index.en.html" >gzip / deflate plugin</a></li></ul></li></ul></li></ul>
\ No newline at end of file
+<ul><li><a href="/docs/trunk/admin/index.en.html" >Administrators's Guide - Overview</a><ul><li><a href="/docs/trunk/admin/getting-started/index.en.html" >Gettting Started</a></li><li><a href="/docs/trunk/admin/http-proxy-caching/index.en.html" >HTTP Proxy Caching</a></li><li><a href="/docs/trunk/admin/reverse-proxy-http-redirects/index.en.html" >Reverse Proxy and HTTP Redirects</a></li><li><a href="/docs/trunk/admin/forward-proxy/index.en.html" >Forward Proxy</a></li><li><a href="/docs/trunk/admin/transparent-proxy/index.en.html" >Transparent Proxying</a><ul><li><a href="/docs/trunk/admin/transparent-proxy/build.en.html" >Building ATS for transparency</a></li><li><a href="/docs/trunk/admin/transparent-proxy/bridge.en.html" >Inline on a Linux Bridge</a></li><li><a href="/docs/trunk/admin/transparent-proxy/router-inline.en.html" >Inline on a Linux router</a></li><li><a href="/docs/trunk/admin/transparent-proxy/wccp-configuration.en.html" >WCCP Configuration</a></li></ul></li>
<li><a href="/docs/trunk/admin/explicit-proxy-caching/index.en.html" >Explicit Proxy Caching</a></li><li><a href="/docs/trunk/admin/hierachical-caching/index.en.html" >Hierarchical Caching</a></li><li><a href="/docs/trunk/admin/configuring-cache/index.en.html" >Configuring the cache</a></li><li><a href="/docs/trunk/admin/monitoring-traffic/index.en.html" >Monitoring Traffic</a></li><li><a href="/docs/trunk/admin/configuring-traffic-server/index.en.html" >Configuring Traffic Server</a></li><li><a href="/docs/trunk/admin/cluster-howto/index.en.html" >Traffic Server Cluster</a></li><li><a href="/docs/trunk/admin/security-options/index.en.html" >Security Options</a></li><li><a href="/docs/trunk/admin/working-log-files/index.en.html" >Working with Log Files</a><ul><li><a href="/docs/trunk/admin/working-log-files/netscape-common-format.en.html" >Netscape Common</a></li><li><a href="/docs/trunk/admin/working-log-files/netscape-extended2-format.en.html" >Netscape Extended-2</a></li>
<li><a href="/docs/trunk/admin/working-log-files/netscape-extended-format.en.html" >Netscape Extended</a></li><li><a href="/docs/trunk/admin/working-log-files/squid-format.en.html" >Squid Format</a></li></ul></li><li><a href="/docs/trunk/admin/event-logging-formats/index.en.html" >Event Logging Formats</a></li><li><a href="/docs/trunk/admin/configuration-files/index.en.html" >Configuration Files</a><ul><li><a href="/docs/trunk/admin/configuration-files/bypass.config.en.html" >bypass.config</a></li><li><a href="/docs/trunk/admin/configuration-files/cache.config.en.html" >cache.config</a></li><li><a href="/docs/trunk/admin/configuration-files/congestion.config.en.html" >congestion.config</a></li><li><a href="/docs/trunk/admin/configuration-files/hosting.config.en.html" >hosting.config</a></li><li><a href="/docs/trunk/admin/configuration-files/icp.config.en.html" >icp.config</a></li><li><a href="/docs/trunk/admin/configuration-files/ip_allow.config.en.html" >ip_allow.config</a>
</li><li><a href="/docs/trunk/admin/configuration-files/log_hosts.config.en.html" >log_hosts.config</a></li><li><a href="/docs/trunk/admin/configuration-files/logs_xml.config.en.html" >logs_xml.config</a></li><li><a href="/docs/trunk/admin/configuration-files/parent.config.en.html" >parent.config</a></li><li><a href="/docs/trunk/admin/configuration-files/plugin.config.en.html" >plugin.config</a></li><li><a href="/docs/trunk/admin/configuration-files/volume.config.en.html" >volume.config</a></li><li><a href="/docs/trunk/admin/configuration-files/records.config.en.html" >records.config</a></li><li><a href="/docs/trunk/admin/configuration-files/remap.config.en.html" >remap.config</a></li><li><a href="/docs/trunk/admin/configuration-files/splitdns.config.en.html" >splitdns.config</a></li><li><a href="/docs/trunk/admin/configuration-files/ssl_multicert.config.en.html" >ssl_multicert.config</a></li><li><a href="/docs/trunk/admin/configuration-files/storage.config.en.html" >storage
.config</a></li><li><a href="/docs/trunk/admin/configuration-files/update.config.en.html" >update.config</a></li></ul></li><li><a href="/docs/trunk/admin/traffic-line-commands/index.en.html" >Traffic Line Commands</a></li><li><a href="/docs/trunk/admin/traffic-server-error-messages/index.en.html" >Error Messages</a></li><li><a href="/docs/trunk/admin/faqs/index.en.html" >FAQ and Troubleshooting Tips</a></li><li><a href="/docs/trunk/admin/plugins/index.en.html" >Plugins</a><ul><li><a href="/docs/trunk/admin/plugins/balancer/index.en.html" >Balancer</a></li><li><a href="/docs/trunk/admin/plugins/buffer_upload/index.en.html" >Buffer Upload</a></li><li><a href="/docs/trunk/admin/plugins/cacheurl/index.en.html" >CacheURL</a></li><li><a href="/docs/trunk/admin/plugins/combo_handler/index.en.html" >Combohandler</a></li><li><a href="/docs/trunk/admin/plugins/esi/index.en.html" >ESI</a></li><li><a href="/docs/trunk/admin/plugins/geoip_acl/index.en.html" >GeoIP ACLs</a></li><li><a hre
f="/docs/trunk/admin/plugins/header_filter/index.en.html" >Header Filter</a></li><li><a href="/docs/trunk/admin/plugins/hipes/index.en.html" >HIPES system</a></li><li><a href="/docs/trunk/admin/plugins/mysql_remap/index.en.html" >MySQL Remap</a></li><li><a href="/docs/trunk/admin/plugins/regex_remap/index.en.html" >Regex Remap</a></li><li><a href="/docs/trunk/admin/plugins/stale_while_revalidate/index.en.html" >Stale While Revalidate</a></li><li><a href="/docs/trunk/admin/plugins/stats_over_http/index.en.html" >Stats over HTTP</a></li><li><a href="/docs/trunk/admin/plugins/gzip/index.en.html" >gzip / deflate plugin</a></li></ul></li></ul></li></ul>
\ No newline at end of file