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 2011/04/13 04:00:53 UTC

svn commit: r788262 - in /websites/staging/trafficserver/trunk/content/docs/trunk/admin: event-logging-formats/index.en.html explicit-proxy-caching/index.en.html getting-started/index.en.html security-options/index.en.html

Author: buildbot
Date: Wed Apr 13 02:00:52 2011
New Revision: 788262

Log:
Staging update by buildbot

Modified:
    websites/staging/trafficserver/trunk/content/docs/trunk/admin/event-logging-formats/index.en.html
    websites/staging/trafficserver/trunk/content/docs/trunk/admin/explicit-proxy-caching/index.en.html
    websites/staging/trafficserver/trunk/content/docs/trunk/admin/getting-started/index.en.html
    websites/staging/trafficserver/trunk/content/docs/trunk/admin/security-options/index.en.html

Modified: websites/staging/trafficserver/trunk/content/docs/trunk/admin/event-logging-formats/index.en.html
==============================================================================
--- websites/staging/trafficserver/trunk/content/docs/trunk/admin/event-logging-formats/index.en.html (original)
+++ websites/staging/trafficserver/trunk/content/docs/trunk/admin/event-logging-formats/index.en.html Wed Apr 13 02:00:52 2011
@@ -41,8 +41,8 @@
     <div id="content">
       <h1 id="EventLoggingFormats">Event Logging Formats</h1>
 <ul>
-<li><a href="#66912">Custom Logging Fields</a> provides descriptions of logging fields.</li>
-<li><a href="#63460">Logging Format Cross-Reference</a> provides cross-references between Trafic Server logging fields and Netscape &amp; Squid logging fields (including Netscape Extended and Extended-2 fields).</li>
+<li><a href="#CustomLoggingFields">Custom Logging Fields</a> provides descriptions of logging fields.</li>
+<li><a href="#LoggingFormatCrossReference">Logging Format Cross-Reference</a> provides cross-references between Trafic Server logging fields and Netscape &amp; Squid logging fields (including Netscape Extended and Extended-2 fields).</li>
 </ul>
 <h2 id="CustomLoggingFields">Custom Logging Fields</h2>
 <p>The following list describes Traffic Server custom logging fields. </p>
@@ -271,7 +271,7 @@ Traffic Server and the time at which Tra
 the response back to the client.</p>
 </dd>
 </dl>
-<h2 id="LoggingFormatCross-Reference">Logging Format Cross-Reference</h2>
+<h2 id="LoggingFormatCrossReference">Logging Format Cross-Reference</h2>
 <p>The following sections illustrate the correspondence between Traffic Server 
 logging fields and standard logging fields for the Squid and Netscape formats. </p>
 <h3 id="SquidLoggingFormats">Squid Logging Formats</h3>

Modified: websites/staging/trafficserver/trunk/content/docs/trunk/admin/explicit-proxy-caching/index.en.html
==============================================================================
--- websites/staging/trafficserver/trunk/content/docs/trunk/admin/explicit-proxy-caching/index.en.html (original)
+++ websites/staging/trafficserver/trunk/content/docs/trunk/admin/explicit-proxy-caching/index.en.html Wed Apr 13 02:00:52 2011
@@ -56,13 +56,13 @@ must provide the following information: 
 <li>The fully-qualified hostname or IP address of the Traffic Server node</li>
 <li>The Traffic Server proxy server port (port 8080)</li>
 </ul>
-<p>In addition, clients can specify <em>not</em> to use Traffic Server for certain sites 
-- in such cases, requests to the listed sites go directly to the origin server. 
+<p>In addition, clients can specify <em>not</em> to use Traffic Server for certain sites -
+in such cases, requests to the listed sites go directly to the origin server. 
 The procedures for manual configuration vary among browser versions; refer 
 to specific browser documentation for complete proxy configuration instructions. 
 You do not need to set any special configuration options on Traffic Server 
 if you want to accept requests from manually-configured browsers. </p>
-<h3 id="UsingaPACFile">Using a PAC File</h3>
+<h3 id="UsingPACFile">Using a PAC File</h3>
 <p>A <strong>PAC file</strong> is a specialized JavaScript function definition that a browser 
 calls to determine how requests are handled. Clients must specify (in their 
 browser settings) the URL from which the PAC file is loaded. You can store 
@@ -71,79 +71,24 @@ the URL for this file to your clients. <
 <p>If you want to store a PAC file on the Traffic Server system, then you must 
 perform the following configuration: </p>
 <ul>
-<li>Either copy an existing PAC file into the Traffic Server <code>config</code> directory or enter a script that defines the proxy server configuration settings in the <code>proxy.pac</code> file provided (the file is empty by default). </li>
-<li>Specify the port Traffic Server uses to serve the PAC file. The default port is 8083.</li>
+<li>Either copy an existing PAC file into the Traffic Server <code>config</code> directory
+  or enter a script that defines the proxy server configuration settings in the
+  <code>proxy.pac</code> file provided. The file is empty by default. A sample script is provided in <a href="#SamplePACFile">Sample PAC File</a>. </li>
+<li>Specify the port Traffic Server uses to serve the PAC file. The default port is <a href="../configuration-files/records.config#proxy.config.admin.autoconf_port">8083</a>.</li>
 </ul>
-<h5 id="ConfigureTSprovideaPACfilemanually">Configure Traffic Server to provide a PAC file manually:</h5>
-<ol>
-<li>If you have an existing PAC file, then replace the <code>proxy.pac</code> file located in the Traffic Server <code>config</code> directory with the existing file. </li>
-<li>In a text editor, open the <code>records.config</code> file located in the Traffic Server <code>config</code> directory. </li>
-<li>Edit the following variable:</li>
-<li>
-<dl>
-<dt><strong>Variable</strong> <strong>Description</strong></dt>
-<dt><code>_proxy.config.admin.autoconf_port_</code></dt>
-<dd />
-</dl>
-<div class="codehilite"><pre><span class="n">Set</span> <span class="n">this</span> <span class="n">variable</span> <span class="n">to</span> <span class="n">specify</span> <span class="n">the</span> <span class="n">port</span> <span class="n">Traffic</span> <span class="n">Server</span> <span class="n">uses</span> <span class="n">to</span> <span class="n">serve</span> <span class="n">the</span> <span class="n">PAC</span> 
-<span class="n">file</span><span class="o">.</span> <span class="n">The</span> <span class="n">default</span> <span class="n">port</span> <span class="n">is</span> <span class="mi">8083</span><span class="o">.</span>
-</pre></div>
-
-
-</li>
-<li>
-<p>Save and close the <code>records.config</code> file. </p>
-</li>
-<li>
-<p>In a text editor, open the <code>proxy.pac</code> file located in the Traffic Server <code>config</code> directory. </p>
-</li>
-<li>
-<p>If you copied an existing PAC file into the Traffic Server config directory, then the <code>proxy.pac</code> file contains your proxy configuration settings. Check the settings and make changes if necessary. </p>
-</li>
-<li>If you did not copy an existing PAC file into the Traffic Server <code>config</code> directory, then the <code>proxy.pac</code> file is empty. Enter a script that will provide the proxy server configuration settings. A sample script is provided in <a href="#SamplePACFile">Sample PAC File</a>. </li>
-</ol>
-<p>Save and close the <code>proxy.pac</code> file. 
-  Restart Traffic Server. 
-  Inform your users to set their browsers to point to this PAC file; <a href="#SetBrowsersPointPACFile">click here 
-for browser settings</a>. </p>
 <h4 id="SamplePACFile">Sample PAC File</h4>
 <p>The following sample PAC file instructs browsers to connect directly to all 
 hosts without a fully-qualified domain name and to all hosts in the local domain. 
 All other requests go to the Traffic Server named <code>myproxy.company.com</code>.</p>
-<p><code>function FindProxyForURL(url, host)   
-{  
- if (isPlainHostName(host)) ||  
- (localHostOrDomainIs(host, ".company.com")) {  
- return "DIRECT";  
- }  
- else  
- return "PROXY myproxy.company.com:8080;" +  
- "DIRECT";   
-}</code></p>
-<h3 id="_+">### {# }</h3>
-<ul>
-<li><a href="intro.htm">Overview</a></li>
-<li><a href="getstart.htm">Getting Started</a></li>
-<li><a href="http.htm">HTTP Proxy Caching </a></li>
-<li><a href="explicit.htm">Explicit Proxy Caching</a></li>
-<li><a href="reverse.htm">Reverse Proxy and HTTP Redirects</a></li>
-<li><a href="hier.htm">Hierarchical Caching</a></li>
-<li><a href="cache.htm">Configuring the Cache</a></li>
-<li><a href="monitor.htm">Monitoring Traffic</a></li>
-<li><a href="configure.htm">Configuring Traffic Server</a></li>
-<li><a href="secure.htm">Security Options</a></li>
-<li><a href="log.htm">Working with Log Files</a></li>
-<li><a href="cli.htm">Traffic Line Commands</a></li>
-<li><a href="logfmts.htm">Event Logging Formats</a></li>
-<li><a href="files.htm">Configuration Files</a> </li>
-<li><a href="errors.htm">Traffic Server Error Messages</a></li>
-<li><a href="trouble.htm">FAQ and Troubleshooting Tips</a></li>
-<li><a href="ts_admin_chinese.pdf">Traffic Server 管理员指南</a> (PDF)</li>
-</ul>
-<p>Copyright © 2011 <a href="http://www.apache.org/">The Apache Software Foundation</a>. 
-Licensed under the <a href="http://www.apache.org/licenses/">Apache License</a>, Version 
-2.0. Apache Traffic Server, Apache, the Apache Traffic Server logo, and the 
-Apache feather logo are trademarks of The Apache Software Foundation.</p>
+<div class="codehilite"><pre><span class="kd">function</span> <span class="nx">FindProxyForURL</span><span class="p">(</span><span class="nx">url</span><span class="p">,</span> <span class="nx">host</span><span class="p">)</span>
+<span class="p">{</span>
+  <span class="k">if</span> <span class="p">(</span><span class="nx">isPlainHostName</span><span class="p">(</span><span class="nx">host</span><span class="p">))</span> <span class="o">||</span> <span class="p">(</span><span class="nx">localHostOrDomainIs</span><span class="p">(</span><span class="nx">host</span><span class="p">,</span> <span class="s2">&quot;.company.com&quot;</span><span class="p">))</span> <span class="p">{</span>
+    <span class="k">return</span> <span class="s2">&quot;DIRECT&quot;</span><span class="p">;</span>
+  <span class="p">}</span>
+  <span class="k">else</span>
+    <span class="k">return</span> <span class="s2">&quot;PROXY myproxy.company.com:8080; DIRECT&quot;</span><span class="p">;</span>
+<span class="p">}</span>
+</pre></div>
     </div>
   </div><!-- main -->
 

Modified: websites/staging/trafficserver/trunk/content/docs/trunk/admin/getting-started/index.en.html
==============================================================================
--- websites/staging/trafficserver/trunk/content/docs/trunk/admin/getting-started/index.en.html (original)
+++ websites/staging/trafficserver/trunk/content/docs/trunk/admin/getting-started/index.en.html Wed Apr 13 02:00:52 2011
@@ -56,49 +56,49 @@ the health of the Traffic Server system.
 <h5 id="runTSstartcommand">To run the <code>trafficserver start</code> command:</h5>
 <ol>
 <li>Log on to the Traffic Server node as the Traffic Server administrator and navigate to the Traffic Server <code>bin</code> directory.</li>
-<li>Enter the following command: <br />
-<code>./trafficserver start</code></li>
+<li>
+<p>Enter the following command:</p>
+<div class="codehilite"><pre><span class="o">./</span><span class="n">trafficserver</span> <span class="n">start</span>
+</pre></div>
+
+
+</li>
 </ol>
 <h2 id="StartTrafficLine">Start Traffic Line</h2>
 <p>Traffic Line provides a quick way of viewing Traffic Server statistics and
 configuring the Traffic Server system via command-line interface. To execute
 individual commands or script multiple commands, refer to <a href="../traffic-line-commands">Traffic Line Commands</a>.</p>
-<h5 id="startaTrafficLinesession">To start a Traffic Line session:</h5>
-<ol>
-<li>Log on to a Traffic Server node as the Traffic Server administrator and navigate to the Traffic Server <code>bin</code> directory.
- Traffic Line commands take the following form: <br />
-<code>./traffic_line</code> <em><code>-command argument</code></em></li>
-<li>For a list of <code>traffic_line</code> commands, enter: <br />
-<code>./traffic_line -h</code></li>
-</ol>
+<p>Traffic Line commands take the following form:</p>
+<div class="codehilite"><pre> <span class="o">./</span><span class="n">traffic_line</span> <span class="o">-</span><span class="n">command</span> <span class="n">argument</span>
+</pre></div>
+
+
+<p>For a list of <code>traffic_line</code> commands, enter:</p>
+<div class="codehilite"><pre> <span class="o">./</span><span class="n">traffic_line</span> <span class="o">-</span><span class="n">h</span>
+</pre></div>
+
+
 <h2 id="StartTrafficShell">Start Traffic Shell</h2>
 <p>Traffic Shell is a command-line tool that enables you to monitor and configure
 Traffic Server; it can be used instead of Traffic Line. Traffic Server provides
 documentation for Traffic Shell in the form of manual (<code>man</code>) pages.</p>
-<h5 id="startTrafficShellreadanoverviewmanpage">To start Traffic Shell and read an overview <code>man</code> page:</h5>
-<ol>
-<li>Log on to a Traffic Server node as the Traffic Server administrator and navigate to the Traffic Server <code>bin</code> directory.</li>
-<li>
-<p>Enter the following command: <br />
-<code>./start_traffic_shell</code></p>
-</li>
-<li>
-<p>Enter the following command to display the <code>traffic_shell</code> overview <code>man</code> page:
-<code>man traffic_shell</code></p>
-</li>
-</ol>
-<p>The <code>man</code> page describes how to use Traffic Shell, how to obtain a list of available commands, and how to obtain documentation about each command.</p>
+<div class="codehilite"><pre><span class="o">./</span><span class="n">start_traffic_shell</span>
+</pre></div>
+
+
+<p>The <code>man</code> page describes how to use Traffic Shell, how to obtain a list of available
+commands, and how to obtain documentation about each command.</p>
+<div class="codehilite"><pre><span class="n">man</span> <span class="n">traffic_shell</span>
+</pre></div>
+
+
 <h2 id="StopTS">Stop Traffic Server</h2>
 <p>To stop Traffic Server, always use the <code>trafficserver</code> command, passing in
 the attribute <code>stop</code>. This command stops all the Traffic Server processes (<code>traffic_manager</code>,
 <code>traffic_server</code>, and <code>traffic_cop</code>). Do not manually stop processes, as this
 can lead to unpredictable results.</p>
-<h5 id="runTSstopcommand">To run the <code>trafficserver stop</code> command:</h5>
-<ol>
-<li>Log on to the node as the Traffic Server administrator and navigate to the Traffic Server <code>bin</code> directory.</li>
-<li>Enter the following command:<br />
-<code>./trafficserver stop</code></li>
-</ol>
+<div class="codehilite"><pre><span class="o">./</span><span class="n">trafficserver</span> <span class="n">stop</span>
+</pre></div>
     </div>
   </div><!-- main -->
 

Modified: websites/staging/trafficserver/trunk/content/docs/trunk/admin/security-options/index.en.html
==============================================================================
--- websites/staging/trafficserver/trunk/content/docs/trunk/admin/security-options/index.en.html (original)
+++ websites/staging/trafficserver/trunk/content/docs/trunk/admin/security-options/index.en.html Wed Apr 13 02:00:52 2011
@@ -44,7 +44,7 @@
 <p>This chapter discusses the following topics: </p>
 <ul>
 <li><a href="#ControllingClientAccessProxyCache">Controlling Client Access to the Proxy Cache</a></li>
-<li><a href="#ConfiguringDNSServerSelectionSplit">Configuring DNS Server Selection (Split DNS)</a></li>
+<li><a href="#SplitDNS">Configuring DNS Server Selection (Split DNS)</a></li>
 <li><a href="#ConfiguringProxyAuthentication">Configuring Proxy Authentication</a></li>
 <li><a href="#UsingSSLTermination">Using SSL Termination</a></li>
 </ul>
@@ -53,14 +53,12 @@
 cache by editing a configuration file.</p>
 <h5 id="specifyclientsalloweduseproxycache">To specify the clients allowed to use the proxy cache:</h5>
 <ol>
-<li>In a text editor, open the <code>ip_allow.config</code> file located in the Traffic Server <code>config</code> directory. </li>
-<li>Add a line in the file for each IP address or range of IP addresses allowed to access Traffic Server (refer to <a href="files.htm#ip_allow.config">ip_allow.config</a>). </li>
-<li>Save and close the <code>ip_allow.config</code> file. </li>
-<li>Navigate to the Traffic Server <code>bin</code> directory.</li>
+<li>Add a line in the file <code>ip_allow.config</code> for each IP address or range of
+   IP addresses allowed to access Traffic Server (refer to <a href="../configuration-files/ip_allow.config">ip_allow.config</a>). </li>
 <li>Run the command <code>traffic_line -x</code> to apply the configuration changes.</li>
 </ol>
-<h2 id="configuring_dns_server_selection_split_dns__configuringdnsserverselectionsplitdns">Configuring DNS Server Selection (Split DNS) ## {#ConfiguringDNSServerSelection(SplitDNS)}</h2>
-<p>The <strong>Split DNS </strong>option enables you to configure Traffic Server to use multiple 
+<h2 id="SplitDNS">Configuring DNS Server Selection (Split DNS)</h2>
+<p>The <strong>Split DNS</strong> option enables you to configure Traffic Server to use multiple 
 DNS servers, as dictated by your security requirements. For example, you might 
 configure Traffic Server to use one set of DNS servers to resolve hostnames 
 on your internal network, while allowing DNS servers outside the firewall to 
@@ -68,18 +66,14 @@ resolve hosts on the Internet. This main
 while continuing to provide direct access to sites outside your organization. </p>
 <p>To configure Split DNS, you must do the following: </p>
 <ul>
-<li>Specify the rules for performing DNS server selection based on the destination domain, the destination host, or a URL regular expression. </li>
+<li>Specify the rules for performing DNS server selection based on the destination domain,
+  the destination host, or a URL regular expression. </li>
 <li>Enable the <strong>Split DNS</strong> option.</li>
 </ul>
 <h5 id="configureSplitDNS">To configure Split DNS:</h5>
 <ol>
-<li>In a text editor, open the <code>splitdns.config</code> file located in the Traffic Server <code>config</code> directory. </li>
-<li>Add rules to the <code>splitdns.config</code> file. For information about the format of the <code>splitdns.config</code> file, <a href="files.htm#splitdns.config">click here</a>. </li>
-<li>Save and close the <code>splitdns.config</code> file.</li>
-<li>In a text editor, open the <code>records.config</code> file located in the Traffic Server <code>config</code> directory. </li>
-<li>Set the variable <em><code>proxy.process.dns.splitDNS.enabled</code></em> to <code>1</code> to enable split DNS.</li>
-<li>Save and close the <code>records.config</code> file. </li>
-<li>Navigate to the Traffic Server <code>bin</code> directory. </li>
+<li>Add rules to the <code>splitdns.config</code> file. (Refer to <a href="../configuration-files/splitdns.config"><code>splitdns.config</code></a>. </li>
+<li>In the file <code>records.config</code> the variable <a href="../configuration-files/records.config#proxy.process.dns.splitDNS.enabled"><em><code>proxy.process.dns.splitDNS.enabled</code></em></a> to <code>1</code> to enable split DNS.</li>
 <li>Run the command <code>traffic_line -x</code> to apply the configuration changes. </li>
 </ol>
 <h2 id="UsingSSLTermination">Using SSL Termination</h2>
@@ -100,10 +94,7 @@ Server to Use an SSL Accelerator Card</a
 <p>The figure below illustrates communication between a client and Traffic Server 
 (and between Traffic Server and an origin server) when the SSL termination 
 option is enabled &amp; configured for<strong> client/Traffic Server connections only</strong>. </p>
-<p><img alt="" src="images/ssl_c.jpg" /></p>
-<blockquote>
-<p><em><strong>Client and Traffic Server communication using SSL termination</strong></em></p>
-</blockquote>
+<p><img alt="Client and Traffic Server communication using SSL termination" src="/images/admin/ssl_c.jpg" /></p>
 <p>The figure above depicts the following: </p>
 <p><strong>Step 1:</strong> The client sends an HTTPS request for content. Traffic Server receives 
 the request and performs the SSL 'handshake' to authenticate the client (depending 
@@ -122,74 +113,49 @@ The client decrypts and displays the con
 <p>To configure Traffic Server to use the SSL termination option for client/Traffic 
 Server connections, you must do the following: </p>
 <ul>
-<li>Obtain and install an SSL server certificate from a recognized certificate authority (such as VeriSign). The SSL server certificate contains information that enables the client to authenticate Traffic Server and exchange encryption keys. </li>
+<li>Obtain and install an SSL server certificate from a recognized certificate authority.
+  The SSL server certificate contains information that enables the client to authenticate
+  Traffic Server and exchange encryption keys. </li>
 <li>Configure SSL termination options: </li>
-<li>Enable the <strong>SSL termination</strong> option. 
-  Set the port number used for SSL communication. 
-  Specify the filename and location of the server certificate. 
-  (Optional) Configure the use of client certificates. <br />
- Client certificates are located on the client. If you configure Traffic Server to require client certificates, then Traffic Server verifies the client certificate during the SSL handshake that authenticates the client. If you configure Traffic Server to <em>not</em> require client certificates, then access to Traffic Server is managed through other Traffic Server options that have been set (such as rules in the <code>ip_allow.config</code> file). 
-  Specify the filename and location of the Traffic Server private key (if the private key is not located in the server certificate file). <br />
- Traffic Server uses its private key during the SSL handshake to decrypt the session encryption keys. The private key must be stored and protected against theft. 
-  (Optional) Configure the use of Certification Authorities (CAs). <br />
- CAs add security by verifying the identity of the person requesting a certificate.</li>
+<li>Enable the <strong>SSL termination</strong> option. <ul>
+<li>Set the port number used for SSL communication. </li>
+<li>Specify the filename and location of the server certificate. </li>
+<li>(Optional) Configure the use of client certificates:
+  Client certificates are located on the client. If you configure Traffic Server to require client
+  certificates, then Traffic Server verifies the client certificate during the SSL handshake that
+  authenticates the client. If you configure Traffic Server to <em>not</em> require client certificates,
+  then access to Traffic Server is managed through other Traffic Server options that have been set
+  (such as rules in the <a href="../configuration-files/ip_allow.config"><code>ip_allow.config</code></a> file). </li>
+<li>Specify the filename and location of the Traffic Server private key (if the private key is not
+  located in the server certificate file).
+  Traffic Server uses its private key during the SSL handshake to decrypt the session encryption keys.
+  The private key must be stored and protected against theft. </li>
+<li>(Optional) Configure the use of Certification Authorities (CAs).
+   CAs add security by verifying the identity of the person requesting a certificate.</li>
+</ul>
+</li>
 </ul>
 <h5 id="to_configure_ssl_termination_for_clienttraffic_server_connections___configuresslterminationforclienttsconnections">To configure SSL termination for client/Traffic Server connections:  ##### {#configureSSLterminationforclient/TSconnections}</h5>
 <ol>
-<li>In a text editor, open the <code>records.config</code> file located in the Traffic Server <code>config</code> directory. </li>
-<li>Edit the following variables in the <code>SSL Termination</code> section of the file: </li>
-<li>
-<dl>
-<dt><strong>Variable</strong> <strong>Description</strong></dt>
-<dt><code>_proxy.config.ssl.enabled_</code></dt>
-<dd>Set this variable to 1 to enable the SSL termination option.</dd>
-<dt><code>_proxy.config.ssl.server_port_</code></dt>
-<dd>Set this variable to specify the port used for SSL communication. The default 
-    port is 443.</dd>
-<dt><code>_proxy.config.ssl.client.certification_level_</code></dt>
-<dd>Set this variable to one of the following values:<br />
-<code>0</code> - no client certificates are required. Traffic Server does not verify client certificates during the SSL handshake. Access to Traffic Server depends on Traffic Server configuration options (such as access control lists).<br />
-<code>1</code> - client certificates are optional. If a client has a certificate, then the certificate is validated. If the client does not have a certificate, then the client is still allowed access to Traffic Server unless access is denied through other Traffic Server configuration options.<br />
-<code>2</code> - client certificates are required. The client must be authenticated during the SSL handshake; Clients without a certificate are not allowed to access Traffic Server.</dd>
-<dt><code>_proxy.config.ssl.server.cert.filename_</code></dt>
-<dd>Set this variable to specify the filename of the Traffic Server SSL server certificate.<br />
-     Traffic Server provides a demo server certificate called <code>server.pem</code> - use this certificate to verify that the SSL feature is working.<br />
-     If you are using multiple server certificates, then set this variable to specify the default filename.</dd>
-<dt><code>_proxy.config.ssl.server.cert.path_</code></dt>
-<dd>Set this variable to specify the location of the Traffic Server SSL server 
-    certificate. The default directory is the Traffic Server <code>config</code> directory. </dd>
-</dl>
+<li>Edit the following variables in the <code>SSL Termination</code> section of the <code>records.config</code> file: <ul>
+<li><a href="../configuration-files/records.config#proxy.config.ssl.enabled"><em><code>proxy.config.ssl.enabled</code></em></a></li>
+<li><a href="../configuration-files/records.config#proxy.config.ssl.server_port"><em><code>proxy.config.ssl.server_port</code></em></a></li>
+<li><a href="../configuration-files/records.config#proxy.config.ssl.client.certification_level"><em><code>proxy.config.ssl.client.certification_level</code></em></a></li>
+<li><a href="../configuration-files/records.config#proxy.config.ssl.server.cert.filename"><em><code>proxy.config.ssl.server.cert.filename</code></em></a></li>
+<li><a href="../configuration-files/records.config#proxy.config.ssl.server.cert.path"><em><code>proxy.config.ssl.server.cert.path</code></em></a></li>
+<li><a href="../configuration-files/records.config#proxy.config.ssl.server.private_key.filename"><em><code>proxy.config.ssl.server.private_key.filename</code></em></a></li>
+<li><a href="../configuration-files/records.config#proxy.config.ssl.server.private_key.path"><em><code>proxy.config.ssl.server.private_key.path</code></em></a></li>
+<li><a href="../configuration-files/records.config#proxy.config.ssl.CA.cert.filename"><em><code>proxy.config.ssl.CA.cert.filename</code></em></a></li>
+<li><a href="../configuration-files/records.config#proxy.config.ssl.CA.cert.path"><em><code>proxy.config.ssl.CA.cert.path</code></em></a></li>
+</ul>
 </li>
-</ol>
-<dl>
-<dt><code>_proxy.config.ssl.server.private_key.filename_</code></dt>
-<dd>Set this variable to specify the filename of the Traffic Server private key. 
-    Change this variable only if the private key is not located in the Traffic 
-    Server SSL server certificate file.</dd>
-<dt><code>_proxy.config.ssl.server.private_key.path_</code></dt>
-<dd>Set this variable to specify the location of the Traffic Server private key. 
-    Change this variable only if the private key is not located in the Traffic 
-    Server SSL server certificate file.</dd>
-<dt><code>_proxy.config.ssl.CA.cert.filename_</code></dt>
-<dd>Specify the filename of the certificate authority that client certificates 
-    will be verified against. The default value is <code>NULL</code>.</dd>
-<dt><code>_proxy.config.ssl.CA.cert.path_</code></dt>
-<dd>Specify the location of the certificate authority file that client certificates 
-    will be verified against. The default value is <code>NULL</code>.</dd>
-</dl>
-<ol>
-<li>Save and close the <code>records.config</code> file. </li>
-<li>Navigate to the Traffic Server <code>bin</code> directory. </li>
 <li>Run the command <code>traffic_line -L</code> to restart Traffic Server on the local node or <code>traffic_line -M</code> to restart Traffic Server on all the nodes in a cluster. </li>
 </ol>
 <h3 id="TSOriginServerConnections">Traffic Server and Origin Server Connections</h3>
 <p>The figure below illustrates communication between Traffic Server and an origin 
 server when the SSL termination option is enabled for <strong>Traffic Server/origin 
 server connections</strong>.</p>
-<p><img alt="" src="images/ssl_os.jpg" /></p>
-<blockquote>
-<p><em><strong>Traffic Server and origin server communication using SSL termination</strong></em> </p>
-</blockquote>
+<p><img alt="Traffic Server and origin server communication using SSL termination" src="/images/admin/ssl_os.jpg" /></p>
 <p>The figure above depicts the following: </p>
 <p><strong>Step 1:</strong> If a client request is a cache miss or is stale, then Traffic Server 
 sends an HTTPS request for the content to the origin server. The origin server 
@@ -207,59 +173,38 @@ text version of the content to the clien
 <p>To configure Traffic Server to use the SSL termination option for Traffic Server 
 and origin server connections, you must do the following: </p>
 <ul>
-<li>Obtain and install an SSL client certificate from a recognized certificate authority (such as VeriSign). The SSL client certificate contains information that allows the origin server to authenticate Traffic Server (the client certificate is optional). </li>
+<li>Obtain and install an SSL client certificate from a recognized certificate authority.
+  The SSL client certificate contains information that allows the origin server to
+  authenticate Traffic Server (the client certificate is optional). </li>
 <li>Configure SSL termination options: </li>
-<li>Enable the SSL termination option. 
-   Set the port number used for SSL communication. 
-   Specify the filename and location of the SSL client certificate (if you choose 
-to use a client certificate). 
-   Specify the filename and location of the Traffic Server private key (if the private key is not located in the client certificate file). <br />
- Traffic Server uses its private key during the SSL handshake to decrypt the session encryption keys. The private key must be stored and protected against theft. 
-   Configure the use of CAs. <br />
- CAs allow the Traffic Server that's acting as a client to verify the identity of the server with which it is communicating, thereby enabling exchange of encryption keys.</li>
+<li>Enable the SSL termination option. <ul>
+<li>Set the port number used for SSL communication. </li>
+<li>Specify the filename and location of the SSL client certificate (if you choose
+  to use a client certificate). </li>
+<li>Specify the filename and location of the Traffic Server private key (if the
+  private key is not located in the client certificate file).
+  Traffic Server uses its private key during the SSL handshake to decrypt the
+  session encryption keys. The private key must be stored and protected against theft. </li>
+<li>Configure the use of CAs.
+  CAs allow the Traffic Server that's acting as a client to verify the identity of
+  the server with which it is communicating, thereby enabling exchange of encryption keys.</li>
+</ul>
+</li>
 </ul>
 <h5 id="to_configure_ssl_termination_for_traffic_serverorigin_server_connections___configuresslterminationfortsoriginserverconnections">To configure SSL termination for Traffic Server/origin server connections:  ##### {#configureSSLterminationforTS/originserverconnections}</h5>
 <ol>
-<li>In a text editor, open the <code>records.config</code> file located in the Traffic Server <code>config</code> directory. </li>
-<li>Edit the following variables in the <code>SSL Termination</code>section of the file: </li>
-<li>
-<dl>
-<dt><strong>Variable</strong> <strong>Description</strong></dt>
-<dt><code>_proxy.config.ssl.auth.enabled_</code></dt>
-<dd>Set this variable to <code>1</code> to enable the SSL termination option.</dd>
-<dt><code>_proxy.config.ssl.server_port_</code></dt>
-<dd>Set this variable to specify the port used for SSL communication. The default 
-    port is <code>443</code>.</dd>
-<dt><code>_proxy.config.ssl.client.verify.server_</code></dt>
-<dd>Set this option to <code>1</code> to require Traffic Server to verify the origin server 
-    certificate with the Certificate Authority.</dd>
-<dt><code>_proxy.config.ssl.client.cert.filename_</code></dt>
-<dd>If you have installed an SSL client certificate on Traffic Server, then set 
-    this variable to specify the client certificate filename.</dd>
-<dt><code>_proxy.config.ssl.client.cert.path_</code></dt>
-<dd>If you have installed an SSL client certificate on Traffic Server, then set 
-    this variable to the location of the client certificate. The default location 
-    is the Traffic Server <code>config</code> directory.</dd>
-<dt><code>_proxy.config.ssl.client.private_key.filename_</code></dt>
-<dd>Set this variable to specify the filename of the Traffic Server private key. 
-    Change this variable only if the private key is not located in the Traffic 
-    Server SSL client certificate file.</dd>
-<dt><code>_proxy.config.ssl.client.private_key.path_</code></dt>
-<dd>Set this variable to specify the location of the Traffic Server private key. 
-    Change this variable only if the private key is not located in the SSL client 
-    certificate file.</dd>
-<dt><code>_proxy.config.ssl.client.CA.cert.filename_</code></dt>
-<dd>Specify the filename of the Certificate Authority against which the origin 
-    server will be verified. The default value is <code>NULL</code>.</dd>
-<dt><code>_proxy.config.ssl.client.CA.cert.path_</code></dt>
-<dd>Specify the location of the Certificate Authority file against which the origin 
-    server will be verified. The default value is <code>NULL</code>.</dd>
-</dl>
-</li>
-<li>
-<p>Save and close the <code>records.config</code> file. </p>
+<li>Edit the following variables in the <code>SSL Termination</code> section of the <code>records.config</code> file: <ul>
+<li><a href="../configuration-files/records.config#proxy.config.ssl.auth.enabled"><em><code>proxy.config.ssl.auth.enabled</code></em></a></li>
+<li><a href="../configuration-files/records.config#proxy.config.ssl.server_port"><code>proxy.config.ssl.server_port</code></a></li>
+<li><a href="../configuration-files/records.config#proxy.config.ssl.client.verify.server"><code>proxy.config.ssl.client.verify.server</code></a></li>
+<li><a href="../configuration-files/records.config#proxy.config.ssl.client.cert.filename"><code>proxy.config.ssl.client.cert.filename</code></a></li>
+<li><a href="../configuration-files/records.config#proxy.config.ssl.client.cert.path"><code>proxy.config.ssl.client.cert.path</code></a></li>
+<li><a href="../configuration-files/records.config#proxy.config.ssl.client.private_key.filename"><code>proxy.config.ssl.client.private_key.filename</code></a></li>
+<li><a href="../configuration-files/records.config#proxy.config.ssl.client.private_key.path"><code>proxy.config.ssl.client.private_key.path</code></a></li>
+<li><a href="../configuration-files/records.config#proxy.config.ssl.client.CA.cert.filename"><code>proxy.config.ssl.client.CA.cert.filename</code></a></li>
+<li><a href="../configuration-files/records.config#proxy.config.ssl.client.CA.cert.path"><code>proxy.config.ssl.client.CA.cert.path</code></a></li>
+</ul>
 </li>
-<li>Navigate to the Traffic Server <code>bin</code> directory. </li>
 <li>Run the command <code>traffic_line -L</code> to restart Traffic Server on the local node or <code>traffic_line -M</code> to restart Traffic Server on all the nodes in a cluster. </li>
 </ol>
 <h3 id="ConfiguringTSUseanSSLAcceleratorCard">Configuring Traffic Server to Use an SSL Accelerator Card</h3>
@@ -270,72 +215,14 @@ then you'll use your normal SSL library;
 you'll use the library supported &amp; provided by the card manufacturer.</p>
 <h5 id="ConfigureTSuseanSSLacceleratorcard">Configure Traffic Server to use an SSL accelerator card:</h5>
 <ol>
-<li>In a text editor, open the <code>records.config</code> file located in the Traffic Server <code>config</code> directory. </li>
-<li>Edit the following variables in the <code>SSL Termination</code> section of the file: </li>
-<li>
-<dl>
-<dt><strong>Variable</strong> <strong>Description</strong></dt>
-<dt><code>_proxy.confg.ssl.accelerator_required_</code></dt>
-<dd>Set this specify if an accelerator card is required for operation. </dd>
-</dl>
-<div class="codehilite"><pre><span class="n">You</span> <span class="n">may</span> <span class="n">specify:</span>  
-<span class="sb">`0`</span> <span class="o">-</span> <span class="ow">not</span> <span class="n">required</span>  
-<span class="sb">`1`</span> <span class="o">-</span> <span class="n">accelerator</span> <span class="n">card</span> <span class="n">is</span> <span class="n">required</span> <span class="ow">and</span> <span class="n">Traffic</span> <span class="n">Server</span> <span class="n">will</span> <span class="ow">not</span> <span class="n">enable</span> <span class="n">SSL</span> <span class="k">unless</span> <span class="n">an</span> <span class="n">accelerator</span> <span class="n">card</span> <span class="n">is</span> <span class="n">present</span><span class="o">.</span>  
-<span class="sb">`2`</span> <span class="o">-</span> <span class="n">accelerator</span> <span class="n">card</span> <span class="n">is</span> <span class="n">required</span> <span class="ow">and</span> <span class="n">Traffic</span> <span class="n">Server</span> <span class="n">will</span> <span class="ow">not</span> <span class="n">start</span> <span class="k">unless</span> <span class="n">an</span> <span class="n">accelerator</span> <span class="n">card</span> <span class="n">is</span> <span class="n">present</span><span class="o">.</span>
-
-<span class="n">You</span> <span class="n">can</span> <span class="n">verify</span> <span class="n">operation</span> <span class="n">by</span> <span class="n">running</span><span class="sb">` /home/y/bin/openssl_accelerated`</span> <span class="p">(</span><span class="n">this</span> 
-<span class="n">comes</span> <span class="n">as</span> <span class="n">part</span> <span class="n">of</span> <span class="sb">`openssl_engines_init`</span><span class="p">)</span><span class="o">.</span>
-</pre></div>
-
-
-</li>
-</ol>
-<dl>
-<dt><code>_proxy.confg.ssl.accelerator.type_</code></dt>
-<dd>
-<div class="codehilite"><pre><span class="n">Specifies</span> <span class="k">if</span> <span class="n">the</span> <span class="n">Cavium</span> <span class="n">SSL</span> <span class="n">accelerator</span> <span class="n">card</span> <span class="n">is</span> <span class="n">installed</span> <span class="n">on</span> <span class="p">(</span><span class="ow">and</span> <span class="n">required</span> 
-<span class="n">by</span><span class="p">)</span> <span class="n">your</span> <span class="n">Traffic</span> <span class="n">Server</span> <span class="n">machine:</span>
-
-<span class="sb">`0`</span> <span class="o">=</span> <span class="n">none</span><span class="o">.</span> <span class="n">No</span> <span class="n">SSL</span> <span class="n">accelerator</span> <span class="n">card</span> <span class="n">is</span> <span class="n">installed</span> <span class="n">on</span> <span class="n">the</span> <span class="n">Traffic</span> <span class="n">Server</span> <span class="n">machine</span><span class="p">,</span> 
-<span class="n">so</span> <span class="n">the</span> <span class="n">CPU</span> <span class="n">on</span> <span class="n">the</span> <span class="n">Traffic</span> <span class="n">Server</span> <span class="n">machine</span> <span class="n">determines</span> <span class="n">the</span> <span class="n">number</span> <span class="n">of</span> <span class="n">requests</span> 
-<span class="n">served</span> <span class="n">per</span> <span class="n">second</span><span class="o">.</span>
-
-<span class="sb">`1`</span> <span class="o">=</span> <span class="n">an</span> <span class="n">accelerator</span> <span class="n">card</span> <span class="n">is</span> <span class="n">present</span> <span class="ow">and</span> <span class="n">required</span> <span class="n">by</span> <span class="n">Traffic</span> <span class="n">Server</span><span class="o">.</span>
-</pre></div>
-
-
-</dd>
-</dl>
-<ol>
-<li>Save and close the <code>records.config</code> file. </li>
-<li>Navigate to the Traffic Server <code>bin</code> directory. </li>
-<li>
-<p>Run the command <code>traffic_line -L</code> to restart Traffic Server on the local node or <code>traffic_line -M</code> to restart Traffic Server on all the nodes in a cluster. </p>
-</li>
-<li>
-<p><a href="intro.htm">Overview</a></p>
+<li>Edit the following variables in the <code>SSL Termination</code> section of the <code>records.config</code> file: <ul>
+<li><a href="../configuration-files/records.config#proxy.config.ssl.accelerator_required"><em><code>proxy.confg.ssl.accelerator_required</code></em></a></li>
+<li><a href="../configuration-files/records.config#proxy.confg.ssl.accelerator.type"><em><code>proxy.confg.ssl.accelerator.type</code></em></a></li>
+</ul>
 </li>
-<li><a href="getstart.htm">Getting Started</a></li>
-<li><a href="http.htm">HTTP Proxy Caching </a></li>
-<li><a href="explicit.htm">Explicit Proxy Caching</a></li>
-<li><a href="reverse.htm">Reverse Proxy and HTTP Redirects</a></li>
-<li><a href="hier.htm">Hierarchical Caching</a></li>
-<li><a href="cache.htm">Configuring the Cache</a></li>
-<li><a href="monitor.htm">Monitoring Traffic</a></li>
-<li><a href="configure.htm">Configuring Traffic Server</a></li>
-<li><a href="secure.htm">Security Options</a></li>
-<li><a href="log.htm">Working with Log Files</a></li>
-<li><a href="cli.htm">Traffic Line Commands</a></li>
-<li><a href="logfmts.htm">Event Logging Formats</a></li>
-<li><a href="files.htm">Configuration Files</a> </li>
-<li><a href="errors.htm">Traffic Server Error Messages</a></li>
-<li><a href="trouble.htm">FAQ and Troubleshooting Tips</a></li>
-<li><a href="ts_admin_chinese.pdf">Traffic Server 管理员指南</a> (PDF)</li>
+<li>Run the command <code>traffic_line -L</code> to restart Traffic Server on the local node or <code>traffic_line -M</code>
+   to restart Traffic Server on all the nodes in a cluster. </li>
 </ol>
-<p>Copyright © 2011 <a href="http://www.apache.org/">The Apache Software Foundation</a>. 
-Licensed under the <a href="http://www.apache.org/licenses/">Apache License</a>, Version 
-2.0. Apache Traffic Server, Apache, the Apache Traffic Server logo, and the 
-Apache feather logo are trademarks of The Apache Software Foundation.</p>
     </div>
   </div><!-- main -->