Update docs from commit 7c4ce34c15462716306c44ec3f5662e52220244a
Project: http://git-wip-us.apache.org/repos/asf/incubator-trafficcontrol-website/repo Commit: http://git-wip-us.apache.org/repos/asf/incubator-trafficcontrol-website/commit/330564f2 Tree: http://git-wip-us.apache.org/repos/asf/incubator-trafficcontrol-website/tree/330564f2 Diff: http://git-wip-us.apache.org/repos/asf/incubator-trafficcontrol-website/diff/330564f2 Branch: refs/heads/asf-site Commit: 330564f2e5708f9def37b2c539f098804d0a8a17 Parents: 2a703dd Author: jenkins <bui...@apache.org> Authored: Wed Feb 14 00:15:01 2018 +0000 Committer: jenkins <bui...@apache.org> Committed: Wed Feb 14 00:15:01 2018 +0000 ---------------------------------------------------------------------- .../traffic_ops/migration_from_20_to_22.rst.txt | 17 ++++++++++++++++- docs/master/admin/index.html | 1 + .../traffic_ops/migration_from_20_to_22.html | 19 +++++++++++++++++++ docs/master/index.html | 1 + docs/master/searchindex.js | 2 +- 5 files changed, 38 insertions(+), 2 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/incubator-trafficcontrol-website/blob/330564f2/docs/master/_sources/admin/traffic_ops/migration_from_20_to_22.rst.txt ---------------------------------------------------------------------- diff --git a/docs/master/_sources/admin/traffic_ops/migration_from_20_to_22.rst.txt b/docs/master/_sources/admin/traffic_ops/migration_from_20_to_22.rst.txt index 31129e5..e073858 100644 --- a/docs/master/_sources/admin/traffic_ops/migration_from_20_to_22.rst.txt +++ b/docs/master/_sources/admin/traffic_ops/migration_from_20_to_22.rst.txt @@ -16,6 +16,21 @@ Traffic Ops - Migrating from 2.0 to 2.2 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +Per-DeliveryService Routing Names +--------------------------------- +Before this release, DNS Delivery Services were hardcoded to use the name "edge", i.e. "edge.myds.mycdn.com", and HTTP Delivery Services use the name "tr" (or previously "ccr"), i.e. "tr.myds.mycdn.com". As of 2.2, Routing Names will default to "cdn" if left unspecified and can be set to any arbitrary non-dotted hostname. + +Pre-2.2 the HTTP Routing Name is configurable via the http.routing.name option in in the Traffic Router http.properties config file. If your CDN uses that option to change the name from "tr" to something else, then you will need to perform the following steps for each CDN affected: + +1. In Traffic Ops, create the following profile parameter (double-check for typos, trailing spaces, etc): + * **name**: upgrade_http_routing_name + * **config file**: temp + * **value**: whatever value is used for the affected CDN's http.routing.name + +2. Add this parameter to a single profile in the affected CDN + +With those profile parameters in place Traffic Ops can be safely upgraded to 2.2. Before taking a post-upgrade snapshot, make sure to check your Delivery Service example URLs for unexpected Routing Name changes. Once Traffic Ops has been upgraded to 2.2 and a post-upgrade snapshot has been taken, your Traffic Routers can be upgraded to 2.2 (Traffic Routers must be upgraded after Traffic Ops so that they can work with custom per-DeliveryService Routing Names). + Apache Traffic Server 7.x (Cachekey Plugin) ------------------------------------------- In Traffic Ops 2.2 we have added support for Apache Traffic Server 7.x. With 7.x comes support for the new cachekey plugin which replaces the cacheurl plugin which is now deprecated. @@ -97,4 +112,4 @@ Also note the ``s?`` used here so that both http and https requests will end up .. _ApacheTrafficServerDocs: https://docs.trafficserver.apache.org/en/latest/admin-guide/plugins/cachekey.en.html -Further documentation on the cachekey plugin can be found at `ApacheTrafficServerDocs`_ \ No newline at end of file +Further documentation on the cachekey plugin can be found at `ApacheTrafficServerDocs`_ http://git-wip-us.apache.org/repos/asf/incubator-trafficcontrol-website/blob/330564f2/docs/master/admin/index.html ---------------------------------------------------------------------- diff --git a/docs/master/admin/index.html b/docs/master/admin/index.html index 9570ed7..27c5b31 100644 --- a/docs/master/admin/index.html +++ b/docs/master/admin/index.html @@ -231,6 +231,7 @@ </ul> </li> <li class="toctree-l1"><a class="reference internal" href="traffic_ops/migration_from_20_to_22.html">Traffic Ops - Migrating from 2.0 to 2.2</a><ul> +<li class="toctree-l2"><a class="reference internal" href="traffic_ops/migration_from_20_to_22.html#per-deliveryservice-routing-names">Per-DeliveryService Routing Names</a></li> <li class="toctree-l2"><a class="reference internal" href="traffic_ops/migration_from_20_to_22.html#apache-traffic-server-7-x-cachekey-plugin">Apache Traffic Server 7.x (Cachekey Plugin)</a><ul> <li class="toctree-l3"><a class="reference internal" href="traffic_ops/migration_from_20_to_22.html#examples-of-cacheurl-to-cachekey-replacements">Examples of Cacheurl to Cachekey Replacements</a></li> </ul> http://git-wip-us.apache.org/repos/asf/incubator-trafficcontrol-website/blob/330564f2/docs/master/admin/traffic_ops/migration_from_20_to_22.html ---------------------------------------------------------------------- diff --git a/docs/master/admin/traffic_ops/migration_from_20_to_22.html b/docs/master/admin/traffic_ops/migration_from_20_to_22.html index dc67aeb..1eeea42 100644 --- a/docs/master/admin/traffic_ops/migration_from_20_to_22.html +++ b/docs/master/admin/traffic_ops/migration_from_20_to_22.html @@ -198,6 +198,25 @@ <div class="section" id="traffic-ops-migrating-from-2-0-to-2-2"> <h1>Traffic Ops - Migrating from 2.0 to 2.2<a class="headerlink" href="#traffic-ops-migrating-from-2-0-to-2-2" title="Permalink to this headline">¶</a></h1> +<div class="section" id="per-deliveryservice-routing-names"> +<h2>Per-DeliveryService Routing Names<a class="headerlink" href="#per-deliveryservice-routing-names" title="Permalink to this headline">¶</a></h2> +<p>Before this release, DNS Delivery Services were hardcoded to use the name “edge”, i.e. “edge.myds.mycdn.com”, and HTTP Delivery Services use the name “tr” (or previously “ccr”), i.e. “tr.myds.mycdn.com”. As of 2.2, Routing Names will default to “cdn” if left unspecified and can be set to any arbitrary non-dotted hostname.</p> +<p>Pre-2.2 the HTTP Routing Name is configurable via the http.routing.name option in in the Traffic Router http.properties config file. If your CDN uses that option to change the name from “tr” to something else, then you will need to perform the following steps for each CDN affected:</p> +<ol class="arabic simple"> +<li>In Traffic Ops, create the following profile parameter (double-check for typos, trailing spaces, etc):</li> +</ol> +<blockquote> +<div><ul class="simple"> +<li><strong>name</strong>: upgrade_http_routing_name</li> +<li><strong>config file</strong>: temp</li> +<li><strong>value</strong>: whatever value is used for the affected CDN’s http.routing.name</li> +</ul> +</div></blockquote> +<ol class="arabic simple" start="2"> +<li>Add this parameter to a single profile in the affected CDN</li> +</ol> +<p>With those profile parameters in place Traffic Ops can be safely upgraded to 2.2. Before taking a post-upgrade snapshot, make sure to check your Delivery Service example URLs for unexpected Routing Name changes. Once Traffic Ops has been upgraded to 2.2 and a post-upgrade snapshot has been taken, your Traffic Routers can be upgraded to 2.2 (Traffic Routers must be upgraded after Traffic Ops so that they can work with custom per-DeliveryService Routing Names).</p> +</div> <div class="section" id="apache-traffic-server-7-x-cachekey-plugin"> <h2>Apache Traffic Server 7.x (Cachekey Plugin)<a class="headerlink" href="#apache-traffic-server-7-x-cachekey-plugin" title="Permalink to this headline">¶</a></h2> <p>In Traffic Ops 2.2 we have added support for Apache Traffic Server 7.x. With 7.x comes support for the new cachekey plugin which replaces the cacheurl plugin which is now deprecated. http://git-wip-us.apache.org/repos/asf/incubator-trafficcontrol-website/blob/330564f2/docs/master/index.html ---------------------------------------------------------------------- diff --git a/docs/master/index.html b/docs/master/index.html index f838ae7..e3bce40 100644 --- a/docs/master/index.html +++ b/docs/master/index.html @@ -270,6 +270,7 @@ </ul> </li> <li class="toctree-l2"><a class="reference internal" href="admin/traffic_ops/migration_from_20_to_22.html">Traffic Ops - Migrating from 2.0 to 2.2</a><ul> +<li class="toctree-l3"><a class="reference internal" href="admin/traffic_ops/migration_from_20_to_22.html#per-deliveryservice-routing-names">Per-DeliveryService Routing Names</a></li> <li class="toctree-l3"><a class="reference internal" href="admin/traffic_ops/migration_from_20_to_22.html#apache-traffic-server-7-x-cachekey-plugin">Apache Traffic Server 7.x (Cachekey Plugin)</a></li> </ul> </li>