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 2010/11/24 18:52:04 UTC
svn commit: r779674 -
/websites/staging/trafficserver/trunk/content/docs/trunk/admin/files.en.html
Author: buildbot
Date: Wed Nov 24 17:52:03 2010
New Revision: 779674
URL: http://svn.apache.org/viewvc?rev=779674&view=rev
Log:
Staging update by buildbot
Modified:
websites/staging/trafficserver/trunk/content/docs/trunk/admin/files.en.html
Modified: websites/staging/trafficserver/trunk/content/docs/trunk/admin/files.en.html
URL: http://svn.apache.org/viewvc/websites/staging/trafficserver/trunk/content/docs/trunk/admin/files.en.html?rev=779674&r1=779673&r2=779674&view=diff
==============================================================================
--- websites/staging/trafficserver/trunk/content/docs/trunk/admin/files.en.html (original)
+++ websites/staging/trafficserver/trunk/content/docs/trunk/admin/files.en.html Wed Nov 24 17:52:03 2010
@@ -982,7 +982,7 @@ and all comments.</p>
<dd>Enables or disables log file rolling for the <code>LogObject</code>. This</dd>
</dl>
<p>setting overrides the value for the
- <em><code>proxy.config.log2.rolling_enabled</code></em> variable in the
+ <em><code>proxy.config.log.rolling_enabled</code></em> variable in the
<code>records.config</code> file. Set <em><code>truth value</code></em> to one of the
following values:</p>
<p><code>0</code> to disable rolling for this particular <code>LogObject</code>. <br />
@@ -1003,7 +1003,7 @@ and all comments.</p>
<p>you to specify different rolling intervals for different
<code>LogObjects</code>.
This setting overrides the value for
- <em><code>proxy.config.log2.rolling_interval_sec</code></em> in the
+ <em><code>proxy.config.log.rolling_interval_sec</code></em> in the
<code>records.config</code> file.</p>
<dl>
<dt><code><RollingOffsetHr = "hour"/></code></dt>
@@ -1013,7 +1013,7 @@ and all comments.</p>
produced only at that time. The impact of this setting is only
noticeable if the rolling interval is larger than one hour.
This setting overrides the configuration setting
- for <em><code>proxy.config.log2.rolling_offset_hr</code></em> in the
+ for <em><code>proxy.config.log.rolling_offset_hr</code></em> in the
<code>records.config</code> file.</p>
<dl>
<dt><code><RollingSizeMb = "size_in_MB"/></code></dt>
@@ -2381,7 +2381,7 @@ T=SERVER_PORT_BLIND_TUNNEL</p>
available.</p>
<p><strong>Logging Config</strong></p>
<dl>
-<dt><em><code>proxy.config.log2.logging_enabled</code></em></dt>
+<dt><em><code>proxy.config.log.logging_enabled</code></em></dt>
<dd><code>INT</code></dd>
<dd><code>3</code></dd>
<dd>Enables and disables event logging:</dd>
@@ -2392,43 +2392,43 @@ T=SERVER_PORT_BLIND_TUNNEL</p>
<code>3</code> = full logging (errors + transactions)</p>
<p>Refer to <a href="log">Working with Log Files</a>.</p>
<dl>
-<dt><em><code>proxy.config.log2.max_secs_per_buffer</code></em></dt>
+<dt><em><code>proxy.config.log.max_secs_per_buffer</code></em></dt>
<dd><code>INT</code></dd>
<dd><code>5</code></dd>
<dd>The maximum amount of time before data in the buffer is flushed to</dd>
</dl>
<p>disk.</p>
<dl>
-<dt><em><code>proxy.config.log2.max_space_mb_for_logs</code></em></dt>
+<dt><em><code>proxy.config.log.max_space_mb_for_logs</code></em></dt>
<dd><code>INT</code></dd>
<dd><code>2000</code></dd>
<dd>The amount of space allocated to the logging directory (in MB).</dd>
-<dt><em><code>proxy.config.log2.max_space_mb_for_orphan_logs</code></em></dt>
+<dt><em><code>proxy.config.log.max_space_mb_for_orphan_logs</code></em></dt>
<dd><code>INT</code></dd>
<dd><code>25</code></dd>
<dd>The amount of space allocated to the logging directory (in MB) if</dd>
</dl>
<p>this node is acting as a collation client.</p>
<dl>
-<dt><em><code>proxy.config.log2.max_space_mb_headroom</code></em></dt>
+<dt><em><code>proxy.config.log.max_space_mb_headroom</code></em></dt>
<dd><code>INT</code></dd>
<dd><code>10</code></dd>
<dd>The tolerance for the log space limit (in bytes).</dd>
</dl>
-<p>If the variable <em><code>proxy.config.log2.auto_delete_rolled_file</code></em>
+<p>If the variable <em><code>proxy.config.log.auto_delete_rolled_file</code></em>
is set to <code>1</code> (enabled), then autodeletion of log files is
triggered when the amount of free space available in the logging
directory is less than the value specified here.</p>
<dl>
-<dt><em><code>proxy.config.log2.hostname</code></em></dt>
+<dt><em><code>proxy.config.log.hostname</code></em></dt>
<dd><code>STRING</code></dd>
<dd><code>localhost</code></dd>
<dd>The hostname of the machine running Traffic Server.</dd>
-<dt><em><code>proxy.config.log2.logfile_dir</code></em></dt>
+<dt><em><code>proxy.config.log.logfile_dir</code></em></dt>
<dd><code>STRING</code></dd>
<dd><code>install_dir /logs</code></dd>
<dd>The full path to the logging directory.</dd>
-<dt><em><code>proxy.config.log2.logfile_perm</code></em></dt>
+<dt><em><code>proxy.config.log.logfile_perm</code></em></dt>
<dd><code>STRING</code></dd>
<dd><code>rw-r--r--</code></dd>
<dd>The log file permissions. The standard UNIX file permissions are</dd>
@@ -2444,11 +2444,11 @@ T=SERVER_PORT_BLIND_TUNNEL</p>
configuration file. Permissions for existing log files are not
changed when the configuration is changed.</p>
<dl>
-<dt><em><code>proxy.config.log2.custom_logs_enabled</code></em></dt>
+<dt><em><code>proxy.config.log.custom_logs_enabled</code></em></dt>
<dd><code>INT</code></dd>
<dd><code>0</code></dd>
<dd>Enables (<code>1</code>) or disables (<code>0</code>) custom logging.</dd>
-<dt><em><code>proxy.config.log2.xml_logs_config</code></em></dt>
+<dt><em><code>proxy.config.log.xml_logs_config</code></em></dt>
<dd><code>INT</code></dd>
<dd><code>1</code></dd>
<dd>Enables (<code>1</code>) or disables (<code>0</code>) extended custom logging using an</dd>
@@ -2460,11 +2460,11 @@ T=SERVER_PORT_BLIND_TUNNEL</p>
logging, you should use the more versatile XML-based custom
formats.</p>
<dl>
-<dt><em><code>proxy.config.log2.squid_log_enabled</code></em></dt>
+<dt><em><code>proxy.config.log.squid_log_enabled</code></em></dt>
<dd><code>INT</code></dd>
<dd><code>1</code></dd>
<dd>Enables (<code>1</code>) or disables (<code>0</code>) the squid log file format.</dd>
-<dt><em><code>proxy.config.log2.squid_log_is_ascii</code></em></dt>
+<dt><em><code>proxy.config.log.squid_log_is_ascii</code></em></dt>
<dd><code>INT</code></dd>
<dd><code>1</code></dd>
<dd>The squid log file type:</dd>
@@ -2472,22 +2472,22 @@ T=SERVER_PORT_BLIND_TUNNEL</p>
<p><code>1</code> = ASCII<br />
<code>0</code> = binary</p>
<dl>
-<dt><em><code>proxy.config.log2.squid_log_name</code></em></dt>
+<dt><em><code>proxy.config.log.squid_log_name</code></em></dt>
<dd><code>STRING</code></dd>
<dd><code>squid</code></dd>
<dd>The squid log filename.</dd>
-<dt><em><code>proxy.config.log2.squid_log_header</code></em></dt>
+<dt><em><code>proxy.config.log.squid_log_header</code></em></dt>
<dd><code>STRING</code></dd>
<dd><code>NULL</code></dd>
<dd>The squid log file header text.</dd>
-<dt><em><code>proxy.config.log2.common_log_enabled</code></em></dt>
+<dt><em><code>proxy.config.log.common_log_enabled</code></em></dt>
<dd><code>INT</code></dd>
<dd><code>0</code></dd>
<dd>Enables (<code>1</code>) or disables (<code>0</code>) the Netscape common log file</dd>
</dl>
<p>format.</p>
<dl>
-<dt><em><code>proxy.config.log2.common_log_is_ascii</code></em></dt>
+<dt><em><code>proxy.config.log.common_log_is_ascii</code></em></dt>
<dd><code>INT</code></dd>
<dd><code>1</code></dd>
<dd>The Netscape common log file type:</dd>
@@ -2495,22 +2495,22 @@ T=SERVER_PORT_BLIND_TUNNEL</p>
<p><code>1</code> = ASCII <br />
<code>0</code> = binary</p>
<dl>
-<dt><em><code>proxy.config.log2.common_log_name</code></em></dt>
+<dt><em><code>proxy.config.log.common_log_name</code></em></dt>
<dd><code>STRING</code></dd>
<dd><code>common</code></dd>
<dd>The Netscape common log filename.</dd>
-<dt><em><code>proxy.config.log2.common_log_header</code></em></dt>
+<dt><em><code>proxy.config.log.common_log_header</code></em></dt>
<dd><code>STRING</code></dd>
<dd><code>NULL</code></dd>
<dd>The Netscape common log file header text.</dd>
-<dt><em><code>proxy.config.log2.extended_log_enabled</code></em></dt>
+<dt><em><code>proxy.config.log.extended_log_enabled</code></em></dt>
<dd><code>INT</code></dd>
<dd><code>0</code></dd>
<dd>Enables (<code>1</code>) or disables (<code>0</code>) the Netscape extended log file</dd>
</dl>
<p>format.</p>
<dl>
-<dt><em><code>proxy.confg.log2.extended_log_is_ascii</code></em></dt>
+<dt><em><code>proxy.confg.log.extended_log_is_ascii</code></em></dt>
<dd><code>INT</code></dd>
<dd><code>1</code></dd>
<dd>The Netscape extended log file type:</dd>
@@ -2518,22 +2518,22 @@ T=SERVER_PORT_BLIND_TUNNEL</p>
<p><code>1</code> = ASCII <br />
<code>0</code> = binary</p>
<dl>
-<dt><em><code>proxy.config.log2.extended_log_name</code></em></dt>
+<dt><em><code>proxy.config.log.extended_log_name</code></em></dt>
<dd><code>STRING</code></dd>
<dd><code>extended</code></dd>
<dd>The Netscape extended log filename.</dd>
-<dt><em><code>proxy.config.log2.extended_log_header</code></em></dt>
+<dt><em><code>proxy.config.log.extended_log_header</code></em></dt>
<dd><code>STRING</code></dd>
<dd><code>NULL</code></dd>
<dd>The Netscape extended log file header text.</dd>
-<dt><em><code>proxy.config.log2.extended2_log_enabled</code></em></dt>
+<dt><em><code>proxy.config.log.extended2_log_enabled</code></em></dt>
<dd><code>INT</code></dd>
<dd><code>0</code></dd>
<dd>Enables (<code>1</code>) or disables (<code>0</code>) the Netscape Extended-2 log file</dd>
</dl>
<p>format.</p>
<dl>
-<dt><em><code>proxy.config.log2.extended2_log_is_ascii</code></em></dt>
+<dt><em><code>proxy.config.log.extended2_log_is_ascii</code></em></dt>
<dd><code>INT</code></dd>
<dd><code>1</code></dd>
<dd>The Netscape Extended-2 log file type:</dd>
@@ -2541,22 +2541,22 @@ T=SERVER_PORT_BLIND_TUNNEL</p>
<p><code>1</code> = ASCII <br />
<code>0</code> = binary</p>
<dl>
-<dt><em><code>proxy.config.log2.extended2_log_name</code></em></dt>
+<dt><em><code>proxy.config.log.extended2_log_name</code></em></dt>
<dd><code>STRING</code></dd>
<dd><code>extended2</code></dd>
<dd>The Netscape Extended-2 log filename.</dd>
-<dt><em><code>proxy.config.log2.extended2_log_header</code></em></dt>
+<dt><em><code>proxy.config.log.extended2_log_header</code></em></dt>
<dd><code>STRING</code></dd>
<dd><code>NULL</code></dd>
<dd>The Netscape Extended-2 log file header text.</dd>
-<dt><em><code>proxy.config.log2.separate_icp_logs</code></em></dt>
+<dt><em><code>proxy.config.log.separate_icp_logs</code></em></dt>
<dd><code>INT</code></dd>
<dd><code>0</code></dd>
<dd>When enabled (<code>1</code>), configures Traffic Server to store ICP</dd>
</dl>
<p>transactions in a separate log file.</p>
<dl>
-<dt><em><code>proxy.config.log2.separate_host_logs</code></em></dt>
+<dt><em><code>proxy.config.log.separate_host_logs</code></em></dt>
<dd><code>INT</code></dd>
<dd><code>0</code></dd>
<dd>When enabled (<code>1</code>), configures Traffic Server to create a separate</dd>
@@ -2565,7 +2565,7 @@ T=SERVER_PORT_BLIND_TUNNEL</p>
<code>log_hosts.config</code> file.</p>
<p>Refer to <a href="log#HTTPHostLogSplitting">HTTP Host Log Splitting</a>.</p>
<dl>
-<dt><em><code>proxy.local.log2.collation_mode</code></em></dt>
+<dt><em><code>proxy.local.log.collation_mode</code></em></dt>
<dd><code>INT</code></dd>
<dd><code>0</code></dd>
<dd>The log collation mode:</dd>
@@ -2586,25 +2586,25 @@ T=SERVER_PORT_BLIND_TUNNEL</p>
logging, you should use the more versatile XML-based custom
formats.</p>
<dl>
-<dt><em><code>proxy.confg.log2.collation_host</code></em></dt>
+<dt><em><code>proxy.confg.log.collation_host</code></em></dt>
<dd><code>STRING</code></dd>
<dd><code>NULL</code></dd>
<dd>The hostname of the log collation server.</dd>
-<dt><em><code>proxy.config.log2.collation_port</code></em></dt>
+<dt><em><code>proxy.config.log.collation_port</code></em></dt>
<dd><code>INT</code></dd>
<dd><code>8085</code></dd>
<dd>The port used for communication between the collation server and</dd>
</dl>
<p>client.</p>
<dl>
-<dt><em><code>proxy.config.log2.collation_secret</code></em></dt>
+<dt><em><code>proxy.config.log.collation_secret</code></em></dt>
<dd><code>STRING</code></dd>
<dd><code>foobar</code></dd>
<dd>The password used to validate logging data and prevent the exchange</dd>
</dl>
<p>of unauthorized information when a collation server is being used.</p>
<dl>
-<dt><em><code>proxy.config.log2.collation_host_tagged</code></em></dt>
+<dt><em><code>proxy.config.log.collation_host_tagged</code></em></dt>
<dd><code>INT</code></dd>
<dd><code>0</code></dd>
<dd>When enabled (<code>1</code>), configures Traffic Server to include the</dd>
@@ -2612,11 +2612,11 @@ T=SERVER_PORT_BLIND_TUNNEL</p>
<p>hostname of the collation client that generated the log entry in
each entry.</p>
<dl>
-<dt><em><code>proxy.config.log2.collation_retry_sec</code></em></dt>
+<dt><em><code>proxy.config.log.collation_retry_sec</code></em></dt>
<dd><code>INT</code></dd>
<dd><code>5</code></dd>
<dd>The number of seconds between collation server connection retries.</dd>
-<dt><em><code>proxy.config.log2.rolling_enabled</code></em></dt>
+<dt><em><code>proxy.config.log.rolling_enabled</code></em></dt>
<dd><code>INT</code></dd>
<dd><code>1</code></dd>
<dd>Specifies how log files are rolled. You can specify the following</dd>
@@ -2624,10 +2624,10 @@ T=SERVER_PORT_BLIND_TUNNEL</p>
<p>values:</p>
<p><code>0</code> = disables log file rolling</p>
<p><code>1</code> = enables log file rolling at specific intervals during the day
- (specified with the <em><code>proxy.config.log2.rolling_interval_sec</code></em>
- and <em><code>proxy.config.log2.rolling_offset_hr</code></em> variables)</p>
+ (specified with the <em><code>proxy.config.log.rolling_interval_sec</code></em>
+ and <em><code>proxy.config.log.rolling_offset_hr</code></em> variables)</p>
<p><code>2</code> = enables log file rolling when log files reach a specific size
- (specified with the <em><code>proxy.config.log2.rolling_size_mb</code></em>
+ (specified with the <em><code>proxy.config.log.rolling_size_mb</code></em>
variable)</p>
<p><code>3</code> = enables log file rolling at specific intervals during the day
or when log files reach a specific size (whichever occurs first)</p>
@@ -2635,32 +2635,32 @@ T=SERVER_PORT_BLIND_TUNNEL</p>
when log files reach a specific size (i.e., at a specified time if
the file is of the specified size)</p>
<dl>
-<dt><em><code>proxy.config.log2.rolling_interval_sec</code></em></dt>
+<dt><em><code>proxy.config.log.rolling_interval_sec</code></em></dt>
<dd><code>INT</code></dd>
<dd><code>86400</code></dd>
<dd>The log file rolling interval, in seconds. The minimum value is</dd>
</dl>
<p><code>300</code> (5 minutes). The maximum value is 86400 seconds (one day).</p>
<dl>
-<dt><em><code>proxy.config.log2.rolling_offset_hr</code></em></dt>
+<dt><em><code>proxy.config.log.rolling_offset_hr</code></em></dt>
<dd><code>INT</code></dd>
<dd><code>0</code></dd>
<dd>The file rolling offset hour. The hour of the day that starts the</dd>
</dl>
<p>log rolling period.</p>
<dl>
-<dt><em><code>proxy.config.log2.rolling_size_mb</code></em></dt>
+<dt><em><code>proxy.config.log.rolling_size_mb</code></em></dt>
<dd><code>INT</code></dd>
<dd><code>10</code></dd>
<dd>The size that log files must reach before rolling takes place.</dd>
-<dt><em><code>proxy.config.log2.auto_delete_rolled_files</code></em></dt>
+<dt><em><code>proxy.config.log.auto_delete_rolled_files</code></em></dt>
<dd><code>INT</code></dd>
<dd><code>1</code></dd>
<dd>Enables (<code>1</code>) or disables (<code>0</code>) automatic deletion of rolled</dd>
</dl>
<p>files.</p>
<dl>
-<dt><em><code>proxy.config.log2.sampling_frequency</code></em></dt>
+<dt><em><code>proxy.config.log.sampling_frequency</code></em></dt>
<dd><code>INT</code></dd>
<dd><code>1</code></dd>
<dd>Configures Traffic Server to log only a sample of transactions</dd>