You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@trafficserver.apache.org by ig...@apache.org on 2011/03/22 13:46:15 UTC

svn commit: r1084149 - /trafficserver/site/branches/ats-cms/content/docs/trunk/admin/hierachical-caching/index.en.mdtext

Author: igalic
Date: Tue Mar 22 12:46:15 2011
New Revision: 1084149

URL: http://svn.apache.org/viewvc?rev=1084149&view=rev
Log:
Fix up markdown.
Try to make text sound a little less condescending.

Modified:
    trafficserver/site/branches/ats-cms/content/docs/trunk/admin/hierachical-caching/index.en.mdtext

Modified: trafficserver/site/branches/ats-cms/content/docs/trunk/admin/hierachical-caching/index.en.mdtext
URL: http://svn.apache.org/viewvc/trafficserver/site/branches/ats-cms/content/docs/trunk/admin/hierachical-caching/index.en.mdtext?rev=1084149&r1=1084148&r2=1084149&view=diff
==============================================================================
--- trafficserver/site/branches/ats-cms/content/docs/trunk/admin/hierachical-caching/index.en.mdtext (original)
+++ trafficserver/site/branches/ats-cms/content/docs/trunk/admin/hierachical-caching/index.en.mdtext Tue Mar 22 12:46:15 2011
@@ -55,7 +55,7 @@ HTTP and HTTPS requests. 
 **Note:** If you do not want all requests to go to the parent cache, then simply 
 configure Traffic Server to route certain requests (such as requests containing 
 specific URLs) directly to the origin server. SImply set parent proxy rules 
-in [parent.config](files.htm#parent.config).
+in [parent.config](../configuration-files/parent.config)
 
 The figure below illustrates a simple cache hierarchy with a Traffic Server 
 node configured to use a parent cache. In the following scenario, a client 
@@ -67,13 +67,7 @@ to the Traffic Server, where it is cache
 requests for this content can now be served directly from the Traffic Server 
 cache (until the data is stale or expired).
 
-![](images/cachehrc.jpg)
-
-> 
->   
-> 
-> _**Parent caching**_
-> 
+![Parent caching](/images/admin/cachehrc.jpg)
 
 **Note:** If the request is a cache miss on the parent, then the parent retrieves 
 the content from the origin server (or from another cache, depending on the 
@@ -101,34 +95,38 @@ To configure Traffic Server to use one o
 the following steps: 
 
 * Enable the parent caching option. 
-* Identify the parent cache you want to use to service missed requests. To use **parent failover**, you must identify more than one parent cache so that when a parent cache is unavailable, requests are sent to another parent cache.
+* Identify the parent cache you want to use to service missed requests.
+ To use **parent failover**, you must identify more than one parent cache
+ so that when a parent cache is unavailable, requests are sent to another parent cache.
 
 **Note:** You need to configure the child cache only. No additional configuration 
 is needed for the Traffic Server parent cache. 
 
+
 ##### Configure Traffic Server to use a parent cache:  ##### {#ConfigureTSuseaparentcache}
 
-1. In a text editor, open the `records.config` file located in the Traffic Server `config` directory. 
-2. Edit the following variable:
-3. 
-4. **Variable** **Description** 
+Edit the following variable in `records.config` file located in the Traffic Server `config` directory. 
+
 _`proxy.config.http.parent_proxy_routing_enable`_
 :   Set this variable to 1 to enable the parent caching option.
 
-5. 
-6. Save and close the `records.config` file. 
-7. In a text editor, open the `parent.config` file located in the Traffic Server `config` directory. 
-8. Set parent proxy rules to specify the parent cache to which you want missed requests to be forwarded; refer to [parent.config](files.htm#parent.config).   
- The following example configures Traffic Server to route all requests containing the regular expression `politics` and the path `/viewpoint` directly to the origin server (bypassing any parent hierarchies):   
-`url_regex=politics prefix=/viewpoint go_direct=true`  
-  
- The following example configures Traffic Server to direct all missed requests with URLs beginning with `mms://host1` to the parent cache `parent1`. If `parent1` cannot serve the requests, then requests are forwarded to `parent2`. Because `round-robin=true`, Traffic Server goes through the parent cache list in a round-robin based on client IP address.   
-`dest_host=host1 scheme=mms parent=”parent1;parent2” round-robin=strict`  
-  
-
-9. Save and close `parent.config`
-10. Navigate to the Traffic Server `bin` directory.
-11. Run the command `traffic_line -x` to apply the configuration changes.
+Edit the [`parent.config`](../configuration-files/parent.config) file located in the Traffic Server `config` directory to set
+parent proxy rules to specify the parent cache to which you want missed requests to be forwarded;
+
+The following example configures Traffic Server to route all requests containing the regular expression `politics`
+and the path `/viewpoint` directly to the origin server (bypassing any parent hierarchies):
+
+    url_regex=politics prefix=/viewpoint go_direct=true
+
+The following example configures Traffic Server to direct all missed requests with URLs beginning
+with `http://host1` to the parent cache `parent1`. If `parent1` cannot serve the requests, then
+requests are forwarded to `parent2`. Because `round-robin=true`, Traffic Server goes through the
+parent cache list in a round-robin based on client IP address.
+
+    dest_host=host1 scheme=http parent=”parent1;parent2” round-robin=strict
+
+
+Run the command `traffic_line -x` to apply the configuration changes.
 
 ## ICP Peering ## {#ICPPeering}
 
@@ -165,68 +163,25 @@ must perform the following tasks: 
 
 ##### To configure Traffic Server to use an ICP cache hierarchy:  ##### {#configureTSuseanICPcachehierarchy}
 
-1. In a text editor, open the `records.config` file located in the Traffic Server `config` directory. 
-2. Edit the following variables:
-3. 
-4. **Variable** **Description** 
+Edit the following variables in `records.config` file located in the Traffic Server `config` directory. 
+
 _`proxy.config.icp.enabled`_
-:   Set this variable to:  
-		   0 to disable ICP.  
-		   1 to allow Traffic Server to receive ICP queries only.  
-		   2 to allow Traffic Server to send and receive ICP queries.
+:   0 disables ICP.
+:   1 allows Traffic Server to receive ICP queries only
+:   2 allows Traffic Server to send and receive ICP queries.
+
 _`proxy.config.icp.icp_port`_
-:   Set this variable to specify the UDP port that you want to use for ICP messages. 
-		The default is 3130. 
+:   This variable specifes the UDP port that you want to use for ICP messages (default is 3130).
+
 _`proxy.config.icp.multicast_enabled`_
-:   Set this variable to:  
-		   0 to disable ICP multicast.  
-		   1 to enable ICP multicast.
-_`proxy.config.icp.query_timeout`_
-:   Set this variable to specify the timeout used for ICP queries. The default 
-		is 2 seconds.
+:   0 disables ICP multicast.
+:   1 enables ICP multicast.
 
-5. 
-6. Save and close `records.config`
-7. In a text editor, open the `icp.config` file located in the Traffic Server `config` directory. 
-8. For each ICP peer you want to identify, enter a separate rule in the [icp.config](files.htm#icp.config) file.
-9. Save and close `icp.config`
-10. Navigate to the Traffic Server `bin` directory. 
-11. Run the command `traffic_line -x` to apply the configuration changes.
-
-      
-
-   
-
-   
-
-         
-
-* [Overview](intro.htm)
-* [Getting Started](getstart.htm)
-* [HTTP Proxy Caching ](http.htm)
-* [Explicit Proxy Caching](explicit.htm)
-* [Reverse Proxy and HTTP Redirects](reverse.htm)
-* [Hierarchical Caching](hier.htm)
-* [Configuring the Cache](cache.htm)
-* [Monitoring Traffic](monitor.htm)
-* [Configuring Traffic Server](configure.htm)
-* [Security Options](secure.htm)
-* [Working with Log Files](log.htm)
-* [Traffic Line Commands](cli.htm)
-* [Event Logging Formats](logfmts.htm)
-* [Configuration Files](files.htm) 
-* [Traffic Server Error Messages](errors.htm)
-* [FAQ and Troubleshooting Tips](trouble.htm)
-* [Traffic Server 管理员指南](ts_admin_chinese.pdf) (PDF)
-
-   
-
-   
-
- Copyright © 2011 [The Apache Software Foundation](http://www.apache.org/). 
-Licensed under the [Apache License](http://www.apache.org/licenses/), Version 
-2.0. Apache Traffic Server, Apache, the Apache Traffic Server logo, and the 
-Apache feather logo are trademarks of The Apache Software Foundation.
+_`proxy.config.icp.query_timeout`_
+:   This variable specifes the timeout used for ICP queries (default is 2 seconds).
 
+Edit `icp.config` file located in the Traffic Server `config` directory: 
+For each ICP peer you want to identify, enter a separate rule in the [icp.config](../configuration-files/icp.config) file.
 
+Run the command `traffic_line -x` to apply the configuration changes.