(trafficserver) branch docheaderrewriteprcreflag deleted (was 78f9299f16)
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a change to branch docheaderrewriteprcreflag in repository https://gitbox.apache.org/repos/asf/trafficserver.git was 78f9299f16 Docs: header rewrite regex has case insensitive pcre flag The revisions that were on this branch are still contained in other references; therefore, this change does not discard any commits from the repository.
(trafficserver) branch master updated (2184c7af36 -> 265ebcad3d)
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a change to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git from 2184c7af36 Adds 10.0.x to the list of docs version (#11146) add 265ebcad3d Docs: header rewrite regex has case insensitive pcre flag (#11148) No new revisions were added by this update. Summary of changes: doc/admin-guide/plugins/header_rewrite.en.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-)
(trafficserver) 01/01: Docs: header rewrite regex has case insensitive pcre flag
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch docheaderrewriteprcreflag in repository https://gitbox.apache.org/repos/asf/trafficserver.git commit 78f9299f16345db963f1426f2cb43bcf6991c20f Author: mlibbey AuthorDate: Thu Mar 7 16:45:02 2024 -0800 Docs: header rewrite regex has case insensitive pcre flag The header rewrite plugin's regex syntax can take pcre flags. The case insensitive flag appears to be the only relevant one to headers. --- doc/admin-guide/plugins/header_rewrite.en.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/doc/admin-guide/plugins/header_rewrite.en.rst b/doc/admin-guide/plugins/header_rewrite.en.rst index c45f14c536..763d428900 100644 --- a/doc/admin-guide/plugins/header_rewrite.en.rst +++ b/doc/admin-guide/plugins/header_rewrite.en.rst @@ -576,7 +576,8 @@ types supported: Operand Description === === /regex/ Matches the condition's provided value against the regular -expression. +expression. Start the regex with (?i) to flag it for a case +insensitive match, e.g. /(?i)regex/ will match ReGeX. string Matches if the value from the condition is lexically greater than
(trafficserver) branch docheaderrewriteprcreflag created (now 78f9299f16)
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a change to branch docheaderrewriteprcreflag in repository https://gitbox.apache.org/repos/asf/trafficserver.git at 78f9299f16 Docs: header rewrite regex has case insensitive pcre flag This branch includes the following new commits: new 78f9299f16 Docs: header rewrite regex has case insensitive pcre flag The 1 revisions listed above as "new" are entirely new to this repository and will be described in separate emails. The revisions listed as "add" were already present in the repository and have only been added to this reference.
[trafficserver] branch master updated (c331c7205c -> fa44888e1a)
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a change to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git from c331c7205c Add BRAVO Reader-Writer Lock (#9394) add fa44888e1a Doc: Clarify that connect ports can have multiple values (#9713) No new revisions were added by this update. Summary of changes: doc/admin-guide/files/records.yaml.en.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-)
[trafficserver] branch master updated (d6c55bdf8 -> e3c5a9410)
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a change to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git from d6c55bdf8 swoc: Change IpMap to IPSpace for IP address based redirect actions. (#9539) add e3c5a9410 Docs: format typos in header_rewrite doc (#9544) No new revisions were added by this update. Summary of changes: doc/admin-guide/plugins/header_rewrite.en.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-)
[trafficserver] 01/01: Docs: format typos in header_rewrite doc
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch mlibbey-hdrwrtnote in repository https://gitbox.apache.org/repos/asf/trafficserver.git commit 0da7fabfb35fc8cc49dbf1cea6d975d31ef930fe Author: mlibbey AuthorDate: Mon Mar 20 16:06:52 2023 -0700 Docs: format typos in header_rewrite doc Looks like a few git diff characters got included by mistake. --- doc/admin-guide/plugins/header_rewrite.en.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/doc/admin-guide/plugins/header_rewrite.en.rst b/doc/admin-guide/plugins/header_rewrite.en.rst index c84a44ec1..eae64d945 100644 --- a/doc/admin-guide/plugins/header_rewrite.en.rst +++ b/doc/admin-guide/plugins/header_rewrite.en.rst @@ -719,8 +719,8 @@ the appropriate logs even when the debug tag has not been enabled. For additional information on |TS| debugging statements, refer to :ref:`developer-debug-tags` in the developer's documentation. -+**Note**: This operator is deprecated, use the ``set-http-cntl`` operator instead, -+with the ``TXN_DEBUG`` control. +**Note**: This operator is deprecated, use the ``set-http-cntl`` operator instead, +with the ``TXN_DEBUG`` control. set-destination ~~~ @@ -827,7 +827,7 @@ if necessary. set-http-cntl ~ -;; +:: set-http-cntl
[trafficserver] branch mlibbey-hdrwrtnote created (now 0da7fabfb)
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a change to branch mlibbey-hdrwrtnote in repository https://gitbox.apache.org/repos/asf/trafficserver.git at 0da7fabfb Docs: format typos in header_rewrite doc This branch includes the following new commits: new 0da7fabfb Docs: format typos in header_rewrite doc The 1 revisions listed above as "new" are entirely new to this repository and will be described in separate emails. The revisions listed as "add" were already present in the repository and have only been added to this reference.
[trafficserver] branch master updated: Update doc max size reloadable/overridable flags (#9082)
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new be7583f8e Update doc max size reloadable/overridable flags (#9082) be7583f8e is described below commit be7583f8ef7596addd6abd9309d6e855f9109b25 Author: mlibbey AuthorDate: Fri Sep 16 12:40:11 2022 -0700 Update doc max size reloadable/overridable flags (#9082) Adding missing flags $ traffic_ctl -V Apache Traffic Server - traffic_ctl - 9.0.3 $ for i in $(traffic_ctl config match size | awk -F":" '/max_size/{print $1}'); do traffic_ctl config describe $i; echo; done Name: proxy.config.http.request_line_max_size Current Value : 65535 Default Value : 65535 Record Type : standard config Data Type : INT Access Control : default Update Type : dynamic, no restart Update Status : 0 Source : built in default Overridable : no Syntax Check: none Version : 0 Order : 272 Raw Stat Block : 0 Name: proxy.config.http.header_field_max_size Current Value : 131070 Default Value : 131070 Record Type : standard config Data Type : INT Access Control : default Update Type : dynamic, no restart Update Status : 0 Source : built in default Overridable : no Syntax Check: none Version : 0 Order : 273 Raw Stat Block : 0 Name: proxy.config.http.request_header_max_size Current Value : 131072 Default Value : 131072 Record Type : standard config Data Type : INT Access Control : default Update Type : dynamic, no restart Update Status : 0 Source : built in default Overridable : yes int Syntax Check: none Version : 0 Order : 274 Raw Stat Block : 0 Name: proxy.config.http.response_header_max_size Current Value : 131072 Default Value : 131072 Record Type : standard config Data Type : INT Access Control : default Update Type : dynamic, no restart Update Status : 0 Source : built in default Overridable : yes int Syntax Check: none Version : 0 Order : 275 Raw Stat Block : 0 Name: proxy.config.body_factory.response_max_size Current Value : 8192 Default Value : 8192 Record Type : standard config Data Type : INT Access Control : default Update Type : dynamic, no restart Update Status : 0 Source : built in default Overridable : no Syntax Check: none Version : 0 Order : 294 Raw Stat Block : 0 Name: proxy.config.cache.alt_rewrite_max_size Current Value : 4096 Default Value : 4096 Record Type : standard config Data Type : INT Access Control : default Update Type : dynamic, no restart Update Status : 0 Source : built in default Overridable : no Syntax Check: none Version : 0 Order : 350 Raw Stat Block : 0 Name: proxy.config.hostdb.max_size Current Value : 10485760 Default Value : 10485760 Record Type : standard config Data Type : INT Access Control : default Update Type : static, restart traffic_server Update Status : 0 Source : built in default Overridable : no Syntax Check: none Version : 0 Order : 368 Raw Stat Block : 0 --- doc/admin-guide/files/records.config.en.rst | 7 +++ 1 file changed, 7 insertions(+) diff --git a/doc/admin-guide/files/records.config.en.rst b/doc/admin-guide/files/records.config.en.rst index c3dccaca7..e7050feb3 100644 --- a/doc/admin-guide/files/records.config.en.rst +++ b/doc/admin-guide/files/records.config.en.rst @@ -1218,6 +1218,7 @@ mptcp size allowed, otherwise, the post would fail. .. ts:cv:: CONFIG proxy.config.http.request_line_max_size INT 65535 + :reloadable: Controls the maximum size, in bytes, of an HTTP Request Line in requests. Requests with a request line exceeding this size will be treated as invalid and @@ -1226,18 +1227,23 @@ mptcp URI in which case the request line may also include the request scheme and domain name. .. ts:cv:: CONFIG proxy.config.http.header_field_max_size INT 131070 + :reloadable: Controls the maximum size, in bytes, of an HTTP header field in requests. Headers in a request with the sum of their name and value that exceed this size will cause the enti
[trafficserver] branch master updated (81fe416 -> 3dd78a7)
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a change to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git. from 81fe416 Cleanup: Remove old SDKTest for thread_pool example plugin (#8596) add 3dd78a7 Docs: Slack instead of irc (#8599) No new revisions were added by this update. Summary of changes: doc/preface/index.en.rst | 11 +++ 1 file changed, 3 insertions(+), 8 deletions(-)
[trafficserver] branch master updated (af6eec7 -> 3538b5f)
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a change to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git. from af6eec7 Make it slightly harder to dump private keys to logs (#8029) add 3538b5f Docs: Fix pre-formatting for ratelimit plugin (#7986) No new revisions were added by this update. Summary of changes: doc/admin-guide/plugins/rate_limit.en.rst | 9 - 1 file changed, 4 insertions(+), 5 deletions(-)
[trafficserver] branch master updated (d455509 -> aa0ce63)
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a change to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git. from d455509 Fix typo in configure.ac (#7993) add aa0ce63 Doc: Now's Minute invocation error (#7990) No new revisions were added by this update. Summary of changes: doc/admin-guide/plugins/header_rewrite.en.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)
[trafficserver] branch master updated (c1ed4a4 -> 4b8a3b9)
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a change to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git. from c1ed4a4 fix DNS spike issue for TCP_RETRY mode (#7307) add 4b8a3b9 Doc: tcpinfo plugin table formatting (#7805) No new revisions were added by this update. Summary of changes: doc/admin-guide/plugins/tcpinfo.en.rst | 2 ++ 1 file changed, 2 insertions(+)
[trafficserver] branch master updated (8ac0019 -> 22cd7da)
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a change to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git. from 8ac0019 Experimental Cache fill plugin (#7470) add 22cd7da doc: header_rewrite random function not inclusive (#7760) No new revisions were added by this update. Summary of changes: doc/admin-guide/plugins/header_rewrite.en.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)
[trafficserver] branch master updated: Add note to background fetch about include/exclude (#7343)
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new 2c9d4c7 Add note to background fetch about include/exclude (#7343) 2c9d4c7 is described below commit 2c9d4c753aa5b946acc7876618f611dfd53203f1 Author: mlibbey AuthorDate: Thu Nov 26 12:17:50 2020 -0800 Add note to background fetch about include/exclude (#7343) The include configuraton directive for background fetch is a bit confusing, in that it requires a corresponding exclude directive. That is, its used as an exemption mechanism to an exclude directive. --- doc/admin-guide/plugins/background_fetch.en.rst | 10 ++ 1 file changed, 10 insertions(+) diff --git a/doc/admin-guide/plugins/background_fetch.en.rst b/doc/admin-guide/plugins/background_fetch.en.rst index 1e2f511..8f28a7e 100644 --- a/doc/admin-guide/plugins/background_fetch.en.rst +++ b/doc/admin-guide/plugins/background_fetch.en.rst @@ -74,6 +74,16 @@ The contents of the config-file could be as below:: exclude X-Foo-Bar text exclude Content-Length <1000 +.. important:: + + The ``include`` configuration directive is only used when there is a corresponding ``exclude`` to exempt. + For example, a single line directive, ``include Host example.com`` would not make the plugin + *only* act on example.com. To acheive classic allow (only) lists, one would need to have a broad + exclude line, such as:: + + exclude Host * + include Host example.com + The plugin also now supports per remap activation. To activate the plugin for a given remap, add the below on the remap line::
[trafficserver] branch master updated (4166151 -> b670607)
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a change to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git. from 4166151 Format config_describe output logs. Pretty format using BufferWritter add b670607 Document the order of the X-Cache header No new revisions were added by this update. Summary of changes: doc/admin-guide/plugins/xdebug.en.rst | 6 +- 1 file changed, 5 insertions(+), 1 deletion(-)
[trafficserver] branch master updated: Add compressible content-types example and 1Kb min
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new 72c18f6 Add compressible content-types example and 1Kb min 72c18f6 is described below commit 72c18f641f3641c8eb67ae79da6bd3e32ab5146b Author: Miles Libbey AuthorDate: Tue Jan 28 18:04:59 2020 -0700 Add compressible content-types example and 1Kb min --- doc/admin-guide/plugins/compress.en.rst | 21 + 1 file changed, 21 insertions(+) diff --git a/doc/admin-guide/plugins/compress.en.rst b/doc/admin-guide/plugins/compress.en.rst index a355d33..41cf6a6 100644 --- a/doc/admin-guide/plugins/compress.en.rst +++ b/doc/admin-guide/plugins/compress.en.rst @@ -76,6 +76,8 @@ With no further options, this will enable the following default behavior: * Disable flush (flush compressed content to client). +* Only objects greater than 1Kb will be compressed + Alternatively, a configuration may be specified (shown here using the sample configuration provided with the plugin's source):: @@ -216,6 +218,25 @@ might create a configuration with the following options:: [bar.example.com] enabled false + # A reasonable list of content-types that are compressible + compressible-content-type text/* + compressible-content-type *font* + compressible-content-type *javascript + compressible-content-type *json + compressible-content-type *ml;* + compressible-content-type *mpegURL + compressible-content-type *mpegurl + compressible-content-type *otf + compressible-content-type *ttf + compressible-content-type *type + compressible-content-type *xml + compressible-content-type application/eot + compressible-content-type application/pkix-crl + compressible-content-type application/x-httpd-cgi + compressible-content-type application/x-perl + compressible-content-type image/vnd.microsoft.icon + compressible-content-type image/x-icon + Assuming the above options are in a file at ``/etc/trafficserver/compress.config`` the plugin would be enabled for |TS| in :file:`plugin.config` as::
[trafficserver] branch master updated: Fix rst errors for collapsed forwarding plugin
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new 8872c1d Fix rst errors for collapsed forwarding plugin 8872c1d is described below commit 8872c1d48ffd696c98e701e5c9dc71b9c8d180f2 Author: Miles Libbey AuthorDate: Sun Dec 29 10:54:22 2019 -0800 Fix rst errors for collapsed forwarding plugin - The table of configs was printing the rst reference tags - the link to the thundering herd section wasn't a link - the hard coded anchor link is better as a reference that stays with the docs. --- doc/admin-guide/plugins/collapsed_forwarding.en.rst | 20 +--- 1 file changed, 9 insertions(+), 11 deletions(-) diff --git a/doc/admin-guide/plugins/collapsed_forwarding.en.rst b/doc/admin-guide/plugins/collapsed_forwarding.en.rst index f479da3..eccc678 100644 --- a/doc/admin-guide/plugins/collapsed_forwarding.en.rst +++ b/doc/admin-guide/plugins/collapsed_forwarding.en.rst @@ -79,14 +79,14 @@ on the error by using an internal redirect follow back to itself, essentially blocking the request until a response arrives, at which point, relies on read-while-writer feature to start downloading the object to all waiting clients. The following config parameters are assumed to be set for this -plugin to work:: +plugin to work: -:ts:cv:`proxy.config.http.cache.open_write_fail_action`1 -:ts:cv:`proxy.config.cache.enable_read_while_writer` 1 -:ts:cv:`proxy.config.http.number_of_redirections` 10 -:ts:cv:`proxy.config.http.redirect_use_orig_cache_key` 1 -:ts:cv:`proxy.config.http.background_fill_active_timeout` 0 -:ts:cv:`proxy.config.http.background_fill_completed_threshold` 0 +- :ts:cv:`proxy.config.http.cache.open_write_fail_action```1`` +- :ts:cv:`proxy.config.cache.enable_read_while_writer` ``1`` +- :ts:cv:`proxy.config.http.number_of_redirections` ``10`` +- :ts:cv:`proxy.config.http.redirect_use_orig_cache_key` ``1`` +- :ts:cv:`proxy.config.http.background_fill_active_timeout` ``0`` +- :ts:cv:`proxy.config.http.background_fill_completed_threshold` ``0`` Additionally, given that collapsed forwarding works based on cache write lock failure detection, the plugin requires cache to be enabled and ready. @@ -119,7 +119,7 @@ For a large scale Video Streaming scenario, there’s a combination of a large number of revalidations (e.g. media playlists) and cache misses (e.g. media segments) that occur for the same file. Traffic Server’s RWW works great in collapsing the concurrent requests in such a scenario, -however, as described in ``_admin-configuration-reducing-origin-requests``, +however, as described in :ref:`admin-configuration-reducing-origin-requests`, Traffic Server’s implementation of RWW has a significant limitation, which restricts its ability to invoke RWW only when the response headers are already received. This means that any number of concurrent requests for @@ -185,6 +185,4 @@ retries, allowing to be able to initiate RWW, whenever the response headers are received for the request that was allowed to go to the Origin. -More details are available at - -https://docs.trafficserver.apache.org/en/6.0.x/admin/http-proxy-caching.en.html#reducing-origin-server-requests-avoiding-the-thundering-herd +More details are available at :ref:`admin-configuration-reducing-origin-requests` \ No newline at end of file
[trafficserver] branch master updated: Add links to RWW sections
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new 64bc016 Add links to RWW sections 64bc016 is described below commit 64bc0169bb02fa31978e077e7424127c5850e0fa Author: Miles Libbey AuthorDate: Sun Dec 29 11:59:44 2019 -0800 Add links to RWW sections --- doc/admin-guide/files/records.config.en.rst | 8 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/doc/admin-guide/files/records.config.en.rst b/doc/admin-guide/files/records.config.en.rst index 0153ecf..dca6414 100644 --- a/doc/admin-guide/files/records.config.en.rst +++ b/doc/admin-guide/files/records.config.en.rst @@ -2329,11 +2329,11 @@ Dynamic Content & Content Negotiation origin server. ``4`` Return a ``502`` error on either a cache miss or on a revalidation. ``5`` Retry Cache Read on a Cache Write Lock failure. This option together - with `proxy.config.cache.enable_read_while_writer` configuration + with :ts:cv:`proxy.config.cache.enable_read_while_writer` configuration allows to collapse concurrent requests without a need for any plugin. - Make sure to configure Read While Writer feature correctly following - the docs in Cache Basics section. Note that this option may result in - CACHE_LOOKUP_COMPLETE HOOK being called back more than once. + Make sure to configure the :ref:`admin-config-read-while-writer` feature + correctly. Note that this option may result in CACHE_LOOKUP_COMPLETE HOOK + being called back more than once. = == Customizable User Response Pages
[trafficserver] branch master updated (e712c08 -> 8dbe6e0)
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a change to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git. from e712c08 Fix out of bound array access in ssl_session_reuse plugin (#6235) add 8dbe6e0 Remove never implemented regex descriptions No new revisions were added by this update. Summary of changes: doc/admin-guide/plugins/header_rewrite.en.rst | 18 -- 1 file changed, 18 deletions(-)
[trafficserver] branch master updated (5936dcd -> 2888052)
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a change to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git. from 5936dcd Ignore MgmtMessageHdr if ProcessManager is not running add 2888052 Clarify relation of nameservers and resolv.conf No new revisions were added by this update. Summary of changes: doc/admin-guide/files/records.config.en.rst | 8 ++-- 1 file changed, 6 insertions(+), 2 deletions(-)
[trafficserver] branch master updated (dc0fb99 -> 9b1511b)
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a change to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git. from dc0fb99 Cleanup: VIO add 9b1511b Substitution string has changed No new revisions were added by this update. Summary of changes: doc/admin-guide/plugins/regex_remap.en.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)
[trafficserver] branch master updated: Explain how SRV origin selection works
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new 101c79b Explain how SRV origin selection works 101c79b is described below commit 101c79b10a7ce81c250d7489fcdaa12aef7169db Author: Miles Libbey AuthorDate: Mon Aug 19 14:36:11 2019 -0700 Explain how SRV origin selection works --- doc/admin-guide/files/records.config.en.rst | 9 - 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/doc/admin-guide/files/records.config.en.rst b/doc/admin-guide/files/records.config.en.rst index 0de9158..05bdbd2 100644 --- a/doc/admin-guide/files/records.config.en.rst +++ b/doc/admin-guide/files/records.config.en.rst @@ -2453,7 +2453,14 @@ DNS :reloadable: :overridable: - Indicates whether to use SRV records for origin server lookup. + Enables (``1``) or disables (``0``) the use of SRV records for origin server + lookup. |TS| will use weights found in the SRV record as a weighted round + robin in origin selection. Note that |TS| will lookup + ``_$scheme._$internet_protocol.$origin_name``. For instance, if the origin is + set to ``https://my.example.com``, |TS| would lookup ``_https._tcp.my.example.com``. + Also note that the port returned in the SRV record MUST match the port being + used for the origin (e.g. if the origin scheme is http and a default port, there + should be a SRV record with port 80). .. ts:cv:: CONFIG proxy.config.dns.dedicated_thread INT 0
[trafficserver] branch master updated: Doc: Remove origin KA note from removed setting
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new 4208dd8 Doc: Remove origin KA note from removed setting 4208dd8 is described below commit 4208dd8cfecab7c69860eeef30718007dc5cf4ec Author: Miles Libbey AuthorDate: Wed May 22 10:23:51 2019 -0700 Doc: Remove origin KA note from removed setting This note was originally from the setting ```proxy.config.http.send_http11_requests``` but was incorrectly moved to the chunking setting. Then the http11 setting was killed off. So, this note should have been killed off too. --- doc/admin-guide/files/records.config.en.rst | 6 -- 1 file changed, 6 deletions(-) diff --git a/doc/admin-guide/files/records.config.en.rst b/doc/admin-guide/files/records.config.en.rst index 04bc876..d7dfd6d 100644 --- a/doc/admin-guide/files/records.config.en.rst +++ b/doc/admin-guide/files/records.config.en.rst @@ -845,12 +845,6 @@ mptcp origin server has previously returned HTTP/1.1. = == -.. note:: - - If HTTP/1.1 is used, then |TS| can use keep-alive connections to origin servers. - - If HTTP/1.0 is used, then |TS| can use keep-alive connections to origin servers. - .. ts:cv:: CONFIG proxy.config.http.chunking.size INT 4096 :overridable:
[trafficserver] branch master updated: Doc: add prefetch to plugin index page
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new 5fda043 Doc: add prefetch to plugin index page 5fda043 is described below commit 5fda043ce0c29c8253e43a6d670a287b84554d9d Author: Miles Libbey AuthorDate: Tue Apr 23 09:57:34 2019 +0800 Doc: add prefetch to plugin index page --- doc/admin-guide/plugins/index.en.rst | 3 +++ 1 file changed, 3 insertions(+) diff --git a/doc/admin-guide/plugins/index.en.rst b/doc/admin-guide/plugins/index.en.rst index 91f9c1e..da38b3c 100644 --- a/doc/admin-guide/plugins/index.en.rst +++ b/doc/admin-guide/plugins/index.en.rst @@ -221,6 +221,9 @@ directory of the |TS| source tree. Experimental plugins can be compiled by passi :doc:`MySQL Remap ` Allows dynamic remaps from a MySQL database. +:doc:`Prefetch ` + Pre-fetch objects based on the requested URL path pattern. + :doc:`Remap Purge ` This remap plugin allows the administrator to easily setup remotely controlled ``PURGE`` for the content of an entire remap rule.
[trafficserver] branch master updated: Doc: Add links to Slicer plugin
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new 93961f8 Doc: Add links to Slicer plugin 93961f8 is described below commit 93961f82c6718ec7190b533be0900b27e6045211 Author: Miles Libbey AuthorDate: Tue Apr 23 10:15:41 2019 +0800 Doc: Add links to Slicer plugin --- doc/admin-guide/plugins/index.en.rst | 6 ++ 1 file changed, 6 insertions(+) diff --git a/doc/admin-guide/plugins/index.en.rst b/doc/admin-guide/plugins/index.en.rst index 1df7cad..91f9c1e 100644 --- a/doc/admin-guide/plugins/index.en.rst +++ b/doc/admin-guide/plugins/index.en.rst @@ -161,6 +161,7 @@ directory of the |TS| source tree. Experimental plugins can be compiled by passi Multiplexer MySQL Remap Signed URLs + Slicer SSL Headers SSL Session Reuse System Statistics @@ -227,6 +228,11 @@ directory of the |TS| source tree. Experimental plugins can be compiled by passi :doc:`Signed URLs ` Adds support for verifying URL signatures for incoming requests to either deny or redirect access. +:doc:`Slicer ` + Slice full file or range based requests into deterministic chunks, allowing large files to be + spread across multiple cache stripes. Allows range requests to be satisfied by stitching these + chunks together. + :doc:`SSL Session Reuse ` Coordinates Session ID and ticket based TLS session resumption between a group of ATS machines.
[trafficserver] branch master updated: Doc: Add IPv6 CIDR Mask example
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new 089316d Doc: Add IPv6 CIDR Mask example 089316d is described below commit 089316d6e2926a2bd9c9c4dfd828fe0292bfd7c0 Author: Miles Libbey AuthorDate: Mon Apr 1 13:13:10 2019 -0700 Doc: Add IPv6 CIDR Mask example --- doc/admin-guide/plugins/header_rewrite.en.rst | 2 ++ 1 file changed, 2 insertions(+) diff --git a/doc/admin-guide/plugins/header_rewrite.en.rst b/doc/admin-guide/plugins/header_rewrite.en.rst index 17f3d7f..63df29f 100644 --- a/doc/admin-guide/plugins/header_rewrite.en.rst +++ b/doc/admin-guide/plugins/header_rewrite.en.rst @@ -307,6 +307,8 @@ e.g.:: cond %{CIDR:8} ="8.0.0.0" set-header X-Is-Eight "Yes" +cond %{CIDR:,8} ="fd00::" #note the IPv6 Mask is in the second position +set-header IPv6Internal "true" This condition has no requirements other than access to the Client IP, hence, it should work in any and all hooks.
[trafficserver] branch master updated: Doc: fix copy-paste leftover in ts.stat_find
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new a7d4ca2 Doc: fix copy-paste leftover in ts.stat_find a7d4ca2 is described below commit a7d4ca23ce42fc0ad0084d779601910be21ab597 Author: Emanuele Rocca AuthorDate: Mon Mar 25 10:39:27 2019 +0100 Doc: fix copy-paste leftover in ts.stat_find --- doc/admin-guide/plugins/lua.en.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/admin-guide/plugins/lua.en.rst b/doc/admin-guide/plugins/lua.en.rst index 67fc36c..dd890e3 100644 --- a/doc/admin-guide/plugins/lua.en.rst +++ b/doc/admin-guide/plugins/lua.en.rst @@ -3738,7 +3738,7 @@ Here is an example. ts.stat_find -**syntax:** *val = ts.stat_create(STAT_NAME)* +**syntax:** *val = ts.stat_find(STAT_NAME)* **context:** global
[trafficserver] branch master updated: Doc: open_read_retry_time is overridable
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new 4934fb2 Doc: open_read_retry_time is overridable 4934fb2 is described below commit 4934fb23c18caeec12de7bd9891f92da6cc11b7b Author: Miles Libbey AuthorDate: Thu Mar 7 16:53:30 2019 -0800 Doc: open_read_retry_time is overridable proxy.config.http.cache.open_read_retry_time is overridable ''' $ git grep proxy.config.http.cache.open_read_retry_time | grep InkAPI.cc src/traffic_server/InkAPI.cc:8630: {"proxy.config.http.cache.open_read_retry_time", {TS_CONFIG_HTTP_CACHE_OPEN_READ_RETRY_TIME, TS_RECORDDATATYPE_INT}}, ''' (i.e. its overridable). --- doc/admin-guide/files/records.config.en.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/doc/admin-guide/files/records.config.en.rst b/doc/admin-guide/files/records.config.en.rst index 3abea79..eb380e4 100644 --- a/doc/admin-guide/files/records.config.en.rst +++ b/doc/admin-guide/files/records.config.en.rst @@ -2307,6 +2307,7 @@ all the different user-agent versions of documents it encounters. .. ts:cv:: CONFIG proxy.config.http.cache.open_read_retry_time INT 10 :reloadable: + :overridable: The number of milliseconds a cacheable request will wait before requesting the object from cache if an equivalent request is in flight.
[trafficserver] branch master updated: Doc: Clarify how to update the ssl sessions ticket file
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new a8e7e03 Doc: Clarify how to update the ssl sessions ticket file a8e7e03 is described below commit a8e7e03dae4f971676ab65cfe2ba34216a3b9f97 Author: Miles Libbey AuthorDate: Mon Feb 25 18:03:55 2019 -0800 Doc: Clarify how to update the ssl sessions ticket file --- doc/admin-guide/files/records.config.en.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/doc/admin-guide/files/records.config.en.rst b/doc/admin-guide/files/records.config.en.rst index 01e6d11..3abea79 100644 --- a/doc/admin-guide/files/records.config.en.rst +++ b/doc/admin-guide/files/records.config.en.rst @@ -3321,7 +3321,8 @@ SSL Termination The filename of the default and global ticket key for SSL sessions. The location is relative to the :ts:cv:`proxy.config.ssl.server.cert.path` directory. One way to generate this would be to run ``head -c48 /dev/urandom | openssl enc -base64 | head -c48 > file.ticket``. Also - note that OpenSSL session tickets are sensitive to the version of the ca-certificates. + note that OpenSSL session tickets are sensitive to the version of the ca-certificates. Once the + file is changed with new tickets, use :option:`traffic_ctl config reload` to begin using them. .. ts:cv:: CONFIG proxy.config.ssl.servername.filename STRING ssl_server_name.yaml
[trafficserver] branch master created (now a37f0d9)
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a change to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git. at a37f0d9 XXxClean up ua_entry when client_vc is closed No new revisions were added by this update.
[trafficserver] branch master updated: Doc: money trace plugin link incorrect
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new c4cf32f Doc: money trace plugin link incorrect c4cf32f is described below commit c4cf32f04be3325170c0fb85d786dbb0e4a47c57 Author: Miles Libbey AuthorDate: Wed Feb 13 16:26:08 2019 -0800 Doc: money trace plugin link incorrect --- doc/admin-guide/plugins/index.en.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/admin-guide/plugins/index.en.rst b/doc/admin-guide/plugins/index.en.rst index de8e884..d27e931 100644 --- a/doc/admin-guide/plugins/index.en.rst +++ b/doc/admin-guide/plugins/index.en.rst @@ -201,7 +201,7 @@ directory of the |TS| source tree. Experimental plugins can be compiled by passi :doc:`Metalink ` Implements the Metalink download description format in order to try not to download the same file twice. -:doc:`Money Trace ` +:doc:`Money Trace ` Allows Trafficserver to participate in a distributed tracing system based upon the Comcast Money library. :doc:`MP4 `
[trafficserver] branch master updated: Doc: centering images is not in view
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new d1e15c1 Doc: centering images is not in view d1e15c1 is described below commit d1e15c176936440fb6bc13cef983081a573e9174 Author: Miles Libbey AuthorDate: Wed Feb 13 16:24:27 2019 -0800 Doc: centering images is not in view When we center images/figures, it frequently extends into the full browser width, not the more constrained view. Figures have a surrounding div that allows for better styling than images. In Sphinx, an image is a simple picture, whereas a figure is a image and surrounding data (caption, legend, etc). So, they are effectively interchangeable. --- doc/admin-guide/layer-4-routing.en.rst | 4 ++-- .../monitoring/monitoring/third-party/circonus.en.rst | 10 +- doc/developer-guide/cache-architecture/architecture.en.rst | 9 + doc/developer-guide/core-architecture/rpc.en.rst | 4 ++-- doc/developer-guide/plugins/example-plugins/tls_bridge.en.rst | 4 ++-- doc/static/override.css| 5 + 6 files changed, 21 insertions(+), 15 deletions(-) diff --git a/doc/admin-guide/layer-4-routing.en.rst b/doc/admin-guide/layer-4-routing.en.rst index f81a56f..2355ecd 100644 --- a/doc/admin-guide/layer-4-routing.en.rst +++ b/doc/admin-guide/layer-4-routing.en.rst @@ -28,7 +28,7 @@ accomplished by examining the initial data from the inbound connection to decide destination. The initial data is then sent to the destination and subsequently |TS| forwards all data read on one connection to the other and vice versa. -.. image:: ../uml/images/l4-basic-sequence.svg +.. figure:: ../uml/images/l4-basic-sequence.svg :align: center In this way it acts similary to `nc <https://linux.die.net/man/1/nc>`__. @@ -116,7 +116,7 @@ In addition to this, in the :file:`records.config` file, edit the following vari The sequence of network activity for a Client connecting to ``service-2`` is -.. image:: ../uml/images/l4-sni-routing-seq.svg +.. figure:: ../uml/images/l4-sni-routing-seq.svg :align: center Note the destination for the outbound TCP connection and the HTTP ``CONNECT`` is the same. If this diff --git a/doc/admin-guide/monitoring/monitoring/third-party/circonus.en.rst b/doc/admin-guide/monitoring/monitoring/third-party/circonus.en.rst index 27ae6d2..fde5e96 100644 --- a/doc/admin-guide/monitoring/monitoring/third-party/circonus.en.rst +++ b/doc/admin-guide/monitoring/monitoring/third-party/circonus.en.rst @@ -62,7 +62,7 @@ environment. #. Begin the new check creation process from within your Circonus account by clicking the *New Check* button near the top-right of the checks screen. - .. image:: ../../../../static/images/admin/monitor/circonus/new-check-button.png + .. figure:: ../../../../static/images/admin/monitor/circonus/new-check-button.png :alt: Circonus New Check button :align: center @@ -71,7 +71,7 @@ environment. you and will depend largely on whether you are using on-site Circonus or the hosted service, as well as the geographic location of your |TS| instance(s). - .. image:: ../../../../static/images/admin/monitor/circonus/check-config-1.png + .. figure:: ../../../../static/images/admin/monitor/circonus/check-config-1.png :alt: Choosing a check type :align: center @@ -83,7 +83,7 @@ environment. any of the other options to match your environment if necessary (for this guide, only *Host* and *URI* will need to be entered). - .. image:: ../../../../static/images/admin/monitor/circonus/check-config-2.png + .. figure:: ../../../../static/images/admin/monitor/circonus/check-config-2.png :alt: Advanced check configuration :align: center @@ -94,7 +94,7 @@ environment. running and use ``curl`` to manually fetch the statistics data from your server. - .. image:: ../../../../static/images/admin/monitor/circonus/check-config-3.png + .. figure:: ../../../../static/images/admin/monitor/circonus/check-config-3.png :alt: Check test :align: center @@ -110,7 +110,7 @@ environment. clicking on *Metrics Grid* for an overview visualization of all the data being collected. - .. image:: ../../../../static/images/admin/monitor/circonus/metric-grid.png + .. figure:: ../../../../static/images/admin/monitor/circonus/metric-grid.png :alt: Circonus metric grid :align: center diff --git a/doc/developer-guide/cache-architecture/architecture.en.rst b/doc/developer-guide/cache-architecture/architecture.en.rst index 6442c0e..84a0408 100644 --- a/doc/developer-guide/cache-architecture/architecture.en.rst +++ b/doc/developer-guide/cache-archit
[trafficserver] branch master updated: Autest: Test revalidating cached objects- Chunked object with Range request and 304 (for #3413)- INM, IMS validations
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new c778176 Autest: Test revalidating cached objects- Chunked object with Range request and 304 (for #3413)- INM, IMS validations c778176 is described below commit c77817601a8a45b9ea4f076c8e58a4e4a0b1a2f9 Author: Miles Libbey AuthorDate: Wed May 23 09:06:33 2018 -0700 Autest: Test revalidating cached objects- Chunked object with Range request and 304 (for #3413)- INM, IMS validations --- .../gold_tests/headers/cache_and_error_nobody.gold | 11 ++ .../cache_and_req_body-hit-stale-206-etag.gold | 13 ++ .../headers/cache_and_req_body-hit-stale-206.gold | 13 ++ gold => cache_and_req_body-hit-stale-INM.gold} | 6 +- .../headers/cache_and_req_body-hit-stale.gold | 13 ++ .../gold_tests/headers/cache_and_req_body-hit.gold | 3 +- .../headers/cache_and_req_body-hit_close.gold | 3 +- .../headers/cache_and_req_body-miss.gold | 6 +- .../gold_tests/headers/cache_and_req_body.test.py | 3 +- .../headers/cache_and_req_nobody-hit-stale.gold| 11 ++ tests/gold_tests/headers/cachedIMSRange.test.py| 158 + 11 files changed, 232 insertions(+), 8 deletions(-) diff --git a/tests/gold_tests/headers/cache_and_error_nobody.gold b/tests/gold_tests/headers/cache_and_error_nobody.gold new file mode 100644 index 000..8e10e6f --- /dev/null +++ b/tests/gold_tests/headers/cache_and_error_nobody.gold @@ -0,0 +1,11 @@ +HTTP/1.1 404 Not Found +Content-Length: 0 +Cache-Control: max-age=3 +Date: `` +Age: `` +Connection: keep-alive +Via: `` +Server: `` +X-Cache-Key: http://127.0.0.1`` +X-Cache: `` + diff --git a/tests/gold_tests/headers/cache_and_req_body-hit-stale-206-etag.gold b/tests/gold_tests/headers/cache_and_req_body-hit-stale-206-etag.gold new file mode 100644 index 000..8bc8a2a --- /dev/null +++ b/tests/gold_tests/headers/cache_and_req_body-hit-stale-206-etag.gold @@ -0,0 +1,13 @@ +HTTP/1.1 206 Partial Content +Cache-Control: max-age=1 +Content-Length: 2 +Date: `` +Etag: myetag +Age: `` +Connection: keep-alive +Via: `` +Server: `` +X-Cache-Key: http://127.0.0.1`` +X-Cache: hit-stale + +xx \ No newline at end of file diff --git a/tests/gold_tests/headers/cache_and_req_body-hit-stale-206.gold b/tests/gold_tests/headers/cache_and_req_body-hit-stale-206.gold new file mode 100644 index 000..03cc794 --- /dev/null +++ b/tests/gold_tests/headers/cache_and_req_body-hit-stale-206.gold @@ -0,0 +1,13 @@ +HTTP/1.1 206 Partial Content +Last-Modified: `` +Cache-Control: max-age=1 +Content-Length: 2 +Date: `` +Age: `` +Connection: keep-alive +Via: `` +Server: `` +X-Cache-Key: http://127.0.0.1`` +X-Cache: hit-stale + +xx \ No newline at end of file diff --git a/tests/gold_tests/headers/cache_and_req_body-hit.gold b/tests/gold_tests/headers/cache_and_req_body-hit-stale-INM.gold similarity index 51% copy from tests/gold_tests/headers/cache_and_req_body-hit.gold copy to tests/gold_tests/headers/cache_and_req_body-hit-stale-INM.gold index 90d4a97..2dc3eb8 100644 --- a/tests/gold_tests/headers/cache_and_req_body-hit.gold +++ b/tests/gold_tests/headers/cache_and_req_body-hit-stale-INM.gold @@ -1,11 +1,13 @@ HTTP/1.1 200 OK -Cache-Control: max-age=300 +Cache-Control: max-age=1 Content-Length: 3 Date: `` +Etag: `` Age: `` Connection: keep-alive Via: `` Server: `` -X-Cache: hit-fresh +X-Cache-Key: http://127.0.0.1`` +X-Cache: hit-stale xxx \ No newline at end of file diff --git a/tests/gold_tests/headers/cache_and_req_body-hit-stale.gold b/tests/gold_tests/headers/cache_and_req_body-hit-stale.gold new file mode 100644 index 000..4e9f9e3 --- /dev/null +++ b/tests/gold_tests/headers/cache_and_req_body-hit-stale.gold @@ -0,0 +1,13 @@ +HTTP/1.1 200 OK +Last-Modified: `` +Cache-Control: max-age=1 +Content-Length: 3 +Date: `` +Age: `` +Connection: keep-alive +Via: `` +Server: `` +X-Cache-Key: http://127.0.0.1`` +X-Cache: hit-stale + +xxx \ No newline at end of file diff --git a/tests/gold_tests/headers/cache_and_req_body-hit.gold b/tests/gold_tests/headers/cache_and_req_body-hit.gold index 90d4a97..09c06a1 100644 --- a/tests/gold_tests/headers/cache_and_req_body-hit.gold +++ b/tests/gold_tests/headers/cache_and_req_body-hit.gold @@ -1,5 +1,6 @@ HTTP/1.1 200 OK -Cache-Control: max-age=300 +Last-Modified:`` +Cache-Control: max-age=1 Content-Length: 3 Date: `` Age: `` diff --git a/tests/gold_tests/headers/cache_and_req_body-hit_close.gold b/tests/gold_tests/headers/cache_and_req_body-hit_close.gold index ed944d2..9ccf980 100644 --- a/tests/gold_tests/headers/cache_and_req_body-hit_close.gold +++ b/tests/gold_tests/headers/cache_and_req_body-hit_close.gold @@ -1,5 +1,6 @@ HTTP/1.1 200 OK -Cache-Control: max-age=300 +Last-Modified:`` +Cache-Control: max-age=1 Content-Length: 3 Date: ``
[trafficserver] branch master updated: Doc: parent config has more features than balancer plugin
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new a7d147d Doc: parent config has more features than balancer plugin a7d147d is described below commit a7d147d7b4696ea760284fba2ce5e37181eedbfa Author: Miles Libbey AuthorDate: Thu Nov 15 17:18:34 2018 +0900 Doc: parent config has more features than balancer plugin The balancer plugin has consistent hashing, and round robin (not weighted). As a remap plugin, it is limited to url attribnutes. It neither has passive nor active health checks. Really, Balancer plugin should be deprecated. --- doc/admin-guide/introduction.en.rst | 154 doc/admin-guide/plugins/balancer.en.rst | 4 + 2 files changed, 79 insertions(+), 79 deletions(-) diff --git a/doc/admin-guide/introduction.en.rst b/doc/admin-guide/introduction.en.rst index f6b40ba..06effa3 100644 --- a/doc/admin-guide/introduction.en.rst +++ b/doc/admin-guide/introduction.en.rst @@ -30,102 +30,98 @@ nightmare for IT professionals as they struggle with overloaded servers and congested networks. It can be challenging to consistently and reliably accommodate society’s growing data demands. -Traffic Server is a high-performance web proxy cache that improves +|TS| is a high-performance web proxy cache that improves network efficiency and performance by caching frequently-accessed information at the edge of the network. This brings content physically closer to end users, while enabling faster delivery and reduced -bandwidth use. Traffic Server is designed to improve content delivery +bandwidth use. |TS| is designed to improve content delivery for enterprises, Internet service providers (ISPs), backbone providers, and large intranets by maximizing existing and available bandwidth. -Traffic Server Deployment Options -= +|TS| Deployment Options +=== -To best suit your needs, Traffic Server can be deployed in several ways: +To best suit your needs, |TS| can be deployed in several ways: - As a web proxy cache - As a reverse proxy - In a cache hierarchy -The following sections provide a summary of these Traffic Server +The following sections provide a summary of these |TS| deployment options. -Traffic Server as a Web Proxy Cache +|TS| as a Web Proxy Cache +- -As a web proxy cache, Traffic Server receives user requests for web +As a web proxy cache, |TS| receives user requests for web content as those requests travel to the destined web server (origin -server). If Traffic Server contains the requested content, then it +server). If |TS| contains the requested content, then it serves the content directly. If the requested content is not available -from cache, then Traffic Server acts as a proxy: it obtains the content +from cache, then |TS| acts as a proxy: it obtains the content from the origin server on the user’s behalf and also keeps a copy to satisfy future requests. -Traffic Server provides explicit proxy caching, in which the user’s +|TS| provides explicit proxy caching, in which the user’s client software must be configured to send requests directly to Traffic Server. Explicit proxy caching is described in the :ref:`explicit-proxy-caching` chapter. -Traffic Server can also be employed as a transparent caching proxy server, in +|TS| can also be employed as a transparent caching proxy server, in which the client software needs no special configuration or even knowledge of the proxy's existence. This setup is described in the :ref:`transparent-proxy` section. -Traffic Server as a Reverse Proxy -- +|TS| as a Reverse Proxy +--- -As a reverse proxy, Traffic Server is configured to be the origin server +As a reverse proxy, |TS| is configured to be the origin server to which the user is trying to connect (typically, the origin server’s -advertised hostname resolves to Traffic Server, which acts as the real +advertised hostname resolves to |TS|, which acts as the real origin server). The reverse proxy feature is also called server acceleration. Reverse proxy is described in more detail in :ref:`reverse-proxy-and-http-redirects`. -Traffic Server in a Cache Hierarchy +|TS| in a Cache Hierarchy +- -Traffic Server can participate in flexible cache hierarchies, in which +|TS| can participate in flexible cache hierarchies, in which Internet requests not fulfilled from one cache are routed to other regional caches, thereby leveraging the contents and proximity of nearby -caches. In a hierarchy of proxy servers, Traffic Server can act either -as a parent or a child cache to other
[trafficserver] branch master updated: Doc: Fix ts:cv typo in records.config documentation.
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new b2ebf57 Doc: Fix ts:cv typo in records.config documentation. b2ebf57 is described below commit b2ebf57a3de0f0152e9a81c0b3e77f44951f2ca0 Author: Alan M. Carroll AuthorDate: Tue Dec 4 15:53:35 2018 -0600 Doc: Fix ts:cv typo in records.config documentation. --- doc/admin-guide/files/records.config.en.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/admin-guide/files/records.config.en.rst b/doc/admin-guide/files/records.config.en.rst index 2936600..52ee8fc 100644 --- a/doc/admin-guide/files/records.config.en.rst +++ b/doc/admin-guide/files/records.config.en.rst @@ -1418,7 +1418,7 @@ Origin Server Connect Attempts This value is used in determining when and if to prune active origin sessions. Without this value set, connections to origins can consume all the - way up to ts:cv:`proxy.config.net.connections_throttle` connections, which + way up to :ts:cv:`proxy.config.net.connections_throttle` connections, which in turn can starve incoming requests from available connections. .. ts:cv:: CONFIG proxy.config.http.per_server.connection.max INT 0
[trafficserver] branch master updated: Doc: removing stale while revalidate plugin doc (marked deprecated in 7)
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new 1a5fc3f Doc: removing stale while revalidate plugin doc (marked deprecated in 7) 1a5fc3f is described below commit 1a5fc3fed09b59fb5d693e3c2629e0027f65c8f7 Author: Miles Libbey AuthorDate: Sat Nov 17 21:37:57 2018 +0900 Doc: removing stale while revalidate plugin doc (marked deprecated in 7) The stale while revalidate plugin was marked deprecated in the ATS 7 documentation. Removing now in the 8 docs. --- doc/admin-guide/plugins/index.en.rst | 6 -- .../plugins/stale_while_revalidate.en.rst | 25 -- 2 files changed, 31 deletions(-) diff --git a/doc/admin-guide/plugins/index.en.rst b/doc/admin-guide/plugins/index.en.rst index dd7dd5b..9d8d9b0 100644 --- a/doc/admin-guide/plugins/index.en.rst +++ b/doc/admin-guide/plugins/index.en.rst @@ -160,7 +160,6 @@ directory of the |TS| source tree. Experimental plugins can be compiled by passi Signed URLs SSL Headers SSL Session Reuse - Stale While Revalidate System Statistics Traffic Dump WebP Transform @@ -228,11 +227,6 @@ directory of the |TS| source tree. Experimental plugins can be compiled by passi :doc:`SSL Headers ` Populate request headers with SSL session information. -:doc:`Stale While Revalidate ` - :deprecated: - - Refresh content asynchronously while serving stale data. - :doc:`System Stats ` Inserts system statistics in to the stats list diff --git a/doc/admin-guide/plugins/stale_while_revalidate.en.rst b/doc/admin-guide/plugins/stale_while_revalidate.en.rst deleted file mode 100644 index 76e192b..000 --- a/doc/admin-guide/plugins/stale_while_revalidate.en.rst +++ /dev/null @@ -1,25 +0,0 @@ -.. _admin-plugins-tale-while-revalidate: - -Stale While Revalidate Plugin -* - - :deprecated: - -.. Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. - -refresh content asynchronously while serving stale data
[trafficserver] branch master updated: Doc: cache.config isn't a substitute for Cache-Control
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new cc5f301 Doc: cache.config isn't a substitute for Cache-Control cc5f301 is described below commit cc5f301a587658f477f9eadf6e31b08176f0a496 Author: Miles Libbey AuthorDate: Sat Nov 17 16:33:48 2018 +0900 Doc: cache.config isn't a substitute for Cache-Control As the first file in the admin-guide config files, and saying that the cache.config file controls the cache, folks think it is *the* way to get objects cached. Having the origin provide caching infor via the Cache-Control: header is the prefered method of communicating cache policies. --- doc/admin-guide/files/cache.config.en.rst | 13 +++-- 1 file changed, 11 insertions(+), 2 deletions(-) diff --git a/doc/admin-guide/files/cache.config.en.rst b/doc/admin-guide/files/cache.config.en.rst index 32e7552..40d3a05 100644 --- a/doc/admin-guide/files/cache.config.en.rst +++ b/doc/admin-guide/files/cache.config.en.rst @@ -22,8 +22,8 @@ cache.config -The :file:`cache.config` file defines how |TS| caches web objects. You can add -caching rules to specify the following: +The :file:`cache.config` file allows you to overrule the origin's cache +policies. You can add caching rules to specify the following: - Not to cache objects from specific IP addresses. - How long to pin particular objects in the cache. @@ -32,6 +32,15 @@ caching rules to specify the following: .. important:: + Generally, using this file to define cache policies is an antipattern. + It's usually better to have the origin specify the cache policy via the + `Cache-Control: <https://tools.ietf.org/html/rfc7234#section-5.2>`_ header. + That way, all the business logic stays with the content generation. The + origin is in a much better position to know which content can be safely + cached, and for how long. It can make fine grained decisions, changing + Cache-Control: header value per object. This file allows for some overrides + but, is relatively crude compared to what the origin can provide. + After modifying :file:`cache.config`, run :option:`traffic_ctl config reload` to apply changes.
[trafficserver] branch master updated: Doc: Remove pipeline references
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new 49cfc45 Doc: Remove pipeline references 49cfc45 is described below commit 49cfc45e5e008eb7c1bdc83c988aca5722f89343 Author: Miles Libbey AuthorDate: Tue Nov 13 16:51:58 2018 +0900 Doc: Remove pipeline references Issue #3712 points out that its unlikely that http1.1 pipelining is not working. Options were removed for it a while back. Similarly, support for http 0.9 has been removed. --- doc/admin-guide/files/records.config.en.rst | 9 ++--- 1 file changed, 2 insertions(+), 7 deletions(-) diff --git a/doc/admin-guide/files/records.config.en.rst b/doc/admin-guide/files/records.config.en.rst index f7d2f64..1638255 100644 --- a/doc/admin-guide/files/records.config.en.rst +++ b/doc/admin-guide/files/records.config.en.rst @@ -870,14 +870,9 @@ mptcp .. note:: - If HTTP/1.1 is used, then |TS| can use keep-alive connections with - pipelining to origin servers. + If HTTP/1.1 is used, then |TS| can use keep-alive connections to origin servers. - If HTTP/1.0 is used, then |TS| can use keep-alive connections without - pipelining to origin servers. - - If HTTP/0.9 is used, then |TS| does not use keep-alive connections to - origin servers. + If HTTP/1.0 is used, then |TS| can use keep-alive connections to origin servers. .. ts:cv:: CONFIG proxy.config.http.chunking.size INT 4096 :overridable:
[trafficserver] branch master updated: Doc: getting started case shouldn't used regex_remap
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new 59a5cc3 Doc: getting started case shouldn't used regex_remap 59a5cc3 is described below commit 59a5cc34c215ca1d86e2a39876d26fab08c73c36 Author: Miles Libbey AuthorDate: Mon Nov 12 17:05:46 2018 +0900 Doc: getting started case shouldn't used regex_remap With the getting started simple case using regex_map, we see that pattern used in user@ messages as well as stack overflow questions. Getting rid of that in favor of regular remap rules, and giving a few examples of slightly more complex examples to help gain intuition on how remap works. --- doc/admin-guide/security/index.en.rst | 4 +-- doc/getting-started/index.en.rst | 62 --- 2 files changed, 52 insertions(+), 14 deletions(-) diff --git a/doc/admin-guide/security/index.en.rst b/doc/admin-guide/security/index.en.rst index 411a924..22d59b8 100644 --- a/doc/admin-guide/security/index.en.rst +++ b/doc/admin-guide/security/index.en.rst @@ -116,8 +116,8 @@ Client/Traffic Server connections, you must do the following: which your Traffic Server system will be using to terminate SSL connections with clients. :: -ip_dest=1.2.3.4 ssl_cert_name=example.com.pem -ip_dest=* ssl_cert_name=default.pem +dest_ip=1.2.3.4 ssl_cert_name=example.com.pem +dest_ip=* ssl_cert_name=default.pem #. *Optional*: Configure the use of client certificates using the variable :ts:cv:`proxy.config.ssl.client.certification_level` in :file:`records.config`. diff --git a/doc/getting-started/index.en.rst b/doc/getting-started/index.en.rst index b9e7efc..e65ad67 100644 --- a/doc/getting-started/index.en.rst +++ b/doc/getting-started/index.en.rst @@ -284,7 +284,12 @@ and want little more than to proxy all requests to our single origin server. This is accomplished with the following rule added to the :file:`remap.config` configuration:: -regex_map http://(.*)/ http://localhost:80/ +map http://www.acme.com/ http://localhost:80/ + +With this mapping rule, all paths that |TS| receives with a Host: header of +``www.acme.com`` will be proxied to ``localhost:80``. For instance, a request +for ``http://www.acme.com/foo/bar`` will be proxied to ``http://localhost:80/foo/bar``, +while requests with other Host: headers will be rejected. It is worth pausing at this point to note that in a reverse proxying scenario, it is |TS| itself which should be responding to HTTP requests made to your @@ -304,13 +309,46 @@ they reconfigure their origin service to listen on port ``8080`` instead of the default, and change |TS| to bind to ``80`` itself. Updating the remap is thus required, and it should now be:: -regex_map http://(.*)/ http://localhost:8080/ +map http://www.acme.com/ http://localhost:8080/ Now all requests made to ``www.acme.com`` are received by |TS| which knows to proxy those requests to ``localhost:8080`` if it cannot already serve them from its cache. Because we enabled pristine host headers earlier, the origin service will continue to receive ``Host: www.acme.com`` in the HTTP request. +If |AW| decides to use |TS| to reverse proxy a second domain ``static.acme.com`` +with a different origin server than the original, they need to make further +changes, as a new remap line needs to be added to handle the additional domain:: + +map http://static.acme.com/ http://origin-static.acme.com/ + +If they also decide to have requests to ``www.acme.com`` with paths that start with +``/api`` to a different origin server. The api origin server shouldn't get the ``/api``, +they will remap it away. And, since the above remap rules catch all paths, +this remap rule needs to be above it:: + +map http://www.acme.com/api/ http://api-origin.acme.com/ + +With this remap rule in place, a request to ``http://www.acme.com/api/example/foo`` +will be proxied to ``http://api-origin.acme.com/example/foo``. + +Finally, if |AW| decides to secure their site with https, they will need two +additional remap rules to handle the https requests. |TS| can translate an inbound +https request to an http request to origin. So, they would have additional remap +rules like:: + +map https://www.acme.com/ http://localhost:8080/ +map https://static.acme.com/ https://origin-static.acme.com/ + +This will require installing a certificate, and adding a line to +:file:`ssl_multicert.config`. Assuming the cert has the static.acme.com alternate +name, and that cert should be presented by default:: + +dest_ip=* ssl_cert_name=/path/to/secret/privatekey/acme.rsa + +Further information about configuring |TS| for TLS can be found :ref:`admin-ssl-termination` +section of the documentation. + Adjust Cache
[trafficserver] branch master updated: Doc: sort overrides in table
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new 094ab25 Doc: sort overrides in table 094ab25 is described below commit 094ab25154e599d45505a0e40ca8ec3206f13edd Author: Miles Libbey AuthorDate: Mon Nov 12 08:03:19 2018 +0900 Doc: sort overrides in table This sorts the table alphabetacally based on the TSOverridableConfigKey Value to make for easier finding. A few options are not documented, TS_CONFIG_HTTP_REQUEST_BUFFER_ENABLED (and its proxy.config.http.request_buffer_enabled) TS_CONFIG_SSL_CLIENT_VERIFY_SERVER --- .../api/functions/TSHttpOverridableConfig.en.rst | 34 +++--- 1 file changed, 17 insertions(+), 17 deletions(-) diff --git a/doc/developer-guide/api/functions/TSHttpOverridableConfig.en.rst b/doc/developer-guide/api/functions/TSHttpOverridableConfig.en.rst index c99f383..003ee33 100644 --- a/doc/developer-guide/api/functions/TSHttpOverridableConfig.en.rst +++ b/doc/developer-guide/api/functions/TSHttpOverridableConfig.en.rst @@ -66,6 +66,8 @@ The following configurations (from ``records.config``) are overridable: TSOverridableConfigKey Value Configuration Value == :c:macro:`TS_CONFIG_BODY_FACTORY_TEMPLATE_BASE` :ts:cv:`proxy.config.body_factory.template_base` +:c:macro:`TS_CONFIG_HTTP_ALLOW_HALF_OPEN` :ts:cv:`proxy.config.http.allow_half_open` +:c:macro:`TS_CONFIG_HTTP_ALLOW_MULTI_RANGE` :ts:cv:`proxy.config.http.allow_multi_range` :c:macro:`TS_CONFIG_HTTP_ANONYMIZE_INSERT_CLIENT_IP` :ts:cv:`proxy.config.http.insert_client_ip` :c:macro:`TS_CONFIG_HTTP_ANONYMIZE_REMOVE_CLIENT_IP` :ts:cv:`proxy.config.http.anonymize_remove_client_ip` :c:macro:`TS_CONFIG_HTTP_ANONYMIZE_REMOVE_COOKIE` :ts:cv:`proxy.config.http.anonymize_remove_cookie` @@ -86,10 +88,10 @@ TSOverridableConfigKey Value Configuratio :c:macro:`TS_CONFIG_HTTP_CACHE_HEURISTIC_MAX_LIFETIME` :ts:cv:`proxy.config.http.cache.heuristic_max_lifetime` :c:macro:`TS_CONFIG_HTTP_CACHE_HEURISTIC_MIN_LIFETIME` :ts:cv:`proxy.config.http.cache.heuristic_min_lifetime` :c:macro:`TS_CONFIG_HTTP_CACHE_HTTP` :ts:cv:`proxy.config.http.cache.http` -:c:macro:`TS_CONFIG_HTTP_CACHE_IGNORE_ACCEPT_MISMATCH` :ts:cv:`proxy.config.http.cache.ignore_accept_mismatch` :c:macro:`TS_CONFIG_HTTP_CACHE_IGNORE_ACCEPT_CHARSET_MISMATCH` :ts:cv:`proxy.config.http.cache.ignore_accept_charset_mismatch` :c:macro:`TS_CONFIG_HTTP_CACHE_IGNORE_ACCEPT_ENCODING_MISMATCH` :ts:cv:`proxy.config.http.cache.ignore_accept_encoding_mismatch` :c:macro:`TS_CONFIG_HTTP_CACHE_IGNORE_ACCEPT_LANGUAGE_MISMATCH` :ts:cv:`proxy.config.http.cache.ignore_accept_language_mismatch` +:c:macro:`TS_CONFIG_HTTP_CACHE_IGNORE_ACCEPT_MISMATCH` :ts:cv:`proxy.config.http.cache.ignore_accept_mismatch` :c:macro:`TS_CONFIG_HTTP_CACHE_IGNORE_AUTHENTICATION` :ts:cv:`proxy.config.http.cache.ignore_authentication` :c:macro:`TS_CONFIG_HTTP_CACHE_IGNORE_CLIENT_CC_MAX_AGE` :ts:cv:`proxy.config.http.cache.ignore_client_cc_max_age` :c:macro:`TS_CONFIG_HTTP_CACHE_IGNORE_CLIENT_NO_CACHE` :ts:cv:`proxy.config.http.cache.ignore_client_no_cache` @@ -109,8 +111,8 @@ TSOverridableConfigKey Value Configuratio :c:macro:`TS_CONFIG_HTTP_CACHE_WHEN_TO_REVALIDATE` :ts:cv:`proxy.config.http.cache.when_to_revalidate` :c:macro:`TS_CONFIG_HTTP_CHUNKING_ENABLED` :ts:cv:`proxy.config.http.chunking_enabled` :c:macro:`TS_CONFIG_HTTP_CHUNKING_SIZE` :ts:cv:`proxy.config.http.chunking.size` -:c:macro:`TS_CONFIG_HTTP_CONNECT_ATTEMPTS_MAX_RETRIES` :ts:cv:`proxy.config.http.connect_attempts_max_retries` :c:macro:`TS_CONFIG_HTTP_CONNECT_ATTEMPTS_MAX_RETRIES_DEAD_SERVER` :ts:cv:`proxy.config.http.connect_attempts_max_retries_dead_server` +:c:macro:`TS_CONFIG_HTTP_CONNECT_ATTEMPTS_MAX_RETRIES` :ts:cv:`proxy.config.http.connect_attempts_max_retries` :c:macro:`TS_CONFIG_HTTP_CONNECT_ATTEMPTS_RR_RETRIES` :ts:cv:`proxy.config.http.connect_attempts_rr_retries` :c:macro:`TS_CONFIG_HTTP_CONNECT_ATTEMPTS_TIMEOUT` :ts:cv:`proxy.config.http.connect_attempts_timeout` :c:macro:`TS_CONFIG_HTTP_DEFAULT_BUFFER_SIZE` :ts:cv:`proxy.config.http.default_buffer_size` @@ -125,10 +127,10 @@ TSOverridableConfigKey Value
[trafficserver] branch master updated: Doc: Add missing overrides and sort
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new 245c011 Doc: Add missing overrides and sort 245c011 is described below commit 245c0113ee6c8c806a4127d358fef016380f230a Author: Miles Libbey AuthorDate: Thu Nov 8 20:41:00 2018 -0800 Doc: Add missing overrides and sort #4202 Added TS_CONFIG_HTTP_CACHE_ENABLE_DEFAULT_VARY_HEADER TS_CONFIG_HTTP_CACHE_IGNORE_ACCEPT_CHARSET_MISMATCH TS_CONFIG_HTTP_CACHE_IGNORE_ACCEPT_ENCODING_MISMATCH TS_CONFIG_HTTP_CACHE_IGNORE_ACCEPT_LANGUAGE_MISMATCH TS_CONFIG_HTTP_CACHE_IGNORE_ACCEPT_MISMATCH TS_CONFIG_HTTP_CACHE_VARY_DEFAULT_IMAGES TS_CONFIG_HTTP_CACHE_VARY_DEFAULT_OTHER TS_CONFIG_HTTP_CACHE_VARY_DEFAULT_TEXT TS_CONFIG_HTTP_REQUEST_BUFFER_ENABLED TS_CONFIG_SSL_CLIENT_VERIFY_SERVER and sorted the list alphabetically --- .../api/functions/TSHttpOverridableConfig.en.rst | 10 ++ 1 file changed, 10 insertions(+) diff --git a/doc/developer-guide/api/functions/TSHttpOverridableConfig.en.rst b/doc/developer-guide/api/functions/TSHttpOverridableConfig.en.rst index 125e111..c99f383 100644 --- a/doc/developer-guide/api/functions/TSHttpOverridableConfig.en.rst +++ b/doc/developer-guide/api/functions/TSHttpOverridableConfig.en.rst @@ -78,6 +78,7 @@ TSOverridableConfigKey Value Configuratio :c:macro:`TS_CONFIG_HTTP_BACKGROUND_FILL_COMPLETED_THRESHOLD` :ts:cv:`proxy.config.http.background_fill_completed_threshold` :c:macro:`TS_CONFIG_HTTP_CACHE_CACHE_RESPONSES_TO_COOKIES` :ts:cv:`proxy.config.http.cache.cache_responses_to_cookies` :c:macro:`TS_CONFIG_HTTP_CACHE_CACHE_URLS_THAT_LOOK_DYNAMIC` :ts:cv:`proxy.config.http.cache.cache_urls_that_look_dynamic` +:c:macro:`TS_CONFIG_HTTP_CACHE_ENABLE_DEFAULT_VARY_HEADER` :ts:cv:`proxy.config.http.cache.enable_default_vary_headers` :c:macro:`TS_CONFIG_HTTP_CACHE_GENERATION` :ts:cv:`proxy.config.http.cache.generation` :c:macro:`TS_CONFIG_HTTP_CACHE_GUARANTEED_MAX_LIFETIME` :ts:cv:`proxy.config.http.cache.guaranteed_max_lifetime` :c:macro:`TS_CONFIG_HTTP_CACHE_GUARANTEED_MIN_LIFETIME` :ts:cv:`proxy.config.http.cache.guaranteed_min_lifetime` @@ -85,6 +86,10 @@ TSOverridableConfigKey Value Configuratio :c:macro:`TS_CONFIG_HTTP_CACHE_HEURISTIC_MAX_LIFETIME` :ts:cv:`proxy.config.http.cache.heuristic_max_lifetime` :c:macro:`TS_CONFIG_HTTP_CACHE_HEURISTIC_MIN_LIFETIME` :ts:cv:`proxy.config.http.cache.heuristic_min_lifetime` :c:macro:`TS_CONFIG_HTTP_CACHE_HTTP` :ts:cv:`proxy.config.http.cache.http` +:c:macro:`TS_CONFIG_HTTP_CACHE_IGNORE_ACCEPT_MISMATCH` :ts:cv:`proxy.config.http.cache.ignore_accept_mismatch` +:c:macro:`TS_CONFIG_HTTP_CACHE_IGNORE_ACCEPT_CHARSET_MISMATCH` :ts:cv:`proxy.config.http.cache.ignore_accept_charset_mismatch` +:c:macro:`TS_CONFIG_HTTP_CACHE_IGNORE_ACCEPT_ENCODING_MISMATCH` :ts:cv:`proxy.config.http.cache.ignore_accept_encoding_mismatch` +:c:macro:`TS_CONFIG_HTTP_CACHE_IGNORE_ACCEPT_LANGUAGE_MISMATCH` :ts:cv:`proxy.config.http.cache.ignore_accept_language_mismatch` :c:macro:`TS_CONFIG_HTTP_CACHE_IGNORE_AUTHENTICATION` :ts:cv:`proxy.config.http.cache.ignore_authentication` :c:macro:`TS_CONFIG_HTTP_CACHE_IGNORE_CLIENT_CC_MAX_AGE` :ts:cv:`proxy.config.http.cache.ignore_client_cc_max_age` :c:macro:`TS_CONFIG_HTTP_CACHE_IGNORE_CLIENT_NO_CACHE` :ts:cv:`proxy.config.http.cache.ignore_client_no_cache` @@ -98,6 +103,9 @@ TSOverridableConfigKey Value Configuratio :c:macro:`TS_CONFIG_HTTP_CACHE_RANGE_LOOKUP` :ts:cv:`proxy.config.http.cache.range.lookup` :c:macro:`TS_CONFIG_HTTP_CACHE_RANGE_WRITE` :ts:cv:`proxy.config.http.cache.range.write` :c:macro:`TS_CONFIG_HTTP_CACHE_REQUIRED_HEADERS` :ts:cv:`proxy.config.http.cache.required_headers` +:c:macro:`TS_CONFIG_HTTP_CACHE_VARY_DEFAULT_IMAGES` :ts:cv:`proxy.config.http.cache.vary_default_images` +:c:macro:`TS_CONFIG_HTTP_CACHE_VARY_DEFAULT_OTHER` :ts:cv:`proxy.config.http.cache.vary_default_other` +:c:macro:`TS_CONFIG_HTTP_CACHE_VARY_DEFAULT_TEXT` :ts:cv:`proxy.config.http.cache.vary_default_text` :c:macro:`TS_CONFIG_HTTP_CACHE_WHEN_TO_REVALIDATE` :ts:cv:`proxy.config.http.cache.when_to_revalidate` :c:macro:`TS_CONFIG_HTTP_CHUNKING_ENABLED` :ts:cv:`proxy.config.http.chunking_enabled` :c:macro:`TS_CONFIG_HTTP_CHUNKING_SIZE` :ts:cv:`proxy.config.http.chunking.size
[trafficserver] branch master updated: Doc: change code snippet highlighting scheme
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new f6e3db9 Doc: change code snippet highlighting scheme f6e3db9 is described below commit f6e3db952fb1e4dde49fb68d6a8bc8e36e04611f Author: Miles Libbey AuthorDate: Wed Nov 7 20:45:48 2018 -0800 Doc: change code snippet highlighting scheme The lime green background for code snippets doesn't go with the light blue background. The 'default' code highlighting scheme uses a moderate gray background, but similar font colors for syntax highlighting. --- doc/conf.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/conf.py b/doc/conf.py index 11884b6..54e2cee 100644 --- a/doc/conf.py +++ b/doc/conf.py @@ -161,7 +161,7 @@ exclude_patterns = [] #show_authors = False # The name of the Pygments (syntax highlighting) style to use. -pygments_style = 'sphinx' +pygments_style = 'default' # A list of ignored prefixes for module index sorting. #modindex_common_prefix = []
[trafficserver] branch master updated: Doc: Describe parent weight and format
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new ca6cf23 Doc: Describe parent weight and format ca6cf23 is described below commit ca6cf23dd0d752d6be41f1f838d134ad8ab380ee Author: Miles Libbey AuthorDate: Sun Nov 4 08:54:52 2018 -0800 Doc: Describe parent weight and format In Issue #4549, realized that the parent weights were never documented. In the version that shall not be named, there was an example that had a weight, but, it was not mentioned in the text. --- doc/admin-guide/files/parent.config.en.rst | 33 +- 1 file changed, 23 insertions(+), 10 deletions(-) diff --git a/doc/admin-guide/files/parent.config.en.rst b/doc/admin-guide/files/parent.config.en.rst index ef615d8..3a26e95 100644 --- a/doc/admin-guide/files/parent.config.en.rst +++ b/doc/admin-guide/files/parent.config.en.rst @@ -15,6 +15,8 @@ specific language governing permissions and limitations under the License. +.. include:: ../../common.defs + = parent.config = @@ -122,16 +124,27 @@ The following list shows the possible actions and their allowed values. .. _parent-config-format-parent: -``parent`` -An ordered list of parent servers. If the request cannot be handled -by the last parent server in the list, then it will be routed to the -origin server. You can specify either a hostname or an IP address, -but; you must specify the port number. +``parent`` `(hostname or IP address):port[|weight][,another host]` +An ordered list of parent servers, separated by commas or +semicolons. If the request cannot be handled by the last parent +server in the list, then it will be routed to the origin server. +You can specify either a hostname or an IP address, but, you must +specify the port number. If there are multiple IP addresses associated +with the hostname, |TS| will treat them as a single entity when tracking +health. Example:: + +parent="p1.x.com:8080, 192.168.0.3:80, 192.168.0.4:80" + +An optional weight can be specified after a pipe (``|``). This example +has one parent take 20% (2/(2+3+5)) of the requests, another 30% (3/(2+3+5)), +and the last 50% (5/(2+3+5)):: + +parent="p1.x.com:8080|2.0, 192.168.0.3:80|3.0, 192.168.0.4:80|5.0" .. _parent-config-format-secondary-parent: ``secondary_parent`` -An optional ordered list of secondary parent servers. This +An optional ordered list of secondary parent servers in the same format as parent. This optional list may only be used when ``round_robin`` is set to ``consistent_hash``. If the request cannot be handled by the first parent server chosen from the ``parent`` list, then the @@ -177,11 +190,11 @@ The following list shows the possible actions and their allowed values. One of the following values: - ``true`` - This is the default. The list of parents and secondary parents -are proxy cache servers. + are proxy cache servers. - ``false`` - The list of parents and secondary parents are the origin -servers ``go_direct`` flag is ignored and origins are selected using -the specified ``round_robin`` algorithm. The FQDN is removed from -the http request line. + servers ``go_direct`` flag is ignored and origins are selected using + the specified ``round_robin`` algorithm. The FQDN is removed from + the http request line. .. _parent-config-format-parent-retry:
[trafficserver] branch master updated: docs: reference to overridable config not parsed
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new 9b49aa1 docs: reference to overridable config not parsed 9b49aa1 is described below commit 9b49aa15e5cf18c73b2f8865e910acd05180ffe6 Author: Miles Libbey AuthorDate: Wed Oct 10 15:22:06 2018 -0700 docs: reference to overridable config not parsed --- doc/admin-guide/plugins/regex_remap.en.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/admin-guide/plugins/regex_remap.en.rst b/doc/admin-guide/plugins/regex_remap.en.rst index c5b08e7..ead5456 100644 --- a/doc/admin-guide/plugins/regex_remap.en.rst +++ b/doc/admin-guide/plugins/regex_remap.en.rst @@ -135,7 +135,7 @@ remap.config. The following options are available :: @connect_timeout= - Connect timeouts (in ms) @dns_timeout= - Connect timeouts (in ms) -@overridable-config= - see :ref:`Overridable Configurations ` +@overridable-config= - see :ref:`ts-overridable-config` @caseless - Make regular expressions case insensitive @lowercase_substitutions- Turn on (enable) lower case substitutions
[trafficserver] branch master updated: doc: fixes some example configurations in the plugins docs
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new 0cd39c6 doc: fixes some example configurations in the plugins docs 0cd39c6 is described below commit 0cd39c6f4fa09f52a3b639bc08a0809a0f260c10 Author: Randall Meyer AuthorDate: Wed May 30 17:31:54 2018 -0700 doc: fixes some example configurations in the plugins docs --- doc/admin-guide/plugins/escalate.en.rst | 4 +++- doc/admin-guide/plugins/geoip_acl.en.rst | 2 +- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/doc/admin-guide/plugins/escalate.en.rst b/doc/admin-guide/plugins/escalate.en.rst index 7739952..af0c2a2 100644 --- a/doc/admin-guide/plugins/escalate.en.rst +++ b/doc/admin-guide/plugins/escalate.en.rst @@ -1,3 +1,5 @@ +.. include:: ../../common.defs + .. _escalate-plugin: Escalate Plugin @@ -52,7 +54,7 @@ Example With this line in :file:`remap.config` :: -map cdn.example.com origin.example.com +map cdn.example.com origin.example.com \ @plugin=escalate.so @pparam=401,404,410,502:second-origin.example.com @pparam=--pristine Traffic Server would accept a request for ``cdn.example.com`` and, on a cache miss, proxy the diff --git a/doc/admin-guide/plugins/geoip_acl.en.rst b/doc/admin-guide/plugins/geoip_acl.en.rst index 5413407..15e5af7 100644 --- a/doc/admin-guide/plugins/geoip_acl.en.rst +++ b/doc/admin-guide/plugins/geoip_acl.en.rst @@ -79,7 +79,7 @@ use case. example :: map http://example.com http://music.example.com \ - @plugin=geoip_acl.so @pparam=country @pparam=allow @pparam= US + @plugin=geoip_acl.so @pparam=country @pparam=allow @pparam=US \ @pparam=regex::/etc/music.regex This tells the plugin that in the situation where there is no matching -- To stop receiving notification emails like this one, please contact mlib...@apache.org.
[trafficserver] branch master updated: Doc: document proxy.config.ssl.server.multicert.exit_on_load_fail
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new d783ecb Doc: document proxy.config.ssl.server.multicert.exit_on_load_fail d783ecb is described below commit d783ecb9f1a590fcb5d1e87f274b1e8bf97c4c17 Author: Miles Libbey <mlib...@apache.org> AuthorDate: Wed May 9 15:04:16 2018 +0100 Doc: document proxy.config.ssl.server.multicert.exit_on_load_fail --- doc/admin-guide/files/records.config.en.rst | 12 +--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/doc/admin-guide/files/records.config.en.rst b/doc/admin-guide/files/records.config.en.rst index 81746f6..dfd0da8 100644 --- a/doc/admin-guide/files/records.config.en.rst +++ b/doc/admin-guide/files/records.config.en.rst @@ -3187,9 +3187,9 @@ SSL Termination .. ts:cv:: CONFIG proxy.config.ssl.server.multicert.filename STRING ssl_multicert.config The location of the :file:`ssl_multicert.config` file, relative - to the Traffic Server configuration directory. In the following - example, if the Traffic Server configuration directory is - `/etc/trafficserver`, the Traffic Server SSL configuration file + to the |TS| configuration directory. In the following + example, if the |TS| configuration directory is + `/etc/trafficserver`, the |TS| SSL configuration file and the corresponding certificates are located in `/etc/trafficserver/ssl`:: @@ -3197,6 +3197,12 @@ SSL Termination CONFIG proxy.config.ssl.server.cert.path STRING etc/trafficserver/ssl CONFIG proxy.config.ssl.server.private_key.path STRING etc/trafficserver/ssl +.. ts:cv:: CONFIG proxy.config.ssl.server.multicert.exit_on_load_fail INT 1 + + By default (``1``), |TS| will not start unless all the SSL certificates listed in the + :file:`ssl_multicert.config` file successfully load. If false (``0``), SSL certificate + load failures will not prevent |TS| from starting. + .. ts:cv:: CONFIG proxy.config.ssl.server.cert.path STRING /config The location of the SSL certificates and chains used for accepting -- To stop receiving notification emails like this one, please contact mlib...@apache.org.
[trafficserver] branch master updated: Logging can only have 1 accept filter
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new 8cbc52d Logging can only have 1 accept filter 8cbc52d is described below commit 8cbc52d973741691d3b3c0e3d96a8ee2f1056c8d Author: Miles Libbey <mlib...@apache.org> AuthorDate: Tue Jan 9 18:52:07 2018 -0800 Logging can only have 1 accept filter We support multiple reject filters, but only 1 accept filter. For instance example = filter.accept('% MATCH example.com') foo = filter.accept('% MATCH another.example.com') log.ascii { Filename = 'refreshhit_summary', Format = summaryfmt, Filters = { example, foo } } and all variants will not log anything to refreshhit_summary. However, example = filter.reject('% MATCH example.com') foo = filter.reject('% MATCH another.example.com') log.ascii { Filename = 'refreshhit_summary', Format = summaryfmt, Filters = { example, foo } } will not contain logs from example.com and another.example.com --- doc/admin-guide/files/logging.config.en.rst | 14 -- 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/doc/admin-guide/files/logging.config.en.rst b/doc/admin-guide/files/logging.config.en.rst index 77a5b96..d368435 100644 --- a/doc/admin-guide/files/logging.config.en.rst +++ b/doc/admin-guide/files/logging.config.en.rst @@ -168,11 +168,11 @@ Filter objects are created by calling one of the following functions: filter.accept(string) Creates a filter object which accepts events for logging which match the -rule specified in ``string``. +rule specified in ``string``. Note that you may only have one accept filter. filter.reject(string) Creates a filter object which rejects events for logging which match the -rule specified in ``string``. +rule specified in ``string``. You may have multiple reject filters. filter.wipe(string) Creates a filter object which clears the values of query parameters listed @@ -237,10 +237,11 @@ supported at this time. .. note:: -It may be tempting to attach multiple Filters to a log object to accept or +It may be tempting to attach multiple Filters to a log object reject multiple log fields (in lieu of providing a single comma separated list -to a single Filter). Avoid this temptation and use a comma separated list -instead. Attaching multiple filters does the opposite of what you'd +to a single Filter). Avoid this temptation and use a comma separated list of reject objects +instead. Remember that you may not have multiple accept filter objects. +Attaching multiple filters does the opposite of what you'd expect. If, for example, we had 2 accept log filters, each disjoint from the other, nothing will ever get logged on the given log object. @@ -314,7 +315,8 @@ RollingOffsetHr number Specifies an hour (from 0 to 23) at which log RollingSizeMb number Size, in megabytes, at which log files are rolled. Filters array ofThe optional list of filter objects which -filters restrict the individual events logged. +filters restrict the individual events logged. The array +may only contain one accept filter. CollationHosts array ofIf present, one or more strings specifying the strings log collation hosts to which logs should be delivered, each in the form of ":". -- To stop receiving notification emails like this one, please contact mlib...@apache.org.
[trafficserver] branch 7.1.x updated: Update IMS handling table to include INM
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch 7.1.x in repository https://gitbox.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/7.1.x by this push: new dad8243 Update IMS handling table to include INM dad8243 is described below commit dad824369b767ee5872ab40c9130111a990c1d1b Author: Miles Libbey <mlib...@apple.com> AuthorDate: Fri Jun 2 10:59:27 2017 -0700 Update IMS handling table to include INM (cherry picked from commit 36c68bbb3266650e6e09c34fd5fcfed3858f7331) --- doc/admin-guide/storage/index.en.rst | 78 ++-- proxy/http/HttpTransact.cc | 24 +++ 2 files changed, 92 insertions(+), 10 deletions(-) diff --git a/doc/admin-guide/storage/index.en.rst b/doc/admin-guide/storage/index.en.rst index 93813af..4bdbded 100644 --- a/doc/admin-guide/storage/index.en.rst +++ b/doc/admin-guide/storage/index.en.rst @@ -350,9 +350,38 @@ The next time Traffic Server receives a request for the removed object, it will contact the origin server to retrieve a new copy, which will replace the previously cached version in Traffic Server. -This procedure only removes an object from a specific Traffic Server cache. -Users may still see the old (removed) content if it was cached by intermediary -caches or by the end-users' web browser. +This procedure only removes the index to the object from a specific Traffic Server +cache. While the object remains on disk, Traffic Server will no longer able to find +the object. The next request for that object will result in a fresh copy of the +object fetched. Users may still see the old (removed) content if it was cached by +intermediary caches or by the end-users' web browser. + +Pushing an Object into the Cache + + +Traffic Server accepts the custom HTTP request method ``PUSH`` to put an object +into the the cache. If the object is successfully written to the cache, then +Traffic Server responds with a ``200 OK`` HTTP message; otherwise a +``400 Malformed Pushed Response Header`` message is returned. + +To push an object, first save the object headers and body into a file. For instance: :: + + $ curl -s -i -o /path/to/file "http://example.com/push_me.html; + $ cat /path/to/file + HTTP/1.1 200 OK + Date: Wed, 31 May 2017 16:01:59 GMT + Access-Control-Allow-Origin: * + Cache-Control: max-age=10800, public + Last-Modified: Wed, 31 May 2017 16:01:59 GMT + Content-Type: text/html + Age: 0 + Content-Length: 176970 + + http://example.com/push_me.html; .. _inspecting-the-cache: @@ -421,3 +450,46 @@ Regex Invalidate Only one administrator should delete and invalidate cache entries from the Cache Inspector at any point in time. Changes made by multiple administrators at the same time can lead to unpredictable results. + +If-Modified-Since/If-None-Match +--- + +Traffic Server will respond to matching If-Modified-Since/If-None-Match requests +with a ``304 Not Modified`` HTTP message. + +This table describes how Traffic Server handles these types of requests: :: + +OS = Origin Server's respose HTTP message +IMS = A GET request w/ an If-Modified-Since header +LMs = Last-Modified header date returned by server +INM = A GET request w/ an If-None-Match header +E = Etag header present +D, D' are Last modified dates returned by the origin server and are later used for IMS +The D date is earlier than the D' date + ++--+---+--+---+--+ +| Client's | Cached| Proxy's | Response to client | +| Request | State | Request +---+--+ +| | | | OS 200| OS 304 | ++==+===+==+===+==+ +| GET | Fresh | N/A | N/A | N/A | ++--+---+--+---+--+ +| GET | Stale, D' | IMS D' | 200, new | 200, cached | ++--+---+--+---+--+ +| GET | Stale, E | INM E | 200, new | 200, cached | ++--+---+--+---+--+ +| INM E | Stale, E | INM E | 304 | 304 | ++--+---+--+---+--+ +| INM E + | Stale,| INM E| 200, new *| 304 | +| IMS D' | E + D'| IMS D' | | | ++--+---+--+---+--+ +| IMS D | None | GET | 200, new *| N/A | ++--+---+--+---+--+ +| INM E | None | GET | 200, new *| N/A | ++--+---+--+---+--+ +| IMS D | Stale, D' | IMS D' | 200, new
[trafficserver] branch 7.1.x updated: volume.config doesn't differentiate http/https
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch 7.1.x in repository https://gitbox.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/7.1.x by this push: new 8d14e4d volume.config doesn't differentiate http/https 8d14e4d is described below commit 8d14e4d95f82c0ac4893ec2423a2a16540c217a0 Author: Miles Libbey <mlib...@apple.com> AuthorDate: Thu Jun 1 14:49:21 2017 -0700 volume.config doesn't differentiate http/https (cherry picked from commit 649f4e01d562d9cb850ec92f69ed1a5eefa5c51a) --- doc/admin-guide/files/volume.config.en.rst | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/doc/admin-guide/files/volume.config.en.rst b/doc/admin-guide/files/volume.config.en.rst index 7c6d594..d1c5dac 100644 --- a/doc/admin-guide/files/volume.config.en.rst +++ b/doc/admin-guide/files/volume.config.en.rst @@ -65,5 +65,4 @@ The following example partitions the cache evenly between HTTP and HTTPS requests:: volume=1 scheme=http size=50% -volume=2 scheme=https size=50% - +volume=2 scheme=http size=50% -- To stop receiving notification emails like this one, please contact ['"commits@trafficserver.apache.org" <commits@trafficserver.apache.org>'].
[trafficserver] branch 7.1.x updated: adds clarifications on plugin use
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch 7.1.x in repository https://gitbox.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/7.1.x by this push: new 569479b adds clarifications on plugin use 569479b is described below commit 569479bc61d0272e129cc608b5e1daf9dc92 Author: Derek Dagit <der...@yahoo-inc.com> AuthorDate: Mon Jun 19 10:56:49 2017 -0500 adds clarifications on plugin use (cherry picked from commit 3540f902df2f3d9c4a42afef5444bc99ef9557c1) --- doc/admin-guide/plugins/header_rewrite.en.rst | 10 ++ 1 file changed, 10 insertions(+) diff --git a/doc/admin-guide/plugins/header_rewrite.en.rst b/doc/admin-guide/plugins/header_rewrite.en.rst index 4954dba..7c10ca5 100644 --- a/doc/admin-guide/plugins/header_rewrite.en.rst +++ b/doc/admin-guide/plugins/header_rewrite.en.rst @@ -102,6 +102,10 @@ As with the global method above, multiple configuration files may be listed, each with its own ``@pparam=`` and their contents will be evaluated in the order the files were specified. +Each ruleset that is configured per-mapping should have a special +`Hook Conditions`_ defined. Without a defined hook, these rulesets will use the +``REMAP_PSEUDO_HOOK``. + Rewriting Rules === @@ -706,6 +710,12 @@ Variable Description % Client unmapped URI path == +Variables to be expanded must be enclosed in double quotes ``"``, as in this example using the arbitrary header +``Custom-Client-IP``:: + +set-header Custom-Client-IP "%" + + Header Values - -- To stop receiving notification emails like this one, please contact ['"commits@trafficserver.apache.org" <commits@trafficserver.apache.org>'].
[trafficserver] branch 7.1.x updated: Doc: Fix warning for footnote in cache arch docs.
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch 7.1.x in repository https://gitbox.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/7.1.x by this push: new c35cfa1 Doc: Fix warning for footnote in cache arch docs. c35cfa1 is described below commit c35cfa10b76c8248d5348755dd24addf267394cd Author: Alan M. Carroll <a...@apache.org> AuthorDate: Fri Aug 4 19:07:26 2017 -0500 Doc: Fix warning for footnote in cache arch docs. (cherry picked from commit 10ab7550a5d1d1a97412b133a236a52d0d0f9b64) --- doc/developer-guide/architecture/data-structures.en.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/developer-guide/architecture/data-structures.en.rst b/doc/developer-guide/architecture/data-structures.en.rst index e63e1c6..4b52b2a 100644 --- a/doc/developer-guide/architecture/data-structures.en.rst +++ b/doc/developer-guide/architecture/data-structures.en.rst @@ -178,7 +178,7 @@ Data Structures fragment containing the first byte in the range can be computed and loaded directly without further disk access. - Removed as of version 3.3.0. + Removed as of version 3.3.0. [#fragment-offset-table]_ .. cpp:member:: uint32_t Doc::sync_serial -- To stop receiving notification emails like this one, please contact ['"commits@trafficserver.apache.org" <commits@trafficserver.apache.org>'].
[trafficserver] branch 7.1.x updated: Session ticket resumption needs consistent CA-certificate version
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch 7.1.x in repository https://gitbox.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/7.1.x by this push: new c16e3b2 Session ticket resumption needs consistent CA-certificate version c16e3b2 is described below commit c16e3b25185588a0bd6f520f26d1fbc630fa8d5f Author: Miles Libbey <mlib...@apache.org> AuthorDate: Mon Aug 14 15:22:19 2017 -0700 Session ticket resumption needs consistent CA-certificate version OpenSSL session tickets are sensitive to the version of the ca-certificates OEL/RHEL package. We had ~200 machines with 1 version of ca-certificates-... , and the rest with another version. Sessions generated with the “old” ca-cerficates do not resume with the newer CAs (and vice versa). Hoping other can avoid this confusion with this note. (cherry picked from commit 7c05be8f1a2c0eb7b8a46882ac2abb92b8f62642) --- doc/admin-guide/files/records.config.en.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/doc/admin-guide/files/records.config.en.rst b/doc/admin-guide/files/records.config.en.rst index df76cb2..12b9971 100644 --- a/doc/admin-guide/files/records.config.en.rst +++ b/doc/admin-guide/files/records.config.en.rst @@ -3079,7 +3079,8 @@ SSL Termination The filename of the default and global ticket key for SSL sessions. The location is relative to the :ts:cv:`proxy.config.ssl.server.cert.path` directory. One way to generate this would be to run - ``head -c48 /dev/urandom | openssl enc -base64 | head -c48 > file.ticket``. + ``head -c48 /dev/urandom | openssl enc -base64 | head -c48 > file.ticket``. Also + note that OpenSSL session tickets are sensitive to the version of the ca-certificates. .. ts:cv:: CONFIG proxy.config.ssl.max_record_size INT 0 -- To stop receiving notification emails like this one, please contact ['"commits@trafficserver.apache.org" <commits@trafficserver.apache.org>'].
[trafficserver] branch 7.1.x updated: Fix naming of average aggregate function
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch 7.1.x in repository https://gitbox.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/7.1.x by this push: new 49e04d3 Fix naming of average aggregate function 49e04d3 is described below commit 49e04d3e6e514c7ddd168d436b92ce2db7274f94 Author: Manu J <manu.1...@gmail.com> AuthorDate: Fri Dec 22 15:12:51 2017 +0530 Fix naming of average aggregate function (cherry picked from commit 3629f864064eb82dff66d928e0331431ce695346) --- doc/admin-guide/logging/understanding.en.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/admin-guide/logging/understanding.en.rst b/doc/admin-guide/logging/understanding.en.rst index 2594632..387a6df 100644 --- a/doc/admin-guide/logging/understanding.en.rst +++ b/doc/admin-guide/logging/understanding.en.rst @@ -131,7 +131,7 @@ The aggregating functions available are: === === FunctionDescription === === -``AVERAGE`` Average (mean) of the given field's value from all events within +``AVG`` Average (mean) of the given field's value from all events within the interval. May only be used on numeric fields. ``COUNT`` The total count of events which occurred within the interval. No field name is necessary (``COUNT(*)`` may be used instead). -- To stop receiving notification emails like this one, please contact ['"commits@trafficserver.apache.org" <commits@trafficserver.apache.org>'].
[trafficserver] branch 7.1.x updated: Explain how # of parents relates to fail_threshold total_connect_attempts
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch 7.1.x in repository https://gitbox.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/7.1.x by this push: new 628e80b Explain how # of parents relates to fail_threshold total_connect_attempts 628e80b is described below commit 628e80bfb4bed9ed5cdb162fe4ae4bc9d716eefa Author: Miles Libbey <mlib...@apache.org> AuthorDate: Thu Aug 31 12:20:35 2017 -0700 Explain how # of parents relates to fail_threshold total_connect_attempts (cherry picked from commit 38d6891dcc4f69cf8a6d79b98b2dc6d20df192ce) --- doc/admin-guide/files/records.config.en.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/doc/admin-guide/files/records.config.en.rst b/doc/admin-guide/files/records.config.en.rst index 71d605a..df76cb2 100644 --- a/doc/admin-guide/files/records.config.en.rst +++ b/doc/admin-guide/files/records.config.en.rst @@ -1242,7 +1242,9 @@ Parent Proxy Configuration The total number of connection attempts for a specific transaction allowed to a parent cache before Traffic Server bypasses the parent or fails the request - (depending on the ``go_direct`` option in the :file:`parent.config` file). + (depending on the ``go_direct`` option in the :file:`parent.config` file). The + number of parents tried is + ``proxy.config.http.parent_proxy.fail_threshold / proxy.config.http.parent_proxy.total_connect_attempts`` .. ts:cv:: CONFIG proxy.config.http.parent_proxy.per_parent_connect_attempts INT 2 :reloadable: -- To stop receiving notification emails like this one, please contact ['"commits@trafficserver.apache.org" <commits@trafficserver.apache.org>'].
[trafficserver] branch 7.1.x updated: Add example command to generate session ticket
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch 7.1.x in repository https://gitbox.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/7.1.x by this push: new f655955 Add example command to generate session ticket f655955 is described below commit f655955be8157a99a3029b23279b5fe8fe43d7a5 Author: Miles Libbey <mlib...@apache.org> AuthorDate: Fri Jul 28 11:11:52 2017 -0700 Add example command to generate session ticket (cherry picked from commit bbc99e2d05ed645b22d5f326f9550d391fe97cd6) --- doc/admin-guide/files/records.config.en.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/doc/admin-guide/files/records.config.en.rst b/doc/admin-guide/files/records.config.en.rst index 8776917..71d605a 100644 --- a/doc/admin-guide/files/records.config.en.rst +++ b/doc/admin-guide/files/records.config.en.rst @@ -3076,7 +3076,8 @@ SSL Termination .. ts:cv:: CONFIG proxy.config.ssl.server.ticket_key.filename STRING ssl_ticket.key The filename of the default and global ticket key for SSL sessions. The location is relative to the - :ts:cv:`proxy.config.ssl.server.cert.path` directory. + :ts:cv:`proxy.config.ssl.server.cert.path` directory. One way to generate this would be to run + ``head -c48 /dev/urandom | openssl enc -base64 | head -c48 > file.ticket``. .. ts:cv:: CONFIG proxy.config.ssl.max_record_size INT 0 -- To stop receiving notification emails like this one, please contact ['"commits@trafficserver.apache.org" <commits@trafficserver.apache.org>'].
[trafficserver] branch master updated: Fix naming of average aggregate function
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new 3629f86 Fix naming of average aggregate function 3629f86 is described below commit 3629f864064eb82dff66d928e0331431ce695346 Author: Manu J <manu.1...@gmail.com> AuthorDate: Fri Dec 22 15:12:51 2017 +0530 Fix naming of average aggregate function --- doc/admin-guide/logging/understanding.en.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/admin-guide/logging/understanding.en.rst b/doc/admin-guide/logging/understanding.en.rst index 2594632..387a6df 100644 --- a/doc/admin-guide/logging/understanding.en.rst +++ b/doc/admin-guide/logging/understanding.en.rst @@ -131,7 +131,7 @@ The aggregating functions available are: === === FunctionDescription === === -``AVERAGE`` Average (mean) of the given field's value from all events within +``AVG`` Average (mean) of the given field's value from all events within the interval. May only be used on numeric fields. ``COUNT`` The total count of events which occurred within the interval. No field name is necessary (``COUNT(*)`` may be used instead). -- To stop receiving notification emails like this one, please contact ['"commits@trafficserver.apache.org" <commits@trafficserver.apache.org>'].
[trafficserver] branch master updated: Fix typo
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new 925ed8e Fix typo 925ed8e is described below commit 925ed8eb148151bc3c419c85cdabf73fd5362c46 Author: Benjamin Morel <benjamin.mo...@gmail.com> AuthorDate: Tue Dec 5 17:29:59 2017 +0100 Fix typo --- doc/admin-guide/files/storage.config.en.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/admin-guide/files/storage.config.en.rst b/doc/admin-guide/files/storage.config.en.rst index 6701830..d66a271 100644 --- a/doc/admin-guide/files/storage.config.en.rst +++ b/doc/admin-guide/files/storage.config.en.rst @@ -115,7 +115,7 @@ cache file with:: .. note:: When using on-filesystem cache disk storage, you can only have one such -directory specified. This will be address in a future version. +directory specified. This will be addressed in a future version. Solaris Example -- To stop receiving notification emails like this one, please contact ['"commits@trafficserver.apache.org" <commits@trafficserver.apache.org>'].
svn commit: r1020200 - in /websites/production/trafficserver: cgi-bin/ content/
Author: mlibbey Date: Sun Oct 29 18:10:37 2017 New Revision: 1020200 Log: Remove old news; update font and weird styling Added: websites/production/trafficserver/cgi-bin/ - copied from r1020198, websites/staging/trafficserver/trunk/cgi-bin/ websites/production/trafficserver/content/ - copied from r1020198, websites/staging/trafficserver/trunk/content/
svn commit: r1813699 - /trafficserver/site/trunk/content/index.html
Author: mlibbey Date: Sun Oct 29 17:50:08 2017 New Revision: 1813699 URL: http://svn.apache.org/viewvc?rev=1813699=rev Log: more jira->github Modified: trafficserver/site/trunk/content/index.html Modified: trafficserver/site/trunk/content/index.html URL: http://svn.apache.org/viewvc/trafficserver/site/trunk/content/index.html?rev=1813699=1813698=1813699=diff == --- trafficserver/site/trunk/content/index.html (original) +++ trafficserver/site/trunk/content/index.html Sun Oct 29 17:50:08 2017 @@ -159,7 +159,7 @@ - https://cwiki.apache.org/confluence/display/TS/Filing+useful+bug+reports;>Report or confirm bugs or try out the latest patches from our https://issues.apache.org/jira/browse/TS;>Bug Tracker + https://cwiki.apache.org/confluence/display/TS/Filing+useful+bug+reports;>Report or confirm bugs or try out the latest patches from our https://github.com/apache/trafficserver/;>Bug Tracker
svn commit: r1813698 - /trafficserver/site/trunk/content/index.html
Author: mlibbey Date: Sun Oct 29 17:47:53 2017 New Revision: 1813698 URL: http://svn.apache.org/viewvc?rev=1813698=rev Log: Bug tracking now in github Modified: trafficserver/site/trunk/content/index.html Modified: trafficserver/site/trunk/content/index.html URL: http://svn.apache.org/viewvc/trafficserver/site/trunk/content/index.html?rev=1813698=1813697=1813698=diff == --- trafficserver/site/trunk/content/index.html (original) +++ trafficserver/site/trunk/content/index.html Sun Oct 29 17:47:53 2017 @@ -192,7 +192,7 @@ - https://cwiki.apache.org/confluence/display/TS/Filing+useful+bug+reports;>Report issues or bring patches to our https://issues.apache.org/jira/browse/TS;>Bug Tracker + https://cwiki.apache.org/confluence/display/TS/Filing+useful+bug+reports;>Report issues or bring patches to our https://github.com/apache/trafficserver/;>Bug Tracker @@ -206,7 +206,6 @@ documentation and how to debug Apache Traffic Server. - Or just fix a random bug! We've https://github.com/apache/trafficserver/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22;>tagged github issues that have a low entrance barrier.
svn commit: r1813697 - /trafficserver/site/trunk/content/index.html
Author: mlibbey Date: Sun Oct 29 17:42:48 2017 New Revision: 1813697 URL: http://svn.apache.org/viewvc?rev=1813697=rev Log: Remove seemingly random bold tags. Modified: trafficserver/site/trunk/content/index.html Modified: trafficserver/site/trunk/content/index.html URL: http://svn.apache.org/viewvc/trafficserver/site/trunk/content/index.html?rev=1813697=1813696=1813697=diff == --- trafficserver/site/trunk/content/index.html (original) +++ trafficserver/site/trunk/content/index.html Sun Oct 29 17:42:48 2017 @@ -148,18 +148,18 @@ - Having trouble with builds, configurations or are you getting errors you don't understand? mailto:users-subscr...@trafficserver.apache.org;>Subscribe to our Users Mailing List or join our + Having trouble with builds, configurations or are you getting errors you don't understand? mailto:users-subscr...@trafficserver.apache.org;>Subscribe to our Users Mailing List or join our #traffic-server channel on http://freenode.net/; title= "Freenode IRC network">irc.freenode.net to get help! - Can't get your plugin to work? mailto:dev-subscr...@trafficserver.apache.org;>Get help from developers or + Can't get your plugin to work? mailto:dev-subscr...@trafficserver.apache.org;>Get help from developers or start a discussion on our dev discussion list. - https://cwiki.apache.org/confluence/display/TS/Filing+useful+bug+reports;>Report or confirm bugs or try out the latest patches from our https://issues.apache.org/jira/browse/TS;>Bug Tracker + https://cwiki.apache.org/confluence/display/TS/Filing+useful+bug+reports;>Report or confirm bugs or try out the latest patches from our https://issues.apache.org/jira/browse/TS;>Bug Tracker @@ -178,21 +178,21 @@ mailto:users-subscr...@trafficserver.apache.org;>Subscribe and - help out on the users Mailing List or simply share your usecase or experience. + help out on the users Mailing List or simply share your usecase or experience. For (hopefully) speedier responses check out our IRC channel #traffic-server on http://freenode.net/; title= "Freenode IRC network">irc.freenode.net. - Impress developers or help others by mailto:dev-subscr...@trafficserver.apache.org;>participating on + Impress developers or help others by mailto:dev-subscr...@trafficserver.apache.org;>participating on our dev discussion list or mailto:commits-subscr...@trafficserver.apache.org;>follow the latest development on our commits list. - https://cwiki.apache.org/confluence/display/TS/Filing+useful+bug+reports;>Report issues or bring patches to our https://issues.apache.org/jira/browse/TS;>Bug Tracker + https://cwiki.apache.org/confluence/display/TS/Filing+useful+bug+reports;>Report issues or bring patches to our https://issues.apache.org/jira/browse/TS;>Bug Tracker
svn commit: r1813696 - /trafficserver/site/trunk/content/styles/styles.css
Author: mlibbey Date: Sun Oct 29 17:32:20 2017 New Revision: 1813696 URL: http://svn.apache.org/viewvc?rev=1813696=rev Log: remove weird top whitespace Modified: trafficserver/site/trunk/content/styles/styles.css Modified: trafficserver/site/trunk/content/styles/styles.css URL: http://svn.apache.org/viewvc/trafficserver/site/trunk/content/styles/styles.css?rev=1813696=1813695=1813696=diff == --- trafficserver/site/trunk/content/styles/styles.css (original) +++ trafficserver/site/trunk/content/styles/styles.css Sun Oct 29 17:32:20 2017 @@ -126,7 +126,6 @@ a { #blurbbox { padding-left: 20px; padding-right: 20px; -padding-top: 20px; padding-bottom: 20px; }
svn commit: r1813695 - /trafficserver/site/trunk/content/index.html
Author: mlibbey Date: Sun Oct 29 17:31:48 2017 New Revision: 1813695 URL: http://svn.apache.org/viewvc?rev=1813695=rev Log: re-style initial blurb Modified: trafficserver/site/trunk/content/index.html Modified: trafficserver/site/trunk/content/index.html URL: http://svn.apache.org/viewvc/trafficserver/site/trunk/content/index.html?rev=1813695=1813694=1813695=diff == --- trafficserver/site/trunk/content/index.html (original) +++ trafficserver/site/trunk/content/index.html Sun Oct 29 17:31:48 2017 @@ -58,9 +58,9 @@ - Apache Traffic Server⢠software is a fast, scalable and extensible HTTP/1.1 and HTTP/2.0 compliant caching + Apache Traffic Server⢠software is a fast, scalable and extensible HTTP/1.1 and HTTP/2.0 compliant caching proxy server. Formerly a commercial product, Yahoo! donated it to the Apache -Foundation, and it is now an Apache TLP. Here's a http://ostatic.com/blog/guest-post-yahoos-cloud-team-open-sources-traffic-server;>Traffic Server overview.
svn commit: r1813694 - /trafficserver/site/trunk/content/index.html
Author: mlibbey Date: Sun Oct 29 17:23:30 2017 New Revision: 1813694 URL: http://svn.apache.org/viewvc?rev=1813694=rev Log: Clean up links, move old news to archive Modified: trafficserver/site/trunk/content/index.html Modified: trafficserver/site/trunk/content/index.html URL: http://svn.apache.org/viewvc/trafficserver/site/trunk/content/index.html?rev=1813694=1813693=1813694=diff == --- trafficserver/site/trunk/content/index.html (original) +++ trafficserver/site/trunk/content/index.html Sun Oct 29 17:23:30 2017 @@ -126,7 +126,7 @@ Proven Handling over 400TB a day at http://www.yahoo.com/;>Yahoo! both as forward and reverse proxies, Apache Traffic Server is battle - hardened. Also visit our Customers page (see link above) for + hardened. Also visit our Customers page for some of our corporate users and supporters. @@ -163,7 +163,7 @@ - Learn here how to ask good questions, create useful bug reports and how to apply patches. + https://cwiki.apache.org/confluence/display/TS/Filing+useful+bug+reports;>Learn how to ask good questions, create useful bug reports and how to apply patches. @@ -202,12 +202,12 @@ - Learn here how to create patches to the code or the - documentation and how to debug Apache Traffic Server.. + Learn https://cwiki.apache.org/confluence/display/TS/Contributing;>how to create patches to the code or the + documentation and how to debug Apache Traffic Server. Or just fix a random bug! - A low entrance barrier is helping us clean up our code: Fix http://people.apache.org/~igalic/checks/ats/latest/; target="_blank" title="Click here to see the latest clang build warnings">clang build warnings. + We've https://github.com/apache/trafficserver/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22;>tagged github issues that have a low entrance barrier. @@ -272,62 +272,6 @@ Nov 7, 2016: We are happy to announce our next major release, v7.0.0! This release includes HTTP/2 Push and many other features and bug fixes. - Jul 25, 2016: The latest stable release, v6.2.0, is now - available from the Downloads section. This is the LTS release for - 6.x - Feb 8, 2016: We have made an emergency release of ATS - v6.1.1, which fixes a few critical issues in v6.1.1. We encourage - everyone to upgrade from previous v6.x release to this version. - Jan 28, 2016: We are happy to announce the - release of our latest major release, v6.1.0! This is primarily a bug - fix release over v6.0.0, but adds a few interesting features.. - Sept 21, 2015: We are extremely pleased to announce the - release of our latest major release, v6.0.0! This is our second release - with HTTP/2 support. HTTP/2 support is now considered stable. - Sept 13, 2015: The latest stable release, v5.3.2, is now - available from the Downloads section. This is the LTS release for 5.x - July 4, 2015: The latest stable release, v5.3.1, is now - available from the Downloads section. This is the LTS release for 5.x - May 13, 2015: The latest stable release, v5.3.0, is now - available from the Downloads section. This is the LTS release for 5.x - March 30, 2015: The latest stable release, v5.2.1, is now - available from the Downloads section. This is a bug-fix release over - the previous v5.2.0 release. - February 3, 2015: A bug-fix release for v4.2 is now - available. Fetch the latest v4.2.3 tarballs from the Downloads section. - This is our LTS branch for 4.x. - January 14, 2015: We are pleased to announce the next - quarterly release, v5.2.0. It's as usual available from the - Downloads page. - December 16, 2014: 5.1.2 is a security update for - 5.1.1. We urge everyone to upgrade from 5.1.0 or 5.1.1 to 5.1.2 as - soon as possible. - October 31, 2014: 5.1.1 is a security update for 5.1.0. We - urge everyone to upgrade from 5.1.0 to 5.1.1 as soon as possible. See - CVE-2014-3566 and CVE-2014-3624. - September 18, 2014: We are pleased to announce the relase - of our quarterly minor release, v5.1.0. It's available from our - Downloads page. - September 08, 2014: The old, legacy release of ATS, - v3.2.x, is no longer supported. We have removed it from the - download site, but it is available via the ar
svn commit: r1813693 - /trafficserver/site/trunk/content/newsarchive.mdtext
Author: mlibbey Date: Sun Oct 29 17:23:01 2017 New Revision: 1813693 URL: http://svn.apache.org/viewvc?rev=1813693=rev Log: Add old news to archive Modified: trafficserver/site/trunk/content/newsarchive.mdtext Modified: trafficserver/site/trunk/content/newsarchive.mdtext URL: http://svn.apache.org/viewvc/trafficserver/site/trunk/content/newsarchive.mdtext?rev=1813693=1813692=1813693=diff == --- trafficserver/site/trunk/content/newsarchive.mdtext (original) +++ trafficserver/site/trunk/content/newsarchive.mdtext Sun Oct 29 17:23:01 2017 @@ -19,6 +19,62 @@ Notice:Licensed to the Apache Softwa # Apache Traffic Server News Archive # +* **Jul 25, 2016:** The latest stable release, v6.2.0, is now +available from the Downloads section. This is the LTS release for +6.x +* **Feb 8, 2016:** We have made an emergency release of ATS +v6.1.1, which fixes a few critical issues in v6.1.1. We encourage +everyone to upgrade from previous v6.x release to this version. +* **Jan 28, 2016:** We are happy to announce the +release of our latest major release, v6.1.0! This is primarily a bug +fix release over v6.0.0, but adds a few interesting features.. +* **Sept 21, 2015:** We are extremely pleased to announce the +release of our latest major release, v6.0.0! This is our second release +with HTTP/2 support. HTTP/2 support is now considered stable. +* **Sept 13, 2015:** The latest stable release, v5.3.2, is now +available from the Downloads section. This is the LTS release for 5.x +* **July 4, 2015:** The latest stable release, v5.3.1, is now +available from the Downloads section. This is the LTS release for 5.x +* **May 13, 2015:** The latest stable release, v5.3.0, is now +available from the Downloads section. This is the LTS release for 5.x +* **March 30, 2015:** The latest stable release, v5.2.1, is now +available from the Downloads section. This is a bug-fix release over +the previous v5.2.0 release. +* **February 3, 2015:** A bug-fix release for v4.2 is now +available. Fetch the latest v4.2.3 tarballs from the Downloads section. +This is our LTS branch for 4.x. +* **January 14, 2015:** We are pleased to announce the next +quarterly release, v5.2.0. It's as usual available from the +Downloads page. +* **December 16, 2014:** 5.1.2 is a security update for +5.1.1. We urge everyone to upgrade from 5.1.0 or 5.1.1 to 5.1.2 as +soon as possible. +* **October 31, 2014:** 5.1.1 is a security update for 5.1.0. We +urge everyone to upgrade from 5.1.0 to 5.1.1 as soon as possible. See +CVE-2014-3566 and CVE-2014-3624. +* **September 18, 2014:** We are pleased to announce the relase +of our quarterly minor release, v5.1.0. It's available from our +Downloads page. +* **September 08, 2014:** The old, legacy release of ATS, +v3.2.x, is no longer supported. We have removed it from the +download site, but it is available via the archives. We urge +everyone to migrate to v4.2.x or 5.x as soon as possible. +* **September 04, 2014:** A bug-fix release for v4.2 is now +available. Fetch the latest v4.2.2 tarballs from the Downloads section. +This is our LTS branch for 4.x. +* **July 23, 2014:** A security flaw in handling of healthchecks +was discovered, affecting all versions of ATS. We urge everyone to +upgrade to v4.2.1.1 or v5.0.1 immediately. See CVE-2014-3525 for +details. +* **June 17, 2014:** We are extremely pleased to announce the +release of our latest major release, v5.0.0! This has been a year +in the making, and includes a number of new features and bug fixes. +* **April 29, 2014:** A bug-fix release for v4.2 is now +available. Fetch the latest v4.2.1 tarballs from the Downloads section. +This is our LTS branch for 4.x. +* **March 19, 2014:** A minor release for v4.x is now +available. Fetch the latest v4.2.0 builds from the Downloads section. +This is our LTS branch for 4.x. * **December 17, 2013:** A bug fix release for v4.x is now available. Fetch the latest v4.1.2 builds from the Downloads section. * **October 4, 2013:** A bug fix release for v4.0.x is now
svn commit: r1813690 - /trafficserver/site/trunk/content/styles/styles.css
Author: mlibbey Date: Sun Oct 29 16:23:37 2017 New Revision: 1813690 URL: http://svn.apache.org/viewvc?rev=1813690=rev Log: serif fonts are too busy for this text Modified: trafficserver/site/trunk/content/styles/styles.css Modified: trafficserver/site/trunk/content/styles/styles.css URL: http://svn.apache.org/viewvc/trafficserver/site/trunk/content/styles/styles.css?rev=1813690=1813689=1813690=diff == --- trafficserver/site/trunk/content/styles/styles.css (original) +++ trafficserver/site/trunk/content/styles/styles.css Sun Oct 29 16:23:37 2017 @@ -29,12 +29,12 @@ INDEX /* 1. HTML, BODY, CONTENT */ html { -font-family: Georgia, "Droid Serif", serif; +font-family: arial,sans-serif; background: url('/images/grey_paper.jpg'); } body { -font-size: 10pt; +font-size: 12pt; } .content {
svn commit: r1813688 - /trafficserver/site/trunk/content/index.html
Author: mlibbey Date: Sun Oct 29 16:15:32 2017 New Revision: 1813688 URL: http://svn.apache.org/viewvc?rev=1813688=rev Log: Security announcements are for EOL'ed versions. Modified: trafficserver/site/trunk/content/index.html Modified: trafficserver/site/trunk/content/index.html URL: http://svn.apache.org/viewvc/trafficserver/site/trunk/content/index.html?rev=1813688=1813687=1813688=diff == --- trafficserver/site/trunk/content/index.html (original) +++ trafficserver/site/trunk/content/index.html Sun Oct 29 16:15:32 2017 @@ -58,24 +58,11 @@ -Apache Traffic Server⢠software is a fast, scalable and extensible HTTP/1.1 compliant caching + Apache Traffic Server⢠software is a fast, scalable and extensible HTTP/1.1 and HTTP/2.0 compliant caching proxy server. Formerly a commercial product, Yahoo! donated it to the Apache Foundation, and it is now an Apache TLP. Here's a http://ostatic.com/blog/guest-post-yahoos-cloud-team-open-sources-traffic-server;>Traffic Server overview. - -Important security announcements: - - All versions of Traffic Server prior to v5.0.1 (or v4.2.1.1) have a vulnerability related to - the synthetic health checks as used by traffic_cop. We urge everyone - to upgrade to the latest releases, either v4.2.1.1 or v5.1.2. See - CVE-2014-3525 for some details. - - - Traffic Server 5.1.0 has a security issue that can lead to acting as an open relay under specific circumstances. - Traffic Server 5.1.1 has a security issue which makes it vulnerable to denial of service attacks. - We urge all deployments of 5.1.0 and 5.1.1 to upgrade to 5.1.2. See CVE-2014-3624 and TS-2677 for more detail. -
[trafficserver] branch master updated: Explain how # of parents relates to fail_threshold total_connect_attempts
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new 38d6891 Explain how # of parents relates to fail_threshold total_connect_attempts 38d6891 is described below commit 38d6891dcc4f69cf8a6d79b98b2dc6d20df192ce Author: Miles Libbey <mlib...@apache.org> AuthorDate: Thu Aug 31 12:20:35 2017 -0700 Explain how # of parents relates to fail_threshold total_connect_attempts --- doc/admin-guide/files/records.config.en.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/doc/admin-guide/files/records.config.en.rst b/doc/admin-guide/files/records.config.en.rst index af15a77..4074f22 100644 --- a/doc/admin-guide/files/records.config.en.rst +++ b/doc/admin-guide/files/records.config.en.rst @@ -1257,7 +1257,9 @@ Parent Proxy Configuration The total number of connection attempts for a specific transaction allowed to a parent cache before Traffic Server bypasses the parent or fails the request - (depending on the ``go_direct`` option in the :file:`parent.config` file). + (depending on the ``go_direct`` option in the :file:`parent.config` file). The + number of parents tried is + ``proxy.config.http.parent_proxy.fail_threshold / proxy.config.http.parent_proxy.total_connect_attempts`` .. ts:cv:: CONFIG proxy.config.http.parent_proxy.per_parent_connect_attempts INT 2 :reloadable: -- To stop receiving notification emails like this one, please contact ['"commits@trafficserver.apache.org" <commits@trafficserver.apache.org>'].
[trafficserver] branch master updated: Session ticket resumption needs consistent CA-certificate version
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new 7c05be8 Session ticket resumption needs consistent CA-certificate version 7c05be8 is described below commit 7c05be8f1a2c0eb7b8a46882ac2abb92b8f62642 Author: Miles Libbey <mlib...@apache.org> AuthorDate: Mon Aug 14 15:22:19 2017 -0700 Session ticket resumption needs consistent CA-certificate version OpenSSL session tickets are sensitive to the version of the ca-certificates OEL/RHEL package. We had ~200 machines with 1 version of ca-certificates-... , and the rest with another version. Sessions generated with the “old” ca-cerficates do not resume with the newer CAs (and vice versa). Hoping other can avoid this confusion with this note. --- doc/admin-guide/files/records.config.en.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/doc/admin-guide/files/records.config.en.rst b/doc/admin-guide/files/records.config.en.rst index 939d17d..933a8fc 100644 --- a/doc/admin-guide/files/records.config.en.rst +++ b/doc/admin-guide/files/records.config.en.rst @@ -3133,7 +3133,8 @@ SSL Termination The filename of the default and global ticket key for SSL sessions. The location is relative to the :ts:cv:`proxy.config.ssl.server.cert.path` directory. One way to generate this would be to run - ``head -c48 /dev/urandom | openssl enc -base64 | head -c48 > file.ticket``. + ``head -c48 /dev/urandom | openssl enc -base64 | head -c48 > file.ticket``. Also + note that OpenSSL session tickets are sensitive to the version of the ca-certificates. .. ts:cv:: CONFIG proxy.config.ssl.max_record_size INT 0 -- To stop receiving notification emails like this one, please contact ['"commits@trafficserver.apache.org" <commits@trafficserver.apache.org>'].
[trafficserver] branch master updated: Add example command to generate session ticket
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new bbc99e2 Add example command to generate session ticket bbc99e2 is described below commit bbc99e2d05ed645b22d5f326f9550d391fe97cd6 Author: Miles Libbey <mlib...@apache.org> AuthorDate: Fri Jul 28 11:11:52 2017 -0700 Add example command to generate session ticket --- doc/admin-guide/files/records.config.en.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/doc/admin-guide/files/records.config.en.rst b/doc/admin-guide/files/records.config.en.rst index 45b716b..939d17d 100644 --- a/doc/admin-guide/files/records.config.en.rst +++ b/doc/admin-guide/files/records.config.en.rst @@ -3132,7 +3132,8 @@ SSL Termination .. ts:cv:: CONFIG proxy.config.ssl.server.ticket_key.filename STRING ssl_ticket.key The filename of the default and global ticket key for SSL sessions. The location is relative to the - :ts:cv:`proxy.config.ssl.server.cert.path` directory. + :ts:cv:`proxy.config.ssl.server.cert.path` directory. One way to generate this would be to run + ``head -c48 /dev/urandom | openssl enc -base64 | head -c48 > file.ticket``. .. ts:cv:: CONFIG proxy.config.ssl.max_record_size INT 0 -- To stop receiving notification emails like this one, please contact ['"commits@trafficserver.apache.org" <commits@trafficserver.apache.org>'].
[trafficserver] branch master updated: Add diagram for header_rewrite Hooks
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new 156c218 Add diagram for header_rewrite Hooks 156c218 is described below commit 156c2184630ae9de36d4218d796dc4077c2d4e13 Author: Miles Libbey <mlib...@apache.org> AuthorDate: Fri Jul 14 11:27:37 2017 -0700 Add diagram for header_rewrite Hooks --- doc/admin-guide/plugins/header_rewrite.en.rst | 18 ++ 1 file changed, 18 insertions(+) diff --git a/doc/admin-guide/plugins/header_rewrite.en.rst b/doc/admin-guide/plugins/header_rewrite.en.rst index 418498c..7eb9684 100644 --- a/doc/admin-guide/plugins/header_rewrite.en.rst +++ b/doc/admin-guide/plugins/header_rewrite.en.rst @@ -881,6 +881,24 @@ them take any operands:: Because hook conditions must be the first condition in a ruleset, the use of one forces the beginning of a new ruleset. +.. graphviz:: + :alt: header rewrite hooks + + digraph header_rewrite_hooks { + graph [rankdir = LR]; + node[shape=record]; + + Client[height=4, label="{ Client|{|} }"]; + ATS[height=4, fontsize=10,label="{ {{Global:\nREAD_REQUEST_PRE_REMAP_HOOK|Global:\nREAD_REQUEST_HDR_HOOK\nRemap rule:\nREMAP_PSEUDO_HOOK}|SEND_RESPONSE_HDR_HOOK}|ATS |{SEND_REQUEST_HDR_HOOK|READ_RESPONSE_HDR_HOOK} }",xlabel="ATS"]; + Origin[height=4, label="{ {|}|Origin }"]; + + Client:p1 -> ATS:clientside0 [ label = "Request" ]; + ATS:originside0 -> Origin:request [ label="proxied request" ]; + + Origin:response -> ATS:originside1 [ label="origin response" ]; + ATS:clientside1 -> Client:p2 [ label = "Response" ]; + } + READ_REQUEST_HDR_HOOK ~ -- To stop receiving notification emails like this one, please contact ['"commits@trafficserver.apache.org" <commits@trafficserver.apache.org>'].
[trafficserver] branch master updated: Add HSTS example to header_rewrite
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new f389fd5 Add HSTS example to header_rewrite f389fd5 is described below commit f389fd554d3d84bc17a244a6a37fb5794466e7db Author: Miles Libbey <mlib...@apple.com> AuthorDate: Mon Jun 12 10:15:26 2017 -0700 Add HSTS example to header_rewrite Support HSTS preloading #1735 --- doc/admin-guide/plugins/header_rewrite.en.rst | 9 + 1 file changed, 9 insertions(+) diff --git a/doc/admin-guide/plugins/header_rewrite.en.rst b/doc/admin-guide/plugins/header_rewrite.en.rst index b4a77d8..9568013 100644 --- a/doc/admin-guide/plugins/header_rewrite.en.rst +++ b/doc/admin-guide/plugins/header_rewrite.en.rst @@ -1089,3 +1089,12 @@ already set to some value, and the status code is a 2xx:: cond %{STATUS} >199 [AND] cond %{STATUS} <300 set-header Cache-Control "max-age=600, public" + +Add HSTS + + +Add the HTTP Strict Transport Security (HSTS) header if it does not exist: :: + +cond %{READ_RESPONSE_HDR_HOOK} [AND] +cond %{HEADER:Strict-Transport-Security} ="" +set-header Strict-Transport-Security "Strict-Transport-Security: max-age=63072000; includeSubDomains; preload" -- To stop receiving notification emails like this one, please contact ['"commits@trafficserver.apache.org" <commits@trafficserver.apache.org>'].
svn commit: r1014061 - in /websites/production/trafficserver: cgi-bin/ content/
Author: mlibbey Date: Thu Jun 15 05:05:43 2017 New Revision: 1014061 Log: issues link headers Added: websites/production/trafficserver/cgi-bin/ - copied from r1014060, websites/staging/trafficserver/trunk/cgi-bin/ websites/production/trafficserver/content/ - copied from r1014060, websites/staging/trafficserver/trunk/content/
svn commit: r1798791 - in /trafficserver/site/trunk: README content/index.html templates/docs_page.html templates/full_page.html
Author: mlibbey Date: Thu Jun 15 04:59:33 2017 New Revision: 1798791 URL: http://svn.apache.org/viewvc?rev=1798791=rev Log: Update issues links in menu bars Modified: trafficserver/site/trunk/README trafficserver/site/trunk/content/index.html trafficserver/site/trunk/templates/docs_page.html trafficserver/site/trunk/templates/full_page.html Modified: trafficserver/site/trunk/README URL: http://svn.apache.org/viewvc/trafficserver/site/trunk/README?rev=1798791=1798790=1798791=diff == --- trafficserver/site/trunk/README (original) +++ trafficserver/site/trunk/README Thu Jun 15 04:59:33 2017 @@ -48,7 +48,7 @@ You might want to replace `igalic` with For the curious, or those doing heavy modification, sometimes it is -necessary or beneficial to see the changes locally, before of commiting +necessary or beneficial to see the changes locally, before of committing every single change to staging. The following are instructions for that case: @@ -76,7 +76,7 @@ You can now attempt to build the site: Publishing the Site === -In order to publish the site, we recommand, for convinience to symlink +In order to publish the site, we recommend, for convenience to symlink the publishing script into this checkout's working copy: $ ln -s ../cms/webgui/publish.pl @@ -90,4 +90,3 @@ You will be prompted for your password. a diff between staging HTML and the current live content. You can write a witty commit message, and send it off. Thanks to SvnPubSub it will automatically replicate on both mirrors. - Modified: trafficserver/site/trunk/content/index.html URL: http://svn.apache.org/viewvc/trafficserver/site/trunk/content/index.html?rev=1798791=1798790=1798791=diff == --- trafficserver/site/trunk/content/index.html (original) +++ trafficserver/site/trunk/content/index.html Thu Jun 15 04:59:33 2017 @@ -41,7 +41,7 @@ Downloads https://docs.trafficserver.apache.org/en/latest/index.html;>Documentation https://cwiki.apache.org/confluence/display/TS/Apache+Traffic+Server;>Wiki - https://issues.apache.org/jira/browse/TS;>Issues + https://github.com/apache/trafficserver/issues;>Issues https://ci.trafficserver.apache.org/;>CI Customers Acknowledgements @@ -338,7 +338,7 @@ - https://github.com/apache/trafficserver/;>View Git code repository + https://git-dual.apache.org/repos/asf?p=trafficserver.git;>View Git code repository https://cwiki.apache.org/confluence/display/TS/Apache+Traffic+Server+AMIs+for+EC2;>TrafficServer AMI for EC2 https://cwiki.apache.org/confluence/display/TS/Supported+Operating+Systems;>Supported Operating Systems Modified: trafficserver/site/trunk/templates/docs_page.html URL: http://svn.apache.org/viewvc/trafficserver/site/trunk/templates/docs_page.html?rev=1798791=1798790=1798791=diff == --- trafficserver/site/trunk/templates/docs_page.html (original) +++ trafficserver/site/trunk/templates/docs_page.html Thu Jun 15 04:59:33 2017 @@ -53,7 +53,7 @@ {% if lang %} -
svn commit: r1798790 - /trafficserver/site/trunk/content/index.html
Author: mlibbey Date: Thu Jun 15 04:44:03 2017 New Revision: 1798790 URL: http://svn.apache.org/viewvc?rev=1798790=rev Log: repo url and copyright year update Modified: trafficserver/site/trunk/content/index.html Modified: trafficserver/site/trunk/content/index.html URL: http://svn.apache.org/viewvc/trafficserver/site/trunk/content/index.html?rev=1798790=1798789=1798790=diff == --- trafficserver/site/trunk/content/index.html (original) +++ trafficserver/site/trunk/content/index.html Thu Jun 15 04:44:03 2017 @@ -338,7 +338,7 @@ - https://git-dual.apache.org/repos/asf?p=trafficserver.git;>View Git code repository + https://github.com/apache/trafficserver/;>View Git code repository https://cwiki.apache.org/confluence/display/TS/Apache+Traffic+Server+AMIs+for+EC2;>TrafficServer AMI for EC2 https://cwiki.apache.org/confluence/display/TS/Supported+Operating+Systems;>Supported Operating Systems @@ -361,7 +361,7 @@ - Copyright 2013 + Copyright 2017 http://www.apache.org/;>The Apache Software Foundation. Licensed under the http://www.apache.org/licenses/;>Apache License,
svn commit: r1014057 - in /websites/production/trafficserver: cgi-bin/ content/
Author: mlibbey Date: Thu Jun 15 04:16:49 2017 New Revision: 1014057 Log: try publishing again Added: websites/production/trafficserver/cgi-bin/ - copied from r1014056, websites/staging/trafficserver/trunk/cgi-bin/ websites/production/trafficserver/content/ - copied from r1014056, websites/staging/trafficserver/trunk/content/
[trafficserver] branch master updated: Clarify/expand gzip plugin usage
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new 999ed89 Clarify/expand gzip plugin usage 999ed89 is described below commit 999ed89ee01aae12af48a9c932b8ee052038f2dd Author: Miles Libbey <mlib...@apple.com> AuthorDate: Mon Jun 12 15:06:12 2017 -0700 Clarify/expand gzip plugin usage --- doc/admin-guide/plugins/gzip.en.rst | 31 ++- 1 file changed, 22 insertions(+), 9 deletions(-) diff --git a/doc/admin-guide/plugins/gzip.en.rst b/doc/admin-guide/plugins/gzip.en.rst index 2283f26..b413a00 100644 --- a/doc/admin-guide/plugins/gzip.en.rst +++ b/doc/admin-guide/plugins/gzip.en.rst @@ -82,9 +82,9 @@ configuration provided with the plugin's source):: gzip.so /sample.gzip.config This can be used as remap plugin by pointing to config file in remap rule -:file:`remap.config`:: +:file:`remap.config`:: (relative to the ts:cv:`proxy.config.config_dir`) -@plugin=gzip.so @pparam=/sample.gzip.config +@plugin=gzip.so @pparam=sample.gzip.config The following sections detail the options you may specify in the plugin's configuration file. Options may be used globally, or may be specified on a @@ -124,7 +124,8 @@ Provides a wildcard pattern which will be applied to request URLs. Any which match the pattern will be considered compressible, and only deflated versions of the objects will be cached and returned to clients. This may be useful for objects which already have their own compression built-in, to avoid the expense -of multiple rounds of compression for trivial gains. +of multiple rounds of compression for trivial gains. If the regex is preceeded by +``!`` (for example ``allow !*/nothere/*``), it disables the plugin from those machine URLs. enabled --- @@ -136,13 +137,14 @@ flush - Enables (``true``) or disables (``false``) flushing of compressed objects to -clients. +clients. This calls the compression algorithm's mechanism (Z_SYNC_FLUSH and for gzip +and BROTLI_OPERATION_FLUSH for brotli) to send compressed data early. remove-accept-encoding -- When set to ``true`` this option causes the plugin to strip the request's -``Accept`` encoding header when contacting the origin server. Setting this option to ``false`` +``Accept-Encoding`` header when contacting the origin server. Setting this option to ``false`` will leave the header intact if the client provided it. - To ease the load on the origins. @@ -153,10 +155,11 @@ will leave the header intact if the client provided it. supported-algorithms -- -Provides the compression algorithms that are supported. This will allow the proxy to selectively -support certain compressions. The default is gzip. Multiple algorthims can be selected using ',' delimiter - --- To selectively support only certain compression algorithms. +Provides the compression algorithms that are supported. This will allow |TS| to selectively +support gzip, deflate, and brotli compression. The default is gzip. Multiple algorthims can be selected using ',' delimiter, +for instance, ``supported-algorithms deflate,gzip,br``. Note that if +ts:cv:`proxy.config.http.normalize_ae_gzip` is enabled (``1``), only gzip will be +considered. Examples @@ -205,3 +208,13 @@ the plugin would be enabled for |TS| in :file:`plugin.config` as:: gzip.so /etc/trafficserver/gzip.config +Alternatively, the gzip plugin can be used as a remap plugin: :: + + map http://www.example.com http://origin.example.com \ +@plugin=gzip.so @pparam=gzip.config + +$ cat /etc/trafficserver/gzip.config +enabled true +cache true +compressible-content-type *xml +supported-algorithms -- To stop receiving notification emails like this one, please contact ['"commits@trafficserver.apache.org" <commits@trafficserver.apache.org>'].
svn commit: r1013993 - in /websites/production/trafficserver: cgi-bin/ content/
Author: mlibbey Date: Tue Jun 13 17:18:06 2017 New Revision: 1013993 Log: updating copyright and git link Added: websites/production/trafficserver/cgi-bin/ - copied from r1013992, websites/staging/trafficserver/trunk/cgi-bin/ websites/production/trafficserver/content/ - copied from r1013992, websites/staging/trafficserver/trunk/content/
[trafficserver] branch master updated: proxy.config.diags.debug.enabled is reloadable
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new c1303d4 proxy.config.diags.debug.enabled is reloadable c1303d4 is described below commit c1303d41435d55d5c7f20a2fc1af405b8ca70627 Author: Miles Libbey <mlib...@apple.com> AuthorDate: Wed May 17 10:34:43 2017 -0700 proxy.config.diags.debug.enabled is reloadable --- doc/admin-guide/files/records.config.en.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/doc/admin-guide/files/records.config.en.rst b/doc/admin-guide/files/records.config.en.rst index 06a311d..6fea643 100644 --- a/doc/admin-guide/files/records.config.en.rst +++ b/doc/admin-guide/files/records.config.en.rst @@ -2915,6 +2915,7 @@ Diagnostic Logging Configuration for Debug() messages only. Set to 2 to enable for all messages. .. ts:cv:: CONFIG proxy.config.diags.debug.enabled INT 0 + :reloadable: Enables logging for diagnostic messages whose log level is `diag` or `debug`. -- To stop receiving notification emails like this one, please contact ['"commits@trafficserver.apache.org" <commits@trafficserver.apache.org>'].
[trafficserver] branch master updated: Reorder milestones to be in start to finish order
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new 6c84242 Reorder milestones to be in start to finish order 6c84242 is described below commit 6c84242ab7ac7b82aa6508085f6c8f05ca6a81d7 Author: Miles Libbey <mlib...@apache.org> AuthorDate: Mon Apr 17 13:37:52 2017 -0700 Reorder milestones to be in start to finish order Some of the milestones can happen in parrallel, but this order matches the order of events seen in log tests. --- .../api/functions/TSHttpTxnMilestoneGet.en.rst | 22 +++--- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/doc/developer-guide/api/functions/TSHttpTxnMilestoneGet.en.rst b/doc/developer-guide/api/functions/TSHttpTxnMilestoneGet.en.rst index e45f3c9..c806321 100644 --- a/doc/developer-guide/api/functions/TSHttpTxnMilestoneGet.en.rst +++ b/doc/developer-guide/api/functions/TSHttpTxnMilestoneGet.en.rst @@ -45,27 +45,27 @@ is successful. === == Value Milestone === == +:const:`TS_MILESTONE_SM_START` Transaction state machine is initialized. :const:`TS_MILESTONE_UA_BEGIN` The client connection is accepted. +:const:`TS_MILESTONE_PLUGIN_ACTIVE` Amount of time plugins were active plus start time. +:const:`TS_MILESTONE_PLUGIN_TOTAL` Wall time while plugins were active plus start time. :const:`TS_MILESTONE_UA_READ_HEADER_DONE` The request header from the client has been read and parsed. -:const:`TS_MILESTONE_UA_BEGIN_WRITE`The response header write to the client starts. -:const:`TS_MILESTONE_UA_CLOSE` Last I/O activity on the client socket, or connection abort. +:const:`TS_MILESTONE_CACHE_OPEN_READ_BEGIN` Initiate read of the cache. +:const:`TS_MILESTONE_CACHE_OPEN_READ_END` Initial cache read has resolved. +:const:`TS_MILESTONE_CACHE_OPEN_WRITE_BEGIN`Start open for cache write. +:const:`TS_MILESTONE_CACHE_OPEN_WRITE_END` Cache has been opened for write. +:const:`TS_MILESTONE_DNS_LOOKUP_BEGIN` Initiate host resolution in HostDB +:const:`TS_MILESTONE_DNS_LOOKUP_END`Host resolution resolves. :const:`TS_MILESTONE_SERVER_FIRST_CONNECT` First time origin server connect attempted or shared shared session attached. :const:`TS_MILESTONE_SERVER_CONNECT`Most recent time origin server connect attempted or shared session attached. :const:`TS_MILESTONE_SERVER_CONNECT_END`More recent time a connection attempt was resolved. :const:`TS_MILESTONE_SERVER_BEGIN_WRITE`First byte is written to the origin server connection. :const:`TS_MILESTONE_SERVER_FIRST_READ` First byte is read from connection to origin server. :const:`TS_MILESTONE_SERVER_READ_HEADER_DONE` Origin server response has been read and parsed. +:const:`TS_MILESTONE_UA_BEGIN_WRITE`The response header write to the client starts. :const:`TS_MILESTONE_SERVER_CLOSE` Last I/O activity on origin server connection. -:const:`TS_MILESTONE_CACHE_OPEN_READ_BEGIN` Initiate read of the cache. -:const:`TS_MILESTONE_CACHE_OPEN_READ_END` Initial cache read has resolved. -:const:`TS_MILESTONE_CACHE_OPEN_WRITE_BEGIN`Start open for cache write. -:const:`TS_MILESTONE_CACHE_OPEN_WRITE_END` Cache has been opened for write. -:const:`TS_MILESTONE_DNS_LOOKUP_BEGIN` Initiate host resolution in HostDB -:const:`TS_MILESTONE_DNS_LOOKUP_END`Host resolution resolves. -:const:`TS_MILESTONE_SM_START` Transaction state machine is initialized. +:const:`TS_MILESTONE_UA_CLOSE` Last I/O activity on the client socket, or connection abort. :const:`TS_MILESTONE_SM_FINISH` Transaction has finished, state machine final logging has started. -:const:`TS_MILESTONE_PLUGIN_ACTIVE` Amount of time plugins were active plus start time. -:const:`TS_MILESTONE_PLUGIN_TOTAL` Wall time while plugins were active plus start time. === == * The server connect times predate the transmission of the :literal:`SYN` -- To stop receiving notification emails like this one, please contact ['"commits@trafficserver.apache.org" <commits@trafficserver.apache.org>'].
[trafficserver] branch master updated: Extraneous backtick
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new 1f12290 Extraneous backtick 1f12290 is described below commit 1f12290a01fbf5ccb7954d1a7eded0b9a7799afd Author: Miles Libbey <mlib...@apache.org> AuthorDate: Mon Apr 17 12:20:51 2017 -0700 Extraneous backtick --- doc/developer-guide/api/functions/TSHttpTxnMilestoneGet.en.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/developer-guide/api/functions/TSHttpTxnMilestoneGet.en.rst b/doc/developer-guide/api/functions/TSHttpTxnMilestoneGet.en.rst index 76f92fa..e45f3c9 100644 --- a/doc/developer-guide/api/functions/TSHttpTxnMilestoneGet.en.rst +++ b/doc/developer-guide/api/functions/TSHttpTxnMilestoneGet.en.rst @@ -68,7 +68,7 @@ Value Milestone :const:`TS_MILESTONE_PLUGIN_TOTAL` Wall time while plugins were active plus start time. === == -* The server connect times predate the transmission of the `:literal:`SYN` +* The server connect times predate the transmission of the :literal:`SYN` packet. That is, before a connection to the origin server is completed. * A connection attempt is resolved when no more connection related activity -- To stop receiving notification emails like this one, please contact ['"commits@trafficserver.apache.org" <commits@trafficserver.apache.org>'].
[trafficserver] branch master updated: Negative_revalidating clarifications
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new bd03e60 Negative_revalidating clarifications bd03e60 is described below commit bd03e60d6ceaca19720613b93018212ea0df4259 Author: Miles Libbey <mlib...@apache.org> AuthorDate: Fri Mar 31 16:18:04 2017 -0700 Negative_revalidating clarifications --- doc/admin-guide/files/records.config.en.rst | 6 +- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/doc/admin-guide/files/records.config.en.rst b/doc/admin-guide/files/records.config.en.rst index 73416f1..3580d2d 100644 --- a/doc/admin-guide/files/records.config.en.rst +++ b/doc/admin-guide/files/records.config.en.rst @@ -1598,15 +1598,19 @@ Negative Response Caching :ts:cv:`proxy.config.http.negative_caching_lifetime`. .. ts:cv:: CONFIG proxy.config.http.negative_caching_lifetime INT 1800 + :reloadable: :overridable: How long (in seconds) Traffic Server keeps the negative responses valid in cache. This value only affects negative responses that do NOT have explicit ``Expires:`` or ``Cache-Control:`` lifetimes set by the server. .. ts:cv:: CONFIG proxy.config.http.negative_revalidating_enabled INT 0 + :reloadable: + :overridable: Enables (``1``) or disables (``0``) forcing revalidation of cached documents - when |TS| receives a negative (``5xx`` only) response from the origin server. + when |TS| receives a negative (``5xx`` only) response from the origin server. That is, + when enabled, |TS| will serve stale when it can not reach the origin server. .. ts:cv:: CONFIG proxy.config.http.negative_revalidating_lifetime INT 1800 -- To stop receiving notification emails like this one, please contact ['"commits@trafficserver.apache.org" <commits@trafficserver.apache.org>'].
[trafficserver] branch master updated: Regex needs to escape /
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new 61c34c4 Regex needs to escape / 61c34c4 is described below commit 61c34c42ac7e3668829fefe87c22cee4c7ba7516 Author: Miles Libbey <mlib...@apache.org> AuthorDate: Thu Mar 9 12:33:47 2017 -0800 Regex needs to escape / --- doc/admin-guide/plugins/header_rewrite.en.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/admin-guide/plugins/header_rewrite.en.rst b/doc/admin-guide/plugins/header_rewrite.en.rst index 4e0b4a4..7071fbe 100644 --- a/doc/admin-guide/plugins/header_rewrite.en.rst +++ b/doc/admin-guide/plugins/header_rewrite.en.rst @@ -1024,7 +1024,7 @@ two different file paths.:: cond %{PATH} /examplepath1/ add-header Cache-Control "max-age=3600" [L] cond %{SEND_RESPONSE_HDR_HOOK} -cond %{PATH} /examplepath2/examplepath3/.*/ +cond %{PATH} /examplepath2\/examplepath3\/.*/ add-header Cache-Control "no-cache" [L] Redirect when the Origin Server Times Out -- To stop receiving notification emails like this one, please contact ['"commits@trafficserver.apache.org" <commits@trafficserver.apache.org>'].
[trafficserver] branch master updated: Typos in cache key plugin doc
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://git-dual.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new c9c4ca5 Typos in cache key plugin doc c9c4ca5 is described below commit c9c4ca566797bf0a1ae433f6b6776fb3bf87d24a Author: Miles Libbey <mlib...@apache.org> AuthorDate: Fri Feb 24 09:25:13 2017 -0800 Typos in cache key plugin doc --- doc/admin-guide/plugins/cachekey.en.rst | 8 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/doc/admin-guide/plugins/cachekey.en.rst b/doc/admin-guide/plugins/cachekey.en.rst index c5ddccd..75e134d 100644 --- a/doc/admin-guide/plugins/cachekey.en.rst +++ b/doc/admin-guide/plugins/cachekey.en.rst @@ -397,7 +397,7 @@ If the plugin is used with the following plugin parameters in the remap rule. :: @pparam=--capture-prefix=(test_prefix).*:([^\s\/$]*) \ @pparam=--static-prefix=static_prefix -the cache key will be prefixed with ``/static_prefix/test_prefix/80`` instead of ``test_prefix_371.example.com:80`` when neither ``--capture-prefix`` nor ``--static-prefix`` are used. +the cache key will be prefixed with ``/static_prefix/test_prefix/80`` instead of ``test_prefix_371.example.com:80`` when either ``--capture-prefix`` nor ``--static-prefix`` are used. Path, capture and replace from the path or entire URI @@ -415,7 +415,7 @@ and the request URI is the following :: http://test_path_123.example.com/path/to/object?a=1=2=3 -then the cache key will have ``/const_path_object`` in the path section of the cache key instead of ``/path/to/object`` when neither ``--capture-path`` nor ``--capture-path-uri`` are used. +then the cache key will have ``/const_path_object`` in the path section of the cache key instead of ``/path/to/object`` when either ``--capture-path`` nor ``--capture-path-uri`` are used. Capture and replace groups from whole URI for the "Path" section @@ -430,7 +430,7 @@ and the request URI is the following :: http://test_path_123.example.com/path/to/object?a=1=2=3 -the the cache key will have ``/test_path_object`` in the path section of the cache key instead of ``/path/to/object`` when neither ``--capture-path`` nor ``--capture-path-uri`` are used. +the the cache key will have ``/test_path_object`` in the path section of the cache key instead of ``/path/to/object`` when either ``--capture-path`` nor ``--capture-path-uri`` are used. Combining path plugin parameters --capture-path and --capture-path-uri @@ -446,7 +446,7 @@ and the request URI is the following :: http://test_path_123.example.com/path/to/object?a=1=2=3 -the the cache key will have ``/test_path_object/const_path_object`` in the path section of the cache key instead of ``/path/to/object`` when neither ``--capture-path`` nor ``--capture-path-uri`` are used. +the the cache key will have ``/test_path_object/const_path_object`` in the path section of the cache key instead of ``/path/to/object`` when either ``--capture-path`` nor ``--capture-path-uri`` are used. User-Agent capturing, replacement and classification -- To stop receiving notification emails like this one, please contact ['"commits@trafficserver.apache.org" <commits@trafficserver.apache.org>'].
[trafficserver] branch master updated: Correct parameter name in diagram
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://git-dual.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new 8709974 Correct parameter name in diagram 8709974 is described below commit 8709974dcb3c5e9d21d579da87096d114cccb801 Author: Miles Libbey <mlib...@apache.org> AuthorDate: Fri Feb 24 08:50:25 2017 -0800 Correct parameter name in diagram --- doc/admin-guide/plugins/cachekey.en.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/admin-guide/plugins/cachekey.en.rst b/doc/admin-guide/plugins/cachekey.en.rst index 2f374ff..c5ddccd 100644 --- a/doc/admin-guide/plugins/cachekey.en.rst +++ b/doc/admin-guide/plugins/cachekey.en.rst @@ -130,7 +130,7 @@ Cache key structure and related plugin parameters :: Optional components | ┌┬┐ - (included in this order) | │ --path-capture-uri | --path-capture │ + (included in this order) | │ --capture-path-uri | --capture-path │ | ├┴┤ Default values if no | │ URI path| optional components | └─┘ -- To stop receiving notification emails like this one, please contact ['"commits@trafficserver.apache.org" <commits@trafficserver.apache.org>'].
[trafficserver] branch master updated: Spelling and formatting fixes
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://git-dual.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new d25a38c Spelling and formatting fixes d25a38c is described below commit d25a38cf1dfac7a8a4262da00d9b1ba26dfa31d3 Author: Miles Libbey <mlib...@apache.org> AuthorDate: Tue Dec 6 13:57:22 2016 -0800 Spelling and formatting fixes --- doc/admin-guide/installation/index.en.rst | 2 ++ doc/admin-guide/plugins/generator.en.rst | 8 doc/appendices/faq.en.rst | 2 +- 3 files changed, 7 insertions(+), 5 deletions(-) diff --git a/doc/admin-guide/installation/index.en.rst b/doc/admin-guide/installation/index.en.rst index 7f9a54d..dc465b8 100644 --- a/doc/admin-guide/installation/index.en.rst +++ b/doc/admin-guide/installation/index.en.rst @@ -189,6 +189,8 @@ working copy:: cd /opt/ats sudo bin/traffic_server -R 1 +.. _start-traffic-server: + Start Traffic Server diff --git a/doc/admin-guide/plugins/generator.en.rst b/doc/admin-guide/plugins/generator.en.rst index a27bf4e..c1dec1b 100644 --- a/doc/admin-guide/plugins/generator.en.rst +++ b/doc/admin-guide/plugins/generator.en.rst @@ -22,14 +22,14 @@ Generator Plugin The `Generator` allows testing of synthetic workloads by generating HTTP responses of various sizes. The size and cacheability of the -response is specified by the first two coomponents of the requested +response is specified by the first two components of the requested URL path. This plugin only supports the ``GET`` and ``HEAD`` HTTP methods. +---++ |Path component | Description | +===++ -|1 | ``cache`` or ``nocache``. If ``cache`` is specifed, the | +|1 | ``cache`` or ``nocache``. If ``cache`` is specified, the | | | `Generator` plugin will respond with ``Cache-Control`` headers | | | marking the response as cacheable. | +---++ @@ -38,7 +38,7 @@ methods. Path components after the first 2 are ignored. This means that the trailing path components can be manipulated to create unique URLs -following any covenient convention. +following any convenient convention. The `Generator` plugin inspects the following HTTP client request headers: @@ -51,7 +51,7 @@ The `Generator` plugin inspects the following HTTP client request headers: | ``Generator-MaxAge`` | The number of seconds that a response should be cached | | | for. This is used in the ``max-age`` field of the | | | response's ``Cache-Control`` header. | -++ ++---++ The `Generator` plugin publishes the following metrics: diff --git a/doc/appendices/faq.en.rst b/doc/appendices/faq.en.rst index 5697e4e..b58ea55 100644 --- a/doc/appendices/faq.en.rst +++ b/doc/appendices/faq.en.rst @@ -60,7 +60,7 @@ the request for the objects), and do not execute on the server. In Squid- and Netscape-format log files, what do the cache result codes mean? - -This is described in detail in the :ref:`admin-logging-format-squid` documentation. +This is described in detail in the :ref:`admin-logging-cache-results` documentation. What is recorded by the ``cqtx`` field in a custom log file? -- To stop receiving notification emails like this one, please contact ['"commits@trafficserver.apache.org" <commits@trafficserver.apache.org>'].
[trafficserver] branch master updated: reduce documentation build errors
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://git-dual.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new f2a9eee reduce documentation build errors f2a9eee is described below commit f2a9278c30b68b8b87bdf287a831247b143a Author: Miles Libbey <mlib...@apache.org> AuthorDate: Thu Nov 24 12:22:28 2016 -0800 reduce documentation build errors --- doc/admin-guide/files/records.config.en.rst | 4 doc/admin-guide/monitoring/alarms.en.rst | 3 +-- doc/admin-guide/performance/index.en.rst | 2 +- doc/appendices/command-line/traffic_ctl.en.rst | 2 ++ doc/developer-guide/api/functions/TSHttpOverridableConfig.en.rst | 2 +- 5 files changed, 9 insertions(+), 4 deletions(-) diff --git a/doc/admin-guide/files/records.config.en.rst b/doc/admin-guide/files/records.config.en.rst index 986a673..84d42cc 100644 --- a/doc/admin-guide/files/records.config.en.rst +++ b/doc/admin-guide/files/records.config.en.rst @@ -1456,6 +1456,10 @@ Origin Server Connect Attempts See :ref:`admin-performance-timeouts` for more discussion on |TS| timeouts. +.. ts:cv:: CONFIG proxy.config.http.post.check.content_length.enabled INT 1 + +Enables (``1``) or disables (``0``) checking the Content-Length: Header for a POST request. + .. ts:cv:: CONFIG proxy.config.http.down_server.cache_time INT 60 :reloadable: :overridable: diff --git a/doc/admin-guide/monitoring/alarms.en.rst b/doc/admin-guide/monitoring/alarms.en.rst index f197976..283619b 100644 --- a/doc/admin-guide/monitoring/alarms.en.rst +++ b/doc/admin-guide/monitoring/alarms.en.rst @@ -65,8 +65,7 @@ To view a statistic, enter the following command::: traffic_ctl metric get VARIABLE where ``variable`` is the variable representing the information you -want to view. For a list of variables you can specify, refer to :ref:`Traffic -Server Metrics `. +want to view. For a list of variables you can specify, refer to :ref:`traffic_ctl metrics `. For example, the following command displays the document hit rate for the Traffic Server node::: diff --git a/doc/admin-guide/performance/index.en.rst b/doc/admin-guide/performance/index.en.rst index 9715509..93f9b75 100644 --- a/doc/admin-guide/performance/index.en.rst +++ b/doc/admin-guide/performance/index.en.rst @@ -242,7 +242,7 @@ should be carefully considered and closely monitored. Default Inactivity Timeout ~~ -The :ts:cv:`proxy.process.net.default_inactivity_timeout` setting is applied to +The :ts:cv:`proxy.config.net.default_inactivity_timeout` setting is applied to the HTTP state machine when no other inactivity timeouts have been applied. In effect, it sets an upper limit, in seconds, on state machine inactivity. diff --git a/doc/appendices/command-line/traffic_ctl.en.rst b/doc/appendices/command-line/traffic_ctl.en.rst index 7c56650..9905fd2 100644 --- a/doc/appendices/command-line/traffic_ctl.en.rst +++ b/doc/appendices/command-line/traffic_ctl.en.rst @@ -168,6 +168,8 @@ traffic_ctl config configuration store is current and whether any daemon processes should be restarted. +.. _traffic-ctl-metric: + traffic_ctl metric -- .. program:: traffic_ctl metric diff --git a/doc/developer-guide/api/functions/TSHttpOverridableConfig.en.rst b/doc/developer-guide/api/functions/TSHttpOverridableConfig.en.rst index 3248bcd..3ae4790 100644 --- a/doc/developer-guide/api/functions/TSHttpOverridableConfig.en.rst +++ b/doc/developer-guide/api/functions/TSHttpOverridableConfig.en.rst @@ -67,7 +67,7 @@ The following configurations (from ``records.config``) are overridable: TSOverridableConfigKey Value Configuration Value == c:member:`TS_CONFIG_BODY_FACTORY_TEMPLATE_BASE` :ts:cv:`proxy.config.body_factory.template_base` -c:member:`TS_CONFIG_HTTP_ANONYMIZE_INSERT_CLIENT_IP` :ts:cv:`proxy.config.http.anonymize_insert_client_ip` +c:member:`TS_CONFIG_HTTP_ANONYMIZE_INSERT_CLIENT_IP` :ts:cv:`proxy.config.http.insert_client_ip` c:member:`TS_CONFIG_HTTP_ANONYMIZE_REMOVE_CLIENT_IP` :ts:cv:`proxy.config.http.anonymize_remove_client_ip` c:member:`TS_CONFIG_HTTP_ANONYMIZE_REMOVE_COOKIE` :ts:cv:`proxy.config.http.anonymize_remove_cookie` c:member:`TS_CONFIG_HTTP_ANONYMIZE_REMOVE_FROM` :ts:cv:`proxy.config.http.anonymize_remove_from` -- To stop receiving notification emails like this one, please contact ['"commits@trafficserver.apache.org" <commits@trafficserver.apache.org>'].
[trafficserver] branch master updated: Minor rst formatting to reduce build errors
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://git-dual.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new f821eb5 Minor rst formatting to reduce build errors f821eb5 is described below commit f821eb58ae63f71bd79679b19982f6ed30b25c32 Author: Miles Libbey <mlib...@apache.org> AuthorDate: Thu Nov 24 09:21:03 2016 -0800 Minor rst formatting to reduce build errors --- doc/admin-guide/files/parent.config.en.rst | 4 ++-- doc/admin-guide/monitoring/diagnostic-files.en.rst | 2 ++ doc/admin-guide/plugins/header_rewrite.en.rst| 2 +- doc/admin-guide/plugins/ts_lua.en.rst| 2 +- doc/developer-guide/api/functions/TSHttpOverridableConfig.en.rst | 1 + 5 files changed, 7 insertions(+), 4 deletions(-) diff --git a/doc/admin-guide/files/parent.config.en.rst b/doc/admin-guide/files/parent.config.en.rst index 9f8ff9d..f6a3d67 100644 --- a/doc/admin-guide/files/parent.config.en.rst +++ b/doc/admin-guide/files/parent.config.en.rst @@ -231,8 +231,8 @@ The following list shows the possible actions and their allowed values. - ``consider`` - Use the query string when finding a parent. - ``ignore`` - Do not consider the query string when finding a parent. This - is especially useful when using the ``consistent_hash`` selection strategy, - and a random query string would prevent a consistent parent selection. + is especially useful when using the ``consistent_hash`` selection strategy, + and a random query string would prevent a consistent parent selection. Examples diff --git a/doc/admin-guide/monitoring/diagnostic-files.en.rst b/doc/admin-guide/monitoring/diagnostic-files.en.rst index 8f5eba8..44091cc 100644 --- a/doc/admin-guide/monitoring/diagnostic-files.en.rst +++ b/doc/admin-guide/monitoring/diagnostic-files.en.rst @@ -15,6 +15,8 @@ specific language governing permissions and limitations under the License. +.. include:: ../common.defs + = traffic.out = diff --git a/doc/admin-guide/plugins/header_rewrite.en.rst b/doc/admin-guide/plugins/header_rewrite.en.rst index a340ec0..4e0b4a4 100644 --- a/doc/admin-guide/plugins/header_rewrite.en.rst +++ b/doc/admin-guide/plugins/header_rewrite.en.rst @@ -604,7 +604,7 @@ set-header Replaces the value of header with , creating the header if necessary. -The header's may be specified according to `Header Value`_ or take +The header's may be specified according to `Header Values`_ or take advantage of `Variable Expansion`_ to calculate a dynamic value for the header. set-redirect diff --git a/doc/admin-guide/plugins/ts_lua.en.rst b/doc/admin-guide/plugins/ts_lua.en.rst index 33993f8..f5760fe 100644 --- a/doc/admin-guide/plugins/ts_lua.en.rst +++ b/doc/admin-guide/plugins/ts_lua.en.rst @@ -417,7 +417,7 @@ Additional Information: | TS_HTTP_READ | TS_LUA_HOOK | YES | NO |YES | | _CACHE_HDR_HOOK | _READ_CACHE_HDR | | | | +---+---+--++--+ -| TS_HTTP_OS| TS_LUA_HOOK_ | YES | NO |YES | +| TS_HTTP_OS| TS_LUA_HOOK | YES | NO |YES | | _DNS_HOOK | _OS_DNS | | | | +---+---+--++--+ | TS_HTTP_CACHE | TS_LUA_HOOK | YES | NO |YES | diff --git a/doc/developer-guide/api/functions/TSHttpOverridableConfig.en.rst b/doc/developer-guide/api/functions/TSHttpOverridableConfig.en.rst index 9755d3d..3248bcd 100644 --- a/doc/developer-guide/api/functions/TSHttpOverridableConfig.en.rst +++ b/doc/developer-guide/api/functions/TSHttpOverridableConfig.en.rst @@ -167,6 +167,7 @@ c:member:`TS_CONFIG_SSL_HSTS_MAX_AGE` :ts:cv:`prox c:member:`TS_CONFIG_URL_REMAP_PRISTINE_HOST_HDR` :ts:cv:`proxy.config.url_remap.pristine_host_hdr` c:member:`TS_CONFIG_WEBSOCKET_ACTIVE_TIMEOUT` :ts:cv:`proxy.config.websocket.active_timeout` c:member:`TS_CONFIG_WEBSOCKET_NO_ACTIVITY_TIMEOUT` :ts:cv:`proxy.config.websocket.no_activity_timeout` +== Examples -- T
svn commit: r1001571 - in /websites/production/trafficserver: cgi-bin/ content/
Author: mlibbey Date: Thu Nov 24 01:38:51 2016 New Revision: 1001571 Log: republish logbuilder Added: websites/production/trafficserver/cgi-bin/ - copied from r1001570, websites/staging/trafficserver/trunk/cgi-bin/ websites/production/trafficserver/content/ - copied from r1001570, websites/staging/trafficserver/trunk/content/
svn commit: r1001563 - in /websites/production/trafficserver: cgi-bin/ content/
Author: mlibbey Date: Wed Nov 23 22:01:26 2016 New Revision: 1001563 Log: Remove xid from log builder Added: websites/production/trafficserver/cgi-bin/ - copied from r1001562, websites/staging/trafficserver/trunk/cgi-bin/ websites/production/trafficserver/content/ - copied from r1001562, websites/staging/trafficserver/trunk/content/
svn commit: r1771054 - /trafficserver/site/trunk/content/logbuilder/index.html
Author: mlibbey Date: Wed Nov 23 22:00:02 2016 New Revision: 1771054 URL: http://svn.apache.org/viewvc?rev=1771054=rev Log: xid isn't a valid custom log field in production versions Modified: trafficserver/site/trunk/content/logbuilder/index.html Modified: trafficserver/site/trunk/content/logbuilder/index.html URL: http://svn.apache.org/viewvc/trafficserver/site/trunk/content/logbuilder/index.html?rev=1771054=1771053=1771054=diff == --- trafficserver/site/trunk/content/logbuilder/index.html (original) +++ trafficserver/site/trunk/content/logbuilder/index.html Wed Nov 23 22:00:02 2016 @@ -10,7 +10,7 @@ var names = new Array(""); var init_id = 0; var selected_id = 0; var welf_example = "id=firewall time=\\\"% %\\\" fw=% pri=6 proto=% duration=% sent=% rcvd=% src=% dst=% dstname=% user=% op=% arg=\\\"%\\\" result=% ref=\\\"%<{Referer}cqh>\\\" agent=\\\"%<{user-agent}cqh>\\\" cache=% "; -var squid_example = "% % % %/% % % % % %/% % %"; +var squid_example = "% % % %/% % % % % %/% %"; var allOptions = new Array(); allOptions['fsiz'] = new Array(false, "The size of the file (n bytes) as seen by the origin server. ", "4096"); allOptions['cquup'] = new Array(false, "The client request unmapped URL path. This field records a URL path before it is remapped (reverse proxy mode).", "/foo/bar"); @@ -62,7 +62,6 @@ allOptions['caun'] = new Array(false, "T allOptions['cqup'] = new Array(false, "The client request URL path; specifies the argument portion of the URL (everything after the host). For example, if the URL is http://www.company.com/images/x.gif, then this field displays /images/x.gif", "/foo/bar.php"); allOptions['cqtd'] = new Array(false, "The client request timestamp. Specifies the date of the client request in the format -mm-dd, where is the 4-digit year, mm is the 2-digit month, and dd is the 2-digit day.", "2012-07-18"); allOptions['cqu'] = new Array(false, "The universal resource identifier (URI) of the request from client to Traffic Server (subset of cqtx ). See the description of cqtx for behaviour in reverse proxy mode.", "http://www.company.com/foo.bar;); -allOptions['xid'] = new Array(false, "Accelerator ID", 742938330); allOptions['crat'] = new Array(false, "The client Retry-After time in seconds, if specified by the origin.", 30); function addToLog(id, name, needsInput) { if ( id == 0 ) { id = selected_id; }
[trafficserver] branch master updated: Revert "line continuations "\" need escaping to show"
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://git-dual.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new e6486f4 Revert "line continuations "\" need escaping to show" e6486f4 is described below commit e6486f4501c76cae1597b7409aa2dda26c90b2eb Author: Miles Libbey <mlib...@apache.org> AuthorDate: Tue Nov 22 15:21:47 2016 -0800 Revert "line continuations "\" need escaping to show" This reverts commit cc0a197910cb875fd570ccd5239cfc907ce20d3d in favor of waiting for #1230. --- doc/admin-guide/plugins/cache_promote.en.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/admin-guide/plugins/cache_promote.en.rst b/doc/admin-guide/plugins/cache_promote.en.rst index f1c2718..69ed794 100644 --- a/doc/admin-guide/plugins/cache_promote.en.rst +++ b/doc/admin-guide/plugins/cache_promote.en.rst @@ -45,10 +45,10 @@ Examples These two examples shows how to use the chance and LRU policies, respectively: -map http://cdn.example.com/ http://some-server.example.com \\ +map http://cdn.example.com/ http://some-server.example.com \ @plugin=cache_promote.so @pparam=--policy=chance @pparam=--sample=10% -map http://cdn.example.com/ http://some-server.example.com \\ +map http://cdn.example.com/ http://some-server.example.com \ @plugin=cache_promote.so @pparam=--policy=lru \ @pparam=--hits=10 @pparam=--buckets=1 -- To stop receiving notification emails like this one, please contact ['"commits@trafficserver.apache.org" <commits@trafficserver.apache.org>'].
[trafficserver] branch master updated: line continuations "\" need escaping to show
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://git-dual.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new cc0a197 line continuations "\" need escaping to show cc0a197 is described below commit cc0a197910cb875fd570ccd5239cfc907ce20d3d Author: Miles Libbey <mlib...@apache.org> AuthorDate: Tue Nov 22 15:08:18 2016 -0800 line continuations "\" need escaping to show --- doc/admin-guide/plugins/cache_promote.en.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/admin-guide/plugins/cache_promote.en.rst b/doc/admin-guide/plugins/cache_promote.en.rst index 69ed794..f1c2718 100644 --- a/doc/admin-guide/plugins/cache_promote.en.rst +++ b/doc/admin-guide/plugins/cache_promote.en.rst @@ -45,10 +45,10 @@ Examples These two examples shows how to use the chance and LRU policies, respectively: -map http://cdn.example.com/ http://some-server.example.com \ +map http://cdn.example.com/ http://some-server.example.com \\ @plugin=cache_promote.so @pparam=--policy=chance @pparam=--sample=10% -map http://cdn.example.com/ http://some-server.example.com \ +map http://cdn.example.com/ http://some-server.example.com \\ @plugin=cache_promote.so @pparam=--policy=lru \ @pparam=--hits=10 @pparam=--buckets=1 -- To stop receiving notification emails like this one, please contact ['"commits@trafficserver.apache.org" <commits@trafficserver.apache.org>'].
[trafficserver] branch master updated: Clarify parent selection.
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://git-dual.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new dab332a Clarify parent selection. dab332a is described below commit dab332a0eadb194d600172d3a66dd5e52971a003 Author: Miles Libbey <mlib...@apache.org> AuthorDate: Mon Nov 7 13:44:35 2016 -0800 Clarify parent selection. --- .../configuration/hierachical-caching.en.rst | 19 +++ doc/admin-guide/files/parent.config.en.rst | 28 -- 2 files changed, 35 insertions(+), 12 deletions(-) diff --git a/doc/admin-guide/configuration/hierachical-caching.en.rst b/doc/admin-guide/configuration/hierachical-caching.en.rst index 9d5790f..32964c9 100644 --- a/doc/admin-guide/configuration/hierachical-caching.en.rst +++ b/doc/admin-guide/configuration/hierachical-caching.en.rst @@ -76,6 +76,25 @@ content from the origin server (or from another cache, depending on the parent configuration). The parent caches the content and then sends a copy to Traffic Server (its child), where it is cached and served to the client. +Parent Selection Policies +- + +There are several parent selection policies available to the Traffic Server child +node. + +- Consistent Hash. The child node chooses a specific parent for each URI. This effectively + makes the parent's cache size the sum total of each of the individual parent cache + sizes. +- Round Robin. The child node cycles through the parents. The child can select the parent + based on the client IP ("true"), or in a strict cycling ("strict"). +- (Unnamed). The child node chooses the first live parent listed. There are two variants to this + strategy. When the strategy is set to "false," the child will use the first listed parent + (for clarity called p1) until it is marked down, when the child will switch to the second + listed parent (p2). Then, when the p1 is retested and found live, the child + will restart using p1. When the selection strategy is set to "latched," the child will use + p1 until it is marked down, when it will switch to p2. When p1 is retested and found live, + the child will continue using p2 until it is marked down. + Interaction with Remap.config - diff --git a/doc/admin-guide/files/parent.config.en.rst b/doc/admin-guide/files/parent.config.en.rst index 93238d7..9f8ff9d 100644 --- a/doc/admin-guide/files/parent.config.en.rst +++ b/doc/admin-guide/files/parent.config.en.rst @@ -69,7 +69,8 @@ allowed values. The secondary specifiers are optional in the :file:`parent.config` file. The following list shows the possible secondary specifiers and their allowed -values. +values. Every line in the :file:`parent.config` file must contain either a +``parent=`` or ``go_direct=`` directive. .. _parent-config-format-port: @@ -195,8 +196,7 @@ The following list shows the possible actions and their allowed values. ``round_robin`` One of the following values: -- ``true`` - Traffic Server goes through the parent cache list in a - round robin-based on client IP address. +- ``true`` - Traffic Server determines the parent based on client IP address. - ``strict`` - Traffic Server machines serve requests strictly in turn. For example: machine ``proxy1`` serves the first request, ``proxy2`` serves the second request, and so on. @@ -207,8 +207,8 @@ The following list shows the possible actions and their allowed values. The other traffic is unaffected. Once the downed parent becomes available, the traffic distribution returns to the pre-down state. -- ``latched`` - The first parent in the list is marked as primary and is - always chosen until connection errors cause it to be marked down. When +- ``latched`` - The first parent in the list is marked as primary and is + always chosen until connection errors cause it to be marked down. When this occurs the next parent in the list then becomes primary. The primary will wrap back to the first parent in the list when it is the last parent in the list and is marked down due to a connection error. Newly chosen @@ -230,7 +230,9 @@ The following list shows the possible actions and their allowed values. One of the following values: - ``consider`` - Use the query string when finding a parent. -- ``ignore`` - Do not consider the query string when finding a parent. +- ``ignore`` - Do not consider the query string when finding a parent. This + is especially useful when using the ``consistent_hash`` selection strategy, + and a random query string would prevent a consistent parent selection. Examples ==
[trafficserver] branch master updated: Clarify parent transaction; add some keywords to allow cache inspection searches
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://git-dual.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new 63bf6c6 Clarify parent transaction; add some keywords to allow cache inspection searches 63bf6c6 is described below commit 63bf6c60ac538a2512e402fbb522bbafe4661b30 Author: Miles Libbey <mlib...@apache.org> AuthorDate: Fri Oct 28 14:10:17 2016 -0700 Clarify parent transaction; add some keywords to allow cache inspection searches --- doc/admin-guide/files/records.config.en.rst | 10 ++ 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/doc/admin-guide/files/records.config.en.rst b/doc/admin-guide/files/records.config.en.rst index da887d5..ecf52a7 100644 --- a/doc/admin-guide/files/records.config.en.rst +++ b/doc/admin-guide/files/records.config.en.rst @@ -1199,13 +1199,15 @@ Parent Proxy Configuration :reloadable: :overridable: - The total number of connection attempts allowed to a parent cache before Traffic Server bypasses the parent or fails the request + The total number of connection attempts for a specific transaction allowed to + a parent cache before Traffic Server bypasses the parent or fails the request (depending on the ``go_direct`` option in the :file:`parent.config` file). .. ts:cv:: CONFIG proxy.config.http.parent_proxy.per_parent_connect_attempts INT 2 :reloadable: - The total number of connection attempts allowed per parent, if multiple parents are used. + The total number of connection attempts allowed per parent for a specific + transaction, if multiple parents are used. .. ts:cv:: CONFIG proxy.config.http.parent_proxy.connect_attempts_timeout INT 30 :reloadable: @@ -2231,13 +2233,13 @@ Customizable User Response Pages .. ts:cv:: CONFIG proxy.config.http_ui_enabled INT 0 - Specifies which http UI endpoints to allow within :file:`remap.config`: + Specifies which http Inspector UI endpoints to allow within :file:`remap.config`: = == Value Description = == ``0`` Disable all http UI endpoints. - ``1`` Enable only cache endpoints. + ``1`` Enable only Cache Inspector endpoints. ``2`` Enable only stats endpoints. ``3`` Enable all http UI endpoints. = == -- To stop receiving notification emails like this one, please contact ['"commits@trafficserver.apache.org" <commits@trafficserver.apache.org>'].
[trafficserver] branch master updated: Missing whitespace preventing formatting
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://git-dual.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new 0b32321 Missing whitespace preventing formatting 0b32321 is described below commit 0b323218d9271162ce362f698b2fb0ba518f20ad Author: Miles Libbey <mlib...@apache.org> AuthorDate: Fri Jul 1 16:21:37 2016 -0700 Missing whitespace preventing formatting --- doc/admin-guide/plugins/header_rewrite.en.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/doc/admin-guide/plugins/header_rewrite.en.rst b/doc/admin-guide/plugins/header_rewrite.en.rst index 4082fb0..18f83b2 100644 --- a/doc/admin-guide/plugins/header_rewrite.en.rst +++ b/doc/admin-guide/plugins/header_rewrite.en.rst @@ -264,6 +264,7 @@ consider using the `CLIENT-HEADER`_ condition instead. ID ~~ :: + cond %{ID:REQUEST} >100 This condition provides access to three identifier values that ATS uses -- To stop receiving notification emails like this one, please contact ['"commits@trafficserver.apache.org" <commits@trafficserver.apache.org>'].
[trafficserver] branch master updated: Fix configuration details for gzip plugin
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://git-dual.apache.org/repos/asf/trafficserver.git The following commit(s) were added to refs/heads/master by this push: new 029d65d Fix configuration details for gzip plugin 029d65d is described below commit 029d65dc28cdbe05ec241dde0723e18309b2825c Author: Miles Libbey <mlib...@apache.org> AuthorDate: Wed Jun 29 14:19:59 2016 -0700 Fix configuration details for gzip plugin --- doc/admin-guide/plugins/gzip.en.rst | 17 +++-- 1 file changed, 11 insertions(+), 6 deletions(-) diff --git a/doc/admin-guide/plugins/gzip.en.rst b/doc/admin-guide/plugins/gzip.en.rst index 676940e..5ba8363 100644 --- a/doc/admin-guide/plugins/gzip.en.rst +++ b/doc/admin-guide/plugins/gzip.en.rst @@ -81,10 +81,10 @@ configuration provided with the plugin's source):: gzip.so /sample.gzip.config -This can be used as remap plugin by pointing to config file in remap rule +This can be used as remap plugin by pointing to config file in remap rule :file:`remap.config`:: -@plugin=gzip.so @pparam=--config=/sample.gzip.config +@plugin=gzip.so @pparam=/sample.gzip.config The following sections detail the options you may specify in the plugin's configuration file. Options may be used globally, or may be specified on a @@ -105,13 +105,14 @@ compressible-content-type - Provides a wildcard to match against content types, determining which are to be -considered compressible. This defaults to ``text/*``. +considered compressible. This defaults to ``text/*``. Takes one Content-Type +per line. disallow Provides a wildcard pattern which will be applied to request URLs. Any which -match the pattern will be considered uncompressable, and only deflated versions +match the pattern will be considered incompressible, and only deflated versions of the objects will be cached and returned to clients. This may be useful for objects which already have their own compression built-in, to avoid the expense of multiple rounds of compression for trivial gains. @@ -119,7 +120,7 @@ of multiple rounds of compression for trivial gains. enabled --- -When set to ``true`` permits objects to be compressed, and when ``false`` +When set to ``true`` (the default) permits objects to be compressed, and when ``false`` effectively disables the plugin in the current context. flush @@ -149,9 +150,9 @@ might create a configuration with the following options:: # Set some global options first cache true -enabled true remove-accept-encoding false compressible-content-type text/* +compressible-content-type application/json flush false # Now set a configuration for www.example.com @@ -161,6 +162,10 @@ might create a configuration with the following options:: disallow /notthis/*.js flush true +# This origin does it all +[bar.example.com] +enabled false + Assuming the above options are in a file at ``/etc/trafficserver/gzip.config`` the plugin would be enabled for |TS| in :file:`plugin.config` as:: -- To stop receiving notification emails like this one, please contact ['"commits@trafficserver.apache.org" <commits@trafficserver.apache.org>'].
[trafficserver] 01/02: Add timeout example and clarify PATH component
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a commit to branch master in repository https://git-dual.apache.org/repos/asf/trafficserver.git commit 6c4926851523a2adc24764a5bfadf3bd18a3810e Author: Miles Libbey <mlib...@apache.org> AuthorDate: Wed Jun 15 13:13:33 2016 -0700 Add timeout example and clarify PATH component --- doc/admin-guide/plugins/header_rewrite.en.rst | 13 - 1 file changed, 12 insertions(+), 1 deletion(-) diff --git a/doc/admin-guide/plugins/header_rewrite.en.rst b/doc/admin-guide/plugins/header_rewrite.en.rst index 213ec74..ada3a8d 100644 --- a/doc/admin-guide/plugins/header_rewrite.en.rst +++ b/doc/admin-guide/plugins/header_rewrite.en.rst @@ -316,7 +316,7 @@ PATH cond %{PATH} -The path component of the transaction. This includes the leading ``/`` that +The path component of the transaction. This does NOT include the leading ``/`` that immediately follows the hostname and terminates prior to the ``?`` signifying the beginning of query parameters (or the end of the URL, whichever occurs first). @@ -980,3 +980,14 @@ two different file paths.:: cond %{SEND_RESPONSE_HDR_HOOK} cond %{PATH} /examplepath2/examplepath3/.*/ add-header Cache-Control "no-cache" [L] + +Redirect when the Origin Server Times Out +- + +This rule sends a 302 redirect to the client with the requested URI's Path and +Query string when the Origin server times out or the connection is refused:: + +cond %{SEND_RESPONSE_HDR_HOOK} +cond %{STATUS} =502 [OR] +cond %{STATUS} =504 +set-redirect 302 http://different_origin.example.com/%{PATH} [QSA] -- To stop receiving notification emails like this one, please contact "commits@trafficserver.apache.org" <commits@trafficserver.apache.org>.
[trafficserver] branch master updated (4d61d7b -> caa402c)
This is an automated email from the ASF dual-hosted git repository. mlibbey pushed a change to branch master in repository https://git-dual.apache.org/repos/asf/trafficserver.git. from 4d61d7b TS-4420: Fix TSHttpTxnParentProxySet crash on parent failure. new 6903698 Fix Geo section markup new caa402c Cleanup regex_remap vs regex_map references The 2 revisions listed above as "new" are entirely new to this repository and will be described in separate emails. The revisions listed as "adds" were already present in the repository and have only been added to this reference. Summary of changes: doc/admin-guide/files/remap.config.en.rst | 6 +++--- doc/admin-guide/plugins/header_rewrite.en.rst | 3 ++- 2 files changed, 5 insertions(+), 4 deletions(-) -- To stop receiving notification emails like this one, please contact ['"commits@trafficserver.apache.org" <commits@trafficserver.apache.org>'].