You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@trafficcontrol.apache.org by mi...@apache.org on 2017/04/28 19:11:08 UTC
[7/9] incubator-trafficcontrol-website git commit: updates latest to
match master
http://git-wip-us.apache.org/repos/asf/incubator-trafficcontrol-website/blob/868aab4e/docs/latest/admin/quick_howto/index.html
----------------------------------------------------------------------
diff --git a/docs/latest/admin/quick_howto/index.html b/docs/latest/admin/quick_howto/index.html
index 3f44492..76c3084 100644
--- a/docs/latest/admin/quick_howto/index.html
+++ b/docs/latest/admin/quick_howto/index.html
@@ -7,7 +7,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
- <title>Quick How To Guides — Traffic Control master documentation </title>
+ <title>Quick How To Guides — Traffic Control 1.8-dev documentation </title>
@@ -33,7 +33,7 @@
- <link rel="top" title="Traffic Control master documentation" href="../../index.html"/>
+ <link rel="top" title="Traffic Control 1.8-dev documentation" href="../../index.html"/>
<link rel="up" title="Administrator\u2019s Guide" href="../index.html"/>
<link rel="next" title="Configure Multi Site Origin" href="multi_site.html"/>
<link rel="prev" title="Traffic Vault Administration" href="../traffic_vault.html"/>
@@ -108,6 +108,7 @@
<li class="toctree-l2"><a class="reference internal" href="../traffic_ops_extensions.html">Managing Traffic Ops Extensions</a></li>
<li class="toctree-l2"><a class="reference internal" href="../traffic_portal.html">Traffic Portal Administration</a></li>
<li class="toctree-l2"><a class="reference internal" href="../traffic_monitor.html">Traffic Monitor Administration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../traffic_monitor_golang.html">Traffic Monitor Administration</a></li>
<li class="toctree-l2"><a class="reference internal" href="../traffic_router.html">Traffic Router Administration</a></li>
<li class="toctree-l2"><a class="reference internal" href="../traffic_stats.html">Traffic Stats Administration</a></li>
<li class="toctree-l2"><a class="reference internal" href="../traffic_server.html">Traffic Server Administration</a></li>
@@ -122,6 +123,7 @@
<li class="toctree-l2"><a class="reference internal" href="../../development/traffic_portal.html">Traffic Portal</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../development/traffic_router.html">Traffic Router</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../development/traffic_monitor.html">Traffic Monitor</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../development/traffic_monitor_golang.html">Traffic Monitor Golang</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../development/traffic_stats.html">Traffic Stats</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../development/traffic_server.html">Traffic Server</a></li>
</ul>
@@ -159,7 +161,7 @@
<div class="rst-content">
<div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
- <li><a href="../../index.html">Traffic Control master</a> »</li>
+ <li><a href="../../index.html">Traffic Control 1.8-dev</a> »</li>
<li><a href="../index.html">Administrator’s Guide</a> »</li>
@@ -237,7 +239,7 @@
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../../',
- VERSION:'master',
+ VERSION:'1.8-dev',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true
http://git-wip-us.apache.org/repos/asf/incubator-trafficcontrol-website/blob/868aab4e/docs/latest/admin/quick_howto/multi_site.html
----------------------------------------------------------------------
diff --git a/docs/latest/admin/quick_howto/multi_site.html b/docs/latest/admin/quick_howto/multi_site.html
index 2443f68..91a1a4e 100644
--- a/docs/latest/admin/quick_howto/multi_site.html
+++ b/docs/latest/admin/quick_howto/multi_site.html
@@ -7,7 +7,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
- <title>Configure Multi Site Origin — Traffic Control master documentation </title>
+ <title>Configure Multi Site Origin — Traffic Control 1.8-dev documentation </title>
@@ -33,7 +33,7 @@
- <link rel="top" title="Traffic Control master documentation" href="../../index.html"/>
+ <link rel="top" title="Traffic Control 1.8-dev documentation" href="../../index.html"/>
<link rel="up" title="Quick How To Guides" href="index.html"/>
<link rel="next" title="Configure Multi Site Origin (5.x)" href="multi_site_ats5.html"/>
<link rel="prev" title="Quick How To Guides" href="index.html"/>
@@ -159,7 +159,7 @@
<div class="rst-content">
<div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
- <li><a href="../../index.html">Traffic Control master</a> »</li>
+ <li><a href="../../index.html">Traffic Control 1.8-dev</a> »</li>
<li><a href="../index.html">Administrator’s Guide</a> »</li>
@@ -308,7 +308,7 @@ round-robin</td>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../../',
- VERSION:'master',
+ VERSION:'1.8-dev',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true
http://git-wip-us.apache.org/repos/asf/incubator-trafficcontrol-website/blob/868aab4e/docs/latest/admin/quick_howto/multi_site_ats5.html
----------------------------------------------------------------------
diff --git a/docs/latest/admin/quick_howto/multi_site_ats5.html b/docs/latest/admin/quick_howto/multi_site_ats5.html
index 1b1bffa..55d85cf 100644
--- a/docs/latest/admin/quick_howto/multi_site_ats5.html
+++ b/docs/latest/admin/quick_howto/multi_site_ats5.html
@@ -7,7 +7,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
- <title>Configure Multi Site Origin (5.x) — Traffic Control master documentation </title>
+ <title>Configure Multi Site Origin (5.x) — Traffic Control 1.8-dev documentation </title>
@@ -33,7 +33,7 @@
- <link rel="top" title="Traffic Control master documentation" href="../../index.html"/>
+ <link rel="top" title="Traffic Control 1.8-dev documentation" href="../../index.html"/>
<link rel="up" title="Quick How To Guides" href="index.html"/>
<link rel="next" title="Configure DNSSEC" href="dnssec.html"/>
<link rel="prev" title="Configure Multi Site Origin" href="multi_site.html"/>
@@ -108,6 +108,7 @@
<li class="toctree-l2"><a class="reference internal" href="../traffic_ops_extensions.html">Managing Traffic Ops Extensions</a></li>
<li class="toctree-l2"><a class="reference internal" href="../traffic_portal.html">Traffic Portal Administration</a></li>
<li class="toctree-l2"><a class="reference internal" href="../traffic_monitor.html">Traffic Monitor Administration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../traffic_monitor_golang.html">Traffic Monitor Administration</a></li>
<li class="toctree-l2"><a class="reference internal" href="../traffic_router.html">Traffic Router Administration</a></li>
<li class="toctree-l2"><a class="reference internal" href="../traffic_stats.html">Traffic Stats Administration</a></li>
<li class="toctree-l2"><a class="reference internal" href="../traffic_server.html">Traffic Server Administration</a></li>
@@ -122,6 +123,7 @@
<li class="toctree-l2"><a class="reference internal" href="../../development/traffic_portal.html">Traffic Portal</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../development/traffic_router.html">Traffic Router</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../development/traffic_monitor.html">Traffic Monitor</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../development/traffic_monitor_golang.html">Traffic Monitor Golang</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../development/traffic_stats.html">Traffic Stats</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../development/traffic_server.html">Traffic Server</a></li>
</ul>
@@ -159,7 +161,7 @@
<div class="rst-content">
<div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
- <li><a href="../../index.html">Traffic Control master</a> »</li>
+ <li><a href="../../index.html">Traffic Control 1.8-dev</a> »</li>
<li><a href="../index.html">Administrator’s Guide</a> »</li>
@@ -308,7 +310,7 @@ round-robin</td>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../../',
- VERSION:'master',
+ VERSION:'1.8-dev',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true
http://git-wip-us.apache.org/repos/asf/incubator-trafficcontrol-website/blob/868aab4e/docs/latest/admin/quick_howto/regionalgeo.html
----------------------------------------------------------------------
diff --git a/docs/latest/admin/quick_howto/regionalgeo.html b/docs/latest/admin/quick_howto/regionalgeo.html
index 5cb7215..8cfeef9 100644
--- a/docs/latest/admin/quick_howto/regionalgeo.html
+++ b/docs/latest/admin/quick_howto/regionalgeo.html
@@ -7,7 +7,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
- <title>Configure Regional Geo-blocking (RGB) — Traffic Control master documentation </title>
+ <title>Configure Regional Geo-blocking (RGB) — Traffic Control 1.8-dev documentation </title>
@@ -33,7 +33,7 @@
- <link rel="top" title="Traffic Control master documentation" href="../../index.html"/>
+ <link rel="top" title="Traffic Control 1.8-dev documentation" href="../../index.html"/>
<link rel="up" title="Quick How To Guides" href="index.html"/>
<link rel="next" title="Configure Delivery Service Steering" href="steering.html"/>
<link rel="prev" title="Configure Federations" href="federations.html"/>
@@ -159,7 +159,7 @@
<div class="rst-content">
<div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
- <li><a href="../../index.html">Traffic Control master</a> »</li>
+ <li><a href="../../index.html">Traffic Control 1.8-dev</a> »</li>
<li><a href="../index.html">Administrator’s Guide</a> »</li>
@@ -305,7 +305,7 @@
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../../',
- VERSION:'master',
+ VERSION:'1.8-dev',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true
http://git-wip-us.apache.org/repos/asf/incubator-trafficcontrol-website/blob/868aab4e/docs/latest/admin/quick_howto/steering.html
----------------------------------------------------------------------
diff --git a/docs/latest/admin/quick_howto/steering.html b/docs/latest/admin/quick_howto/steering.html
index dbb2221..2d8344b 100644
--- a/docs/latest/admin/quick_howto/steering.html
+++ b/docs/latest/admin/quick_howto/steering.html
@@ -7,7 +7,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
- <title>Configure Delivery Service Steering — Traffic Control master documentation </title>
+ <title>Configure Delivery Service Steering — Traffic Control 1.8-dev documentation </title>
@@ -33,7 +33,7 @@
- <link rel="top" title="Traffic Control master documentation" href="../../index.html"/>
+ <link rel="top" title="Traffic Control 1.8-dev documentation" href="../../index.html"/>
<link rel="up" title="Quick How To Guides" href="index.html"/>
<link rel="next" title="Developer\u2019s Guide" href="../../development/index.html"/>
<link rel="prev" title="Configure Regional Geo-blocking (RGB)" href="regionalgeo.html"/>
@@ -159,7 +159,7 @@
<div class="rst-content">
<div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
- <li><a href="../../index.html">Traffic Control master</a> »</li>
+ <li><a href="../../index.html">Traffic Control 1.8-dev</a> »</li>
<li><a href="../index.html">Administrator’s Guide</a> »</li>
@@ -297,7 +297,7 @@
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../../',
- VERSION:'master',
+ VERSION:'1.8-dev',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true
http://git-wip-us.apache.org/repos/asf/incubator-trafficcontrol-website/blob/868aab4e/docs/latest/admin/traffic_monitor.html
----------------------------------------------------------------------
diff --git a/docs/latest/admin/traffic_monitor.html b/docs/latest/admin/traffic_monitor.html
index 18ae89e..10b9981 100644
--- a/docs/latest/admin/traffic_monitor.html
+++ b/docs/latest/admin/traffic_monitor.html
@@ -7,7 +7,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
- <title>Traffic Monitor Administration — Traffic Control master documentation </title>
+ <title>Traffic Monitor Administration — Traffic Control 1.8-dev documentation </title>
@@ -33,9 +33,9 @@
- <link rel="top" title="Traffic Control master documentation" href="../index.html"/>
+ <link rel="top" title="Traffic Control 1.8-dev documentation" href="../index.html"/>
<link rel="up" title="Administrator\u2019s Guide" href="index.html"/>
- <link rel="next" title="Traffic Router Administration" href="traffic_router.html"/>
+ <link rel="next" title="Traffic Monitor Administration" href="traffic_monitor_golang.html"/>
<link rel="prev" title="Traffic Portal Administration" href="traffic_portal.html"/>
@@ -108,6 +108,7 @@
<li class="toctree-l2"><a class="reference internal" href="traffic_ops_extensions.html">Managing Traffic Ops Extensions</a></li>
<li class="toctree-l2"><a class="reference internal" href="traffic_portal.html">Traffic Portal Administration</a></li>
<li class="toctree-l2 current"><a class="current reference internal" href="#">Traffic Monitor Administration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="traffic_monitor_golang.html">Traffic Monitor Administration</a></li>
<li class="toctree-l2"><a class="reference internal" href="traffic_router.html">Traffic Router Administration</a></li>
<li class="toctree-l2"><a class="reference internal" href="traffic_stats.html">Traffic Stats Administration</a></li>
<li class="toctree-l2"><a class="reference internal" href="traffic_server.html">Traffic Server Administration</a></li>
@@ -122,6 +123,7 @@
<li class="toctree-l2"><a class="reference internal" href="../development/traffic_portal.html">Traffic Portal</a></li>
<li class="toctree-l2"><a class="reference internal" href="../development/traffic_router.html">Traffic Router</a></li>
<li class="toctree-l2"><a class="reference internal" href="../development/traffic_monitor.html">Traffic Monitor</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../development/traffic_monitor_golang.html">Traffic Monitor Golang</a></li>
<li class="toctree-l2"><a class="reference internal" href="../development/traffic_stats.html">Traffic Stats</a></li>
<li class="toctree-l2"><a class="reference internal" href="../development/traffic_server.html">Traffic Server</a></li>
</ul>
@@ -159,7 +161,7 @@
<div class="rst-content">
<div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
- <li><a href="../index.html">Traffic Control master</a> »</li>
+ <li><a href="../index.html">Traffic Control 1.8-dev</a> »</li>
<li><a href="index.html">Administrator’s Guide</a> »</li>
@@ -175,7 +177,7 @@
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
- <a href="traffic_router.html" class="btn btn-neutral float-right" title="Traffic Router Administration">Next <span class="fa fa-arrow-circle-right"></span></a>
+ <a href="traffic_monitor_golang.html" class="btn btn-neutral float-right" title="Traffic Monitor Administration">Next <span class="fa fa-arrow-circle-right"></span></a>
<a href="traffic_portal.html" class="btn btn-neutral" title="Traffic Portal Administration"><span class="fa fa-arrow-circle-left"></span> Previous</a>
@@ -186,6 +188,9 @@
<div class="section" id="traffic-monitor-administration">
<h1>Traffic Monitor Administration<a class="headerlink" href="#traffic-monitor-administration" title="Permalink to this headline">�</a></h1>
+<ul class="simple" id="rl-tm-java">
+<li>These instructions are for the Java Traffic Monitor, for the Golang beta, see <span class="xref std std-ref">rl-tm-golang</span>.</li>
+</ul>
<div class="section" id="installing-traffic-monitor">
<h2>Installing Traffic Monitor<a class="headerlink" href="#installing-traffic-monitor" title="Permalink to this headline">�</a></h2>
<p>The following are requirements to ensure an accurate set up:</p>
@@ -201,16 +206,27 @@
<li>perl-WWW-Curl</li>
</ul>
<ol class="arabic">
-<li><p class="first">Enter the Traffic Monitor server into Traffic Ops</p>
+<li><p class="first">Add the Traffic Monitor server into Traffic Ops using ‘Servers’ -> ‘Add Server’. Set the ‘Type’ field to ‘RASCAL’.</p>
</li>
<li><p class="first">Make sure the FQDN of the Traffic Monitor is resolvable in DNS.</p>
</li>
-<li><p class="first">Install Traffic Monitor and Perl mods: <code class="docutils literal"><span class="pre">sudo</span> <span class="pre">yum</span> <span class="pre">-y</span> <span class="pre">install</span> <span class="pre">traffic_monitor</span> <span class="pre">perl-JSON</span> <span class="pre">perl-WWW-Curl</span></code></p>
+<li><p class="first">Get the Traffic Monitor RPM.</p>
+<p>Sample command:</p>
+<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">wget</span> <span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">traffic</span><span class="o">-</span><span class="n">control</span><span class="o">-</span><span class="n">cdn</span><span class="o">.</span><span class="n">net</span><span class="o">/</span><span class="n">downloads</span><span class="o">/</span><span class="mf">1.7</span><span class="o">.</span><span class="mi">0</span><span class="o">/</span><span class="n">RELEASE</span><span class="o">-</span><span class="mf">1.7</span><span class="o">.</span><span class="mi">0</span><span class="o">/</span><span class="n">traffic_monitor</span><span class="o">-</span><span class="mf">1.7</span><span class="o">.</span><span class="mi">0</span><span class="o">-</span><span class="mf">3908.5</span><span class="n">b77f60f</span><span class="o">.</span><span class="n">el6</span><span class="o">.</span><span c
lass="n">x86_64</span><span class="o">.</span><span class="n">rpm</span>
+</pre></div>
+</div>
</li>
-<li><p class="first">Take the config from Traffic Ops - run : <code class="docutils literal"><span class="pre">sudo</span> <span class="pre">/opt/traffic_monitor/bin/traffic_monitor_config.pl</span></code></p>
-<blockquote>
-<div><p>Sample output:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span>traffic_mon # /opt/traffic_monitor/bin/traffic_monitor_config.pl https://traffic-ops.cdn.kabletown.net admin:password prompt
+<li><p class="first">Install Traffic Monitor and Perl modules:</p>
+<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">sudo</span> <span class="n">yum</span> <span class="o">-</span><span class="n">y</span> <span class="n">install</span> <span class="n">traffic_monitor</span><span class="o">-*.</span><span class="n">rpm</span> <span class="n">perl</span><span class="o">-</span><span class="n">JSON</span> <span class="n">perl</span><span class="o">-</span><span class="n">WWW</span><span class="o">-</span><span class="n">Curl</span>
+</pre></div>
+</div>
+</li>
+<li><p class="first">Take the config from Traffic Ops:</p>
+<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">sudo</span> <span class="o">/</span><span class="n">opt</span><span class="o">/</span><span class="n">traffic_monitor</span><span class="o">/</span><span class="nb">bin</span><span class="o">/</span><span class="n">traffic_monitor_config</span><span class="o">.</span><span class="n">pl</span> <span class="n">https</span><span class="p">:</span><span class="o">//<</span><span class="n">traffic</span><span class="o">-</span><span class="n">ops</span><span class="o">-</span><span class="n">URL</span><span class="o">></span> <span class="o"><</span><span class="n">traffic</span><span class="o">-</span><span class="n">ops</span><span class="o">-</span><span class="n">user</span><span class="o">></span><span class="p">:</span><span class="o"><</span><span class="n">traffic</span><span class="o">-</span><span class="n">ops</span><span class="o">-</span><span class="n">password</span><span
class="o">></span> <span class="n">prompt</span>
+</pre></div>
+</div>
+<p>Sample session:</p>
+<div class="highlight-default"><div class="highlight"><pre><span></span>traffic_mon # /opt/traffic_monitor/bin/traffic_monitor_config.pl https://traffic-ops.cdn.kabletown.net admin:kl0tevax prompt
DEBUG: traffic_ops selected: https://traffic-ops.cdn.kabletown.net
DEBUG: traffic_ops login: admin:kl0tevax
DEBUG: Config write mode: prompt
@@ -290,7 +306,11 @@ DEBUG: Writing /opt/traffic_monitor/conf/traffic_monitor_config.js
traffic_mon #
</pre></div>
</div>
-</div></blockquote>
+</li>
+<li><p class="first">Update the ‘allow_ip’ and ‘allow_ip6’ parameters in the profiles of all caches defined in traffic ops, both edge and mid,
+with the address of the traffic monitor being installed, so that the traffic servers will allow this Traffic Monitor
+to access the astats plugin.
+For details see <a class="reference internal" href="traffic_ops_config.html#rl-param-prof"><span class="std std-ref">Profile Parameters</span></a> in the <em>Configuring Traffic Ops</em> section.</p>
</li>
<li><p class="first">Start Tomcat: <code class="docutils literal"><span class="pre">sudo</span> <span class="pre">service</span> <span class="pre">tomcat</span> <span class="pre">start</span></code></p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">Using</span> <span class="n">CATALINA_BASE</span><span class="p">:</span> <span class="o">/</span><span class="n">opt</span><span class="o">/</span><span class="n">tomcat</span>
@@ -303,7 +323,15 @@ traffic_mon #
</pre></div>
</div>
</li>
-<li><p class="first">Verify Traffic Monitor is running by pointing your browser to port 80 on the Traffic Monitor host.</p>
+<li><p class="first">Configure tomcat to start automatically: <code class="docutils literal"><span class="pre">sudo</span> <span class="pre">chkconfig</span> <span class="pre">tomcat</span> <span class="pre">on</span></code></p>
+</li>
+<li><p class="first">Verify Traffic Monitor is running by pointing your browser to port 80 on the Traffic Monitor host:</p>
+<ul class="simple">
+<li>The ‘Cache States’ tab should display all Mid and Edge caches configured in Traffic Ops.</li>
+<li>The ‘DeliveryService States’ tab should display all delivery services configured in Traffic Ops.</li>
+</ul>
+</li>
+<li><p class="first">In Traffic Ops servers table, click ‘Edit’ for this server, then click ‘Online’.</p>
</li>
</ol>
</div>
@@ -311,7 +339,11 @@ traffic_mon #
<h2>Configuring Traffic Monitor<a class="headerlink" href="#configuring-traffic-monitor" title="Permalink to this headline">�</a></h2>
<div class="section" id="configuration-overview">
<h3>Configuration Overview<a class="headerlink" href="#configuration-overview" title="Permalink to this headline">�</a></h3>
-<p>Traffic Monitor is configured using its JSON configuration file, <code class="docutils literal"><span class="pre">traffic_monitor_config.js</span></code>. Specify the URL, username, password, and CDN name for the instance of Traffic Ops for which this Traffic Monitor is a member, and start the software. Once started with the correct configuration, Traffic Monitor downloads its configuration from Traffic Ops and begins polling caches. Once a configurable number of polling cycles completes, health protocol state is available via RESTful JSON endpoints.</p>
+<p>Traffic Monitor is configured using its JSON configuration file, <code class="docutils literal"><span class="pre">/opt/traffic_monitor/conf/traffic_monitor_config.js</span></code>.
+This file is created by <code class="docutils literal"><span class="pre">traffic_monitor_config.pl</span></code> script, and among other things, it contains the Traffic Ops URL and the user:password
+specified during the invocation of that script.</p>
+<p>When started, Traffic Monitor uses this basic configuration to downloads its configuration from Traffic Ops, and begins polling caches.
+Once a configurable number of polling cycles completes, health protocol state is available via RESTful JSON endpoints.</p>
</div>
</div>
<div class="section" id="troubleshooting-and-log-files">
@@ -326,7 +358,7 @@ traffic_mon #
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
- <a href="traffic_router.html" class="btn btn-neutral float-right" title="Traffic Router Administration">Next <span class="fa fa-arrow-circle-right"></span></a>
+ <a href="traffic_monitor_golang.html" class="btn btn-neutral float-right" title="Traffic Monitor Administration">Next <span class="fa fa-arrow-circle-right"></span></a>
<a href="traffic_portal.html" class="btn btn-neutral" title="Traffic Portal Administration"><span class="fa fa-arrow-circle-left"></span> Previous</a>
@@ -358,7 +390,7 @@ traffic_mon #
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
- VERSION:'master',
+ VERSION:'1.8-dev',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true
http://git-wip-us.apache.org/repos/asf/incubator-trafficcontrol-website/blob/868aab4e/docs/latest/admin/traffic_monitor_golang.html
----------------------------------------------------------------------
diff --git a/docs/latest/admin/traffic_monitor_golang.html b/docs/latest/admin/traffic_monitor_golang.html
new file mode 100644
index 0000000..4ef477b
--- /dev/null
+++ b/docs/latest/admin/traffic_monitor_golang.html
@@ -0,0 +1,304 @@
+
+
+<!DOCTYPE html>
+<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
+<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
+<head>
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
+
+ <title>Traffic Monitor Administration — Traffic Control 1.8-dev documentation </title>
+
+
+
+
+ <link rel="shortcut icon" href="../_static/favicon.ico"/>
+
+
+
+
+
+
+
+
+
+
+
+
+ <link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
+
+
+
+ <link rel="stylesheet" href="../_static/theme_overrides.css" type="text/css" />
+
+
+
+ <link rel="top" title="Traffic Control 1.8-dev documentation" href="../index.html"/>
+ <link rel="up" title="Administrator\u2019s Guide" href="index.html"/>
+ <link rel="next" title="Traffic Router Administration" href="traffic_router.html"/>
+ <link rel="prev" title="Traffic Monitor Administration" href="traffic_monitor.html"/>
+
+
+ <script src="_static/js/modernizr.min.js"></script>
+
+</head>
+
+<body class="wy-body-for-nav" role="document">
+
+ <div class="wy-grid-for-nav">
+
+
+ <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+ <div class="wy-side-nav-search">
+
+
+
+ <a href="/" class="icon icon-home"> Traffic Control
+
+
+
+
+ <img src="../_static/tc_logo_c_only.png" class="logo" />
+
+ </a>
+
+
+<div role="search">
+ <form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
+ <input type="text" name="q" placeholder="Search docs" />
+ <input type="hidden" name="check_keywords" value="yes" />
+ <input type="hidden" name="area" value="default" />
+ </form>
+</div>
+
+
+ </div>
+
+ <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
+
+
+
+ <ul>
+<li class="toctree-l1"><a class="reference internal" href="../basics/index.html">CDN Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../basics/content_delivery_networks.html">Content Delivery Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/http_11.html">HTTP 1.1</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/caching_proxies.html">Caching Proxies</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/cache_revalidation.html">Cache Control Headers and Revalidation</a></li>
+</ul>
+</li>
+</ul>
+<ul>
+<li class="toctree-l1"><a class="reference internal" href="../overview/index.html">Traffic Control Overview</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../overview/introduction.html">Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../overview/traffic_ops.html">Traffic Ops</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../overview/traffic_portal.html">Traffic Portal</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../overview/traffic_router.html">Traffic Router</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../overview/traffic_monitor.html">Traffic Monitor</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../overview/traffic_stats.html">Traffic Stats</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../overview/traffic_server.html">Traffic Server</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../overview/traffic_vault.html">Traffic Vault</a></li>
+</ul>
+</li>
+</ul>
+<ul class="current">
+<li class="toctree-l1 current"><a class="reference internal" href="index.html">Administrator’s Guide</a><ul class="current">
+<li class="toctree-l2"><a class="reference internal" href="traffic_ops_install.html">Installing Traffic Ops</a></li>
+<li class="toctree-l2"><a class="reference internal" href="traffic_ops_config.html">Configuring Traffic Ops</a></li>
+<li class="toctree-l2"><a class="reference internal" href="traffic_ops_using.html">Using Traffic Ops</a></li>
+<li class="toctree-l2"><a class="reference internal" href="traffic_ops_extensions.html">Managing Traffic Ops Extensions</a></li>
+<li class="toctree-l2"><a class="reference internal" href="traffic_portal.html">Traffic Portal Administration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="traffic_monitor.html">Traffic Monitor Administration</a></li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">Traffic Monitor Administration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="traffic_router.html">Traffic Router Administration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="traffic_stats.html">Traffic Stats Administration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="traffic_server.html">Traffic Server Administration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="traffic_vault.html">Traffic Vault Administration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="quick_howto/index.html">Quick How To Guides</a></li>
+</ul>
+</li>
+</ul>
+<ul>
+<li class="toctree-l1"><a class="reference internal" href="../development/index.html">Developer’s Guide</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../development/traffic_ops.html">Traffic Ops</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../development/traffic_portal.html">Traffic Portal</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../development/traffic_router.html">Traffic Router</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../development/traffic_monitor.html">Traffic Monitor</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../development/traffic_monitor_golang.html">Traffic Monitor Golang</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../development/traffic_stats.html">Traffic Stats</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../development/traffic_server.html">Traffic Server</a></li>
+</ul>
+</li>
+</ul>
+<ul>
+<li class="toctree-l1"><a class="reference internal" href="../faq/index.html">FAQ</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../faq/general.html">General</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../faq/development.html">Development</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../faq/administration.html">Running a Traffic Control CDN</a></li>
+</ul>
+</li>
+</ul>
+<ul>
+<li class="toctree-l1"><a class="reference internal" href="../glossary.html">Glossary</a></li>
+</ul>
+
+
+
+ </div>
+
+ </nav>
+
+ <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
+
+
+ <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
+ <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+ <a href="../index.html">Traffic Control</a>
+ </nav>
+
+
+
+ <div class="wy-nav-content">
+ <div class="rst-content">
+ <div role="navigation" aria-label="breadcrumbs navigation">
+ <ul class="wy-breadcrumbs">
+ <li><a href="../index.html">Traffic Control 1.8-dev</a> »</li>
+
+ <li><a href="index.html">Administrator’s Guide</a> »</li>
+
+ <li>Traffic Monitor Administration</li>
+ <li class="wy-breadcrumbs-aside">
+
+ <a href="../_sources/admin/traffic_monitor_golang.txt" rel="nofollow"> View page source</a>
+
+ </li>
+ </ul>
+ <hr/>
+</div>
+
+ <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
+
+ <a href="traffic_router.html" class="btn btn-neutral float-right" title="Traffic Router Administration">Next <span class="fa fa-arrow-circle-right"></span></a>
+
+
+ <a href="traffic_monitor.html" class="btn btn-neutral" title="Traffic Monitor Administration"><span class="fa fa-arrow-circle-left"></span> Previous</a>
+
+ </div>
+
+ <div role="main" class="document">
+
+ <div class="section" id="traffic-monitor-administration">
+<h1>Traffic Monitor Administration<a class="headerlink" href="#traffic-monitor-administration" title="Permalink to this headline">�</a></h1>
+<ul class="simple" id="rl-tm-golang">
+<li>These instructions are for the beta Golang Traffic Monitor, for the old Java version, see <span class="xref std std-ref">rl-tm-java</span>.</li>
+</ul>
+<div class="section" id="installing-traffic-monitor">
+<h2>Installing Traffic Monitor<a class="headerlink" href="#installing-traffic-monitor" title="Permalink to this headline">�</a></h2>
+<p>The following are requirements to ensure an accurate set up:</p>
+<ul class="simple">
+<li>CentOS 6</li>
+<li>8 vCPUs</li>
+<li>16GB RAM</li>
+<li>Successful install of Traffic Ops</li>
+<li>Administrative access to the Traffic Ops</li>
+<li>Physical address of the site</li>
+</ul>
+<ol class="arabic">
+<li><p class="first">Enter the Traffic Monitor server into Traffic Ops</p>
+</li>
+<li><p class="first">Make sure the FQDN of the Traffic Monitor is resolvable in DNS.</p>
+</li>
+<li><p class="first">Install Traffic Monitor: <code class="docutils literal"><span class="pre">sudo</span> <span class="pre">yum</span> <span class="pre">-y</span> <span class="pre">install</span> <span class="pre">traffic_monitor</span></code></p>
+</li>
+<li><p class="first">Configure Traffic Monitor. See <span class="xref std std-ref">rl-tm-configure</span></p>
+</li>
+<li><p class="first">Start the service: <code class="docutils literal"><span class="pre">sudo</span> <span class="pre">service</span> <span class="pre">traffic_monitor</span> <span class="pre">start</span></code></p>
+<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">Starting</span> <span class="n">traffic_monitor</span><span class="p">:</span>
+</pre></div>
+</div>
+</li>
+<li><p class="first">Verify Traffic Monitor is running by pointing your browser to port 80 on the Traffic Monitor host.</p>
+</li>
+</ol>
+</div>
+<div class="section" id="configuring-traffic-monitor">
+<h2>Configuring Traffic Monitor<a class="headerlink" href="#configuring-traffic-monitor" title="Permalink to this headline">�</a></h2>
+<div class="section" id="configuration-overview">
+<h3>Configuration Overview<a class="headerlink" href="#configuration-overview" title="Permalink to this headline">�</a></h3>
+<p id="rl-tm-configure">Traffic Monitor is configured via two JSON configuration files, <code class="docutils literal"><span class="pre">traffic_ops.cfg</span></code> and <code class="docutils literal"><span class="pre">traffic_monitor.cfg</span></code>, by default located in the <code class="docutils literal"><span class="pre">conf</span></code> directory in the install location.</p>
+<p>The <code class="docutils literal"><span class="pre">traffic_ops.cfg</span></code> config contains Traffic Ops connection information. Specify the URL, username, and password for the instance of Traffic Ops for which this Traffic Monitor is a member.</p>
+<p>The <code class="docutils literal"><span class="pre">traffic_monitor.cfg</span></code> config contains log file locations, as well as detailed application configuration variables, such as processing flush times and initial poll intervals.</p>
+<p>Once started with the correct configuration, Traffic Monitor downloads its configuration from Traffic Ops and begins polling caches. Once every cache has been polled, health protocol state is available via RESTful JSON endpoints.</p>
+</div>
+</div>
+<div class="section" id="troubleshooting-and-log-files">
+<h2>Troubleshooting and log files<a class="headerlink" href="#troubleshooting-and-log-files" title="Permalink to this headline">�</a></h2>
+<p>Traffic Monitor log files are in <code class="docutils literal"><span class="pre">/opt/traffic_monitor/var/log/</span></code>.</p>
+</div>
+</div>
+
+
+ </div>
+ <footer>
+
+ <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
+
+ <a href="traffic_router.html" class="btn btn-neutral float-right" title="Traffic Router Administration">Next <span class="fa fa-arrow-circle-right"></span></a>
+
+
+ <a href="traffic_monitor.html" class="btn btn-neutral" title="Traffic Monitor Administration"><span class="fa fa-arrow-circle-left"></span> Previous</a>
+
+ </div>
+
+
+ <hr/>
+
+ <div role="contentinfo">
+ <p>
+ </p>
+ </div>
+ Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
+
+</footer>
+
+ </div>
+ </div>
+
+ </section>
+
+ </div>
+
+
+
+
+
+ <script type="text/javascript">
+ var DOCUMENTATION_OPTIONS = {
+ URL_ROOT:'../',
+ VERSION:'1.8-dev',
+ COLLAPSE_INDEX:false,
+ FILE_SUFFIX:'.html',
+ HAS_SOURCE: true
+ };
+ </script>
+ <script type="text/javascript" src="../_static/jquery.js"></script>
+ <script type="text/javascript" src="../_static/underscore.js"></script>
+ <script type="text/javascript" src="../_static/doctools.js"></script>
+
+
+
+
+
+ <script type="text/javascript" src="../_static/js/theme.js"></script>
+
+
+
+
+ <script type="text/javascript">
+ jQuery(function () {
+ SphinxRtdTheme.StickyNav.enable();
+ });
+ </script>
+
+
+</body>
+</html>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/incubator-trafficcontrol-website/blob/868aab4e/docs/latest/admin/traffic_ops_config.html
----------------------------------------------------------------------
diff --git a/docs/latest/admin/traffic_ops_config.html b/docs/latest/admin/traffic_ops_config.html
index bd4e204..9c86bbb 100644
--- a/docs/latest/admin/traffic_ops_config.html
+++ b/docs/latest/admin/traffic_ops_config.html
@@ -7,7 +7,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
- <title>Configuring Traffic Ops — Traffic Control master documentation </title>
+ <title>Configuring Traffic Ops — Traffic Control 1.8-dev documentation </title>
@@ -33,7 +33,7 @@
- <link rel="top" title="Traffic Control master documentation" href="../index.html"/>
+ <link rel="top" title="Traffic Control 1.8-dev documentation" href="../index.html"/>
<link rel="up" title="Administrator\u2019s Guide" href="index.html"/>
<link rel="next" title="Using Traffic Ops" href="traffic_ops_using.html"/>
<link rel="prev" title="Installing Traffic Ops" href="traffic_ops_install.html"/>
@@ -108,6 +108,7 @@
<li class="toctree-l2"><a class="reference internal" href="traffic_ops_extensions.html">Managing Traffic Ops Extensions</a></li>
<li class="toctree-l2"><a class="reference internal" href="traffic_portal.html">Traffic Portal Administration</a></li>
<li class="toctree-l2"><a class="reference internal" href="traffic_monitor.html">Traffic Monitor Administration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="traffic_monitor_golang.html">Traffic Monitor Administration</a></li>
<li class="toctree-l2"><a class="reference internal" href="traffic_router.html">Traffic Router Administration</a></li>
<li class="toctree-l2"><a class="reference internal" href="traffic_stats.html">Traffic Stats Administration</a></li>
<li class="toctree-l2"><a class="reference internal" href="traffic_server.html">Traffic Server Administration</a></li>
@@ -122,6 +123,7 @@
<li class="toctree-l2"><a class="reference internal" href="../development/traffic_portal.html">Traffic Portal</a></li>
<li class="toctree-l2"><a class="reference internal" href="../development/traffic_router.html">Traffic Router</a></li>
<li class="toctree-l2"><a class="reference internal" href="../development/traffic_monitor.html">Traffic Monitor</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../development/traffic_monitor_golang.html">Traffic Monitor Golang</a></li>
<li class="toctree-l2"><a class="reference internal" href="../development/traffic_stats.html">Traffic Stats</a></li>
<li class="toctree-l2"><a class="reference internal" href="../development/traffic_server.html">Traffic Server</a></li>
</ul>
@@ -159,7 +161,7 @@
<div class="rst-content">
<div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
- <li><a href="../index.html">Traffic Control master</a> »</li>
+ <li><a href="../index.html">Traffic Control 1.8-dev</a> »</li>
<li><a href="index.html">Administrator’s Guide</a> »</li>
@@ -512,7 +514,7 @@ This value is set to 0 by default. Enable with a value of 1. Use of this featu
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
- VERSION:'master',
+ VERSION:'1.8-dev',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true
http://git-wip-us.apache.org/repos/asf/incubator-trafficcontrol-website/blob/868aab4e/docs/latest/admin/traffic_ops_extensions.html
----------------------------------------------------------------------
diff --git a/docs/latest/admin/traffic_ops_extensions.html b/docs/latest/admin/traffic_ops_extensions.html
index ad8a547..0ae22fc 100644
--- a/docs/latest/admin/traffic_ops_extensions.html
+++ b/docs/latest/admin/traffic_ops_extensions.html
@@ -7,7 +7,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
- <title>Managing Traffic Ops Extensions — Traffic Control master documentation </title>
+ <title>Managing Traffic Ops Extensions — Traffic Control 1.8-dev documentation </title>
@@ -33,7 +33,7 @@
- <link rel="top" title="Traffic Control master documentation" href="../index.html"/>
+ <link rel="top" title="Traffic Control 1.8-dev documentation" href="../index.html"/>
<link rel="up" title="Administrator\u2019s Guide" href="index.html"/>
<link rel="next" title="Traffic Portal Administration" href="traffic_portal.html"/>
<link rel="prev" title="Using Traffic Ops" href="traffic_ops_using.html"/>
@@ -159,7 +159,7 @@
<div class="rst-content">
<div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
- <li><a href="../index.html">Traffic Control master</a> »</li>
+ <li><a href="../index.html">Traffic Control 1.8-dev</a> »</li>
<li><a href="index.html">Administrator’s Guide</a> »</li>
@@ -287,7 +287,7 @@ where:
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
- VERSION:'master',
+ VERSION:'1.8-dev',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true
http://git-wip-us.apache.org/repos/asf/incubator-trafficcontrol-website/blob/868aab4e/docs/latest/admin/traffic_ops_install.html
----------------------------------------------------------------------
diff --git a/docs/latest/admin/traffic_ops_install.html b/docs/latest/admin/traffic_ops_install.html
index 2518499..e68fe6b 100644
--- a/docs/latest/admin/traffic_ops_install.html
+++ b/docs/latest/admin/traffic_ops_install.html
@@ -7,7 +7,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
- <title>Installing Traffic Ops — Traffic Control master documentation </title>
+ <title>Installing Traffic Ops — Traffic Control 1.8-dev documentation </title>
@@ -33,7 +33,7 @@
- <link rel="top" title="Traffic Control master documentation" href="../index.html"/>
+ <link rel="top" title="Traffic Control 1.8-dev documentation" href="../index.html"/>
<link rel="up" title="Administrator\u2019s Guide" href="index.html"/>
<link rel="next" title="Configuring Traffic Ops" href="traffic_ops_config.html"/>
<link rel="prev" title="Administrator\u2019s Guide" href="index.html"/>
@@ -108,6 +108,7 @@
<li class="toctree-l2"><a class="reference internal" href="traffic_ops_extensions.html">Managing Traffic Ops Extensions</a></li>
<li class="toctree-l2"><a class="reference internal" href="traffic_portal.html">Traffic Portal Administration</a></li>
<li class="toctree-l2"><a class="reference internal" href="traffic_monitor.html">Traffic Monitor Administration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="traffic_monitor_golang.html">Traffic Monitor Administration</a></li>
<li class="toctree-l2"><a class="reference internal" href="traffic_router.html">Traffic Router Administration</a></li>
<li class="toctree-l2"><a class="reference internal" href="traffic_stats.html">Traffic Stats Administration</a></li>
<li class="toctree-l2"><a class="reference internal" href="traffic_server.html">Traffic Server Administration</a></li>
@@ -122,6 +123,7 @@
<li class="toctree-l2"><a class="reference internal" href="../development/traffic_portal.html">Traffic Portal</a></li>
<li class="toctree-l2"><a class="reference internal" href="../development/traffic_router.html">Traffic Router</a></li>
<li class="toctree-l2"><a class="reference internal" href="../development/traffic_monitor.html">Traffic Monitor</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../development/traffic_monitor_golang.html">Traffic Monitor Golang</a></li>
<li class="toctree-l2"><a class="reference internal" href="../development/traffic_stats.html">Traffic Stats</a></li>
<li class="toctree-l2"><a class="reference internal" href="../development/traffic_server.html">Traffic Server</a></li>
</ul>
@@ -159,7 +161,7 @@
<div class="rst-content">
<div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
- <li><a href="../index.html">Traffic Control master</a> »</li>
+ <li><a href="../index.html">Traffic Control 1.8-dev</a> »</li>
<li><a href="index.html">Administrator’s Guide</a> »</li>
@@ -570,6 +572,112 @@ use this user to login for the first time and create other users</td>
</ol>
</div>
</div>
+<div class="section" id="manually-generating-and-installing-the-ssl-certificate">
+<h2>Manually Generating and Installing the SSL Certificate<a class="headerlink" href="#manually-generating-and-installing-the-ssl-certificate" title="Permalink to this headline">�</a></h2>
+<div class="admonition note">
+<p class="first admonition-title">Note</p>
+<p class="last">This section is valid for traffic-control 2.0.0 and later.</p>
+</div>
+<div class="section" id="self-signed-certificate-development">
+<h3>Self-signed Certificate (Development)<a class="headerlink" href="#self-signed-certificate-development" title="Permalink to this headline">�</a></h3>
+<blockquote>
+<div><p>Example Procedure:</p>
+<div class="highlight-default"><div class="highlight"><pre><span></span>$ openssl genrsa -des3 -passout pass:x -out localhost.pass.key 2048
+Generating RSA private key, 2048 bit long modulus
+...
+$ openssl rsa -passin pass:x -in localhost.pass.key -out localhost.key
+writing RSA key
+$ rm localhost.pass.key
+
+$ openssl req -new -key localhost.key -out localhost.csr
+You are about to be asked to enter information that will be incorporated
+into your certificate request.
+What you are about to enter is what is called a Distinguished Name or a DN.
+There are quite a few fields but you can leave some blank
+For some fields there will be a default value,
+If you enter '.', the field will be left blank.
+-----
+Country Name (2 letter code) [XX]:US<enter>
+State or Province Name (full name) []:CO<enter>
+Locality Name (eg, city) [Default City]:Denver<enter>
+Organization Name (eg, company) [Default Company Ltd]: <enter>
+Organizational Unit Name (eg, section) []: <enter>
+Common Name (eg, your name or your server's hostname) []: <enter>
+Email Address []: <enter>
+
+Please enter the following 'extra' attributes
+to be sent with your certificate request
+A challenge password []: pass<enter>
+An optional company name []: <enter>
+$ openssl x509 -req -sha256 -days 365 -in localhost.csr -signkey localhost.key -out localhost.crt
+Signature ok
+subject=/C=US/ST=CO/L=Denver/O=Default Company Ltd
+Getting Private key
+$ sudo cp localhost.crt /etc/pki/tls/certs
+$ sudo cp localhost.key /etc/pki/tls/private
+$ sudo chown trafops:trafops /etc/pki/tls/certs/localhost.crt
+$ sudo chown trafops:trafops /etc/pki/tls/private/localhost.key
+</pre></div>
+</div>
+</div></blockquote>
+</div>
+<div class="section" id="certificate-from-certificate-authority-production">
+<h3>Certificate from Certificate Authority (Production)<a class="headerlink" href="#certificate-from-certificate-authority-production" title="Permalink to this headline">�</a></h3>
+<div class="admonition note">
+<p class="first admonition-title">Note</p>
+<p>You will need to know the appropriate answers when generating the certificate request file <cite>trafficopss.csr</cite> below.</p>
+<p>Example Procedure:</p>
+<div class="last highlight-default"><div class="highlight"><pre><span></span>$ openssl genrsa -des3 -passout pass:x -out trafficops.pass.key 2048
+Generating RSA private key, 2048 bit long modulus
+...
+$ openssl rsa -passin pass:x -in trafficops.pass.key -out trafficops.key
+writing RSA key
+$ rm localhost.pass.key
+
+Generate the Certificate Signing Request (CSR) file needed for Certificate Authority (CA) request.
+
+$ openssl req -new -key trafficops.key -out trafficops.csr
+You are about to be asked to enter information that will be incorporated
+into your certificate request.
+What you are about to enter is what is called a Distinguished Name or a DN.
+There are quite a few fields but you can leave some blank
+For some fields there will be a default value,
+If you enter '.', the field will be left blank.
+-----
+Country Name (2 letter code) [XX]: <enter country code>
+State or Province Name (full name) []: <enter state or province>
+Locality Name (eg, city) [Default City]: <enter locality name>
+Organization Name (eg, company) [Default Company Ltd]: <enter organization name>
+Organizational Unit Name (eg, section) []: <enter organizational unit name>
+Common Name (eg, your name or your server's hostname) []: <enter server's hostname name>
+Email Address []: <enter e-mail address>
+
+Please enter the following 'extra' attributes
+to be sent with your certificate request
+A challenge password []: <enter challenge password>
+An optional company name []: <enter>
+$ sudo cp trafficops.key /etc/pki/tls/private
+$ sudo chown trafops:trafops /etc/pki/tls/private/trafficops.key
+
+You must then take the output file trafficops.csr and submit a request to your Certificate Authority (CA).
+Once you get approved and receive your trafficops.crt file:
+
+$ sudo cp trafficops.crt /etc/pki/tls/certs
+$ sudo chown trafops:trafops /etc/pki/tls/certs/trafficops.crt
+
+If necessary, install the CA certificates .pem and .crt in /etc/pki/tls/certs.
+
+You will need to update the file /opt/traffic_ops/app/conf/cdn.conf with the following changes:
+ ...
+ e.g. given trafficops.crt and trafficops.key
+ 'hypnotoad' => ...
+ 'listen' => 'https://[::]:443?cert=/etc/pki/tls/certs/trafficops.crt&key=/etc/pki/tls/private/trafficops.key&ca=/etc/pki/tls/certs/localhost.ca&verify=0x00&ciphers=AES128-GCM-SHA256:HIGH:!RC4:!MD5:!aNULL:!EDH:!ED'
+ ...
+</pre></div>
+</div>
+</div>
+</div>
+</div>
</div>
@@ -610,7 +718,7 @@ use this user to login for the first time and create other users</td>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
- VERSION:'master',
+ VERSION:'1.8-dev',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true
http://git-wip-us.apache.org/repos/asf/incubator-trafficcontrol-website/blob/868aab4e/docs/latest/admin/traffic_ops_using.html
----------------------------------------------------------------------
diff --git a/docs/latest/admin/traffic_ops_using.html b/docs/latest/admin/traffic_ops_using.html
index 3cce063..d045c14 100644
--- a/docs/latest/admin/traffic_ops_using.html
+++ b/docs/latest/admin/traffic_ops_using.html
@@ -7,7 +7,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
- <title>Using Traffic Ops — Traffic Control master documentation </title>
+ <title>Using Traffic Ops — Traffic Control 1.8-dev documentation </title>
@@ -33,7 +33,7 @@
- <link rel="top" title="Traffic Control master documentation" href="../index.html"/>
+ <link rel="top" title="Traffic Control 1.8-dev documentation" href="../index.html"/>
<link rel="up" title="Administrator\u2019s Guide" href="index.html"/>
<link rel="next" title="Managing Traffic Ops Extensions" href="traffic_ops_extensions.html"/>
<link rel="prev" title="Configuring Traffic Ops" href="traffic_ops_config.html"/>
@@ -108,6 +108,7 @@
<li class="toctree-l2"><a class="reference internal" href="traffic_ops_extensions.html">Managing Traffic Ops Extensions</a></li>
<li class="toctree-l2"><a class="reference internal" href="traffic_portal.html">Traffic Portal Administration</a></li>
<li class="toctree-l2"><a class="reference internal" href="traffic_monitor.html">Traffic Monitor Administration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="traffic_monitor_golang.html">Traffic Monitor Administration</a></li>
<li class="toctree-l2"><a class="reference internal" href="traffic_router.html">Traffic Router Administration</a></li>
<li class="toctree-l2"><a class="reference internal" href="traffic_stats.html">Traffic Stats Administration</a></li>
<li class="toctree-l2"><a class="reference internal" href="traffic_server.html">Traffic Server Administration</a></li>
@@ -122,6 +123,7 @@
<li class="toctree-l2"><a class="reference internal" href="../development/traffic_portal.html">Traffic Portal</a></li>
<li class="toctree-l2"><a class="reference internal" href="../development/traffic_router.html">Traffic Router</a></li>
<li class="toctree-l2"><a class="reference internal" href="../development/traffic_monitor.html">Traffic Monitor</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../development/traffic_monitor_golang.html">Traffic Monitor Golang</a></li>
<li class="toctree-l2"><a class="reference internal" href="../development/traffic_stats.html">Traffic Stats</a></li>
<li class="toctree-l2"><a class="reference internal" href="../development/traffic_server.html">Traffic Server</a></li>
</ul>
@@ -159,7 +161,7 @@
<div class="rst-content">
<div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
- <li><a href="../index.html">Traffic Control master</a> »</li>
+ <li><a href="../index.html">Traffic Control 1.8-dev</a> »</li>
<li><a href="index.html">Administrator’s Guide</a> »</li>
@@ -1653,7 +1655,7 @@ between the active CRConfig and the CRConfig about to be written.</p>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
- VERSION:'master',
+ VERSION:'1.8-dev',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true
http://git-wip-us.apache.org/repos/asf/incubator-trafficcontrol-website/blob/868aab4e/docs/latest/admin/traffic_portal.html
----------------------------------------------------------------------
diff --git a/docs/latest/admin/traffic_portal.html b/docs/latest/admin/traffic_portal.html
index 85331af..1503b3d 100644
--- a/docs/latest/admin/traffic_portal.html
+++ b/docs/latest/admin/traffic_portal.html
@@ -7,7 +7,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
- <title>Traffic Portal Administration — Traffic Control master documentation </title>
+ <title>Traffic Portal Administration — Traffic Control 1.8-dev documentation </title>
@@ -33,7 +33,7 @@
- <link rel="top" title="Traffic Control master documentation" href="../index.html"/>
+ <link rel="top" title="Traffic Control 1.8-dev documentation" href="../index.html"/>
<link rel="up" title="Administrator\u2019s Guide" href="index.html"/>
<link rel="next" title="Traffic Monitor Administration" href="traffic_monitor.html"/>
<link rel="prev" title="Managing Traffic Ops Extensions" href="traffic_ops_extensions.html"/>
@@ -159,7 +159,7 @@
<div class="rst-content">
<div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
- <li><a href="../index.html">Traffic Control master</a> »</li>
+ <li><a href="../index.html">Traffic Control 1.8-dev</a> »</li>
<li><a href="index.html">Administrator’s Guide</a> »</li>
@@ -263,7 +263,7 @@
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
- VERSION:'master',
+ VERSION:'1.8-dev',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true
http://git-wip-us.apache.org/repos/asf/incubator-trafficcontrol-website/blob/868aab4e/docs/latest/admin/traffic_router.html
----------------------------------------------------------------------
diff --git a/docs/latest/admin/traffic_router.html b/docs/latest/admin/traffic_router.html
index 224ccb3..fa6e8b8 100644
--- a/docs/latest/admin/traffic_router.html
+++ b/docs/latest/admin/traffic_router.html
@@ -7,7 +7,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
- <title>Traffic Router Administration — Traffic Control master documentation </title>
+ <title>Traffic Router Administration — Traffic Control 1.8-dev documentation </title>
@@ -33,7 +33,7 @@
- <link rel="top" title="Traffic Control master documentation" href="../index.html"/>
+ <link rel="top" title="Traffic Control 1.8-dev documentation" href="../index.html"/>
<link rel="up" title="Administrator\u2019s Guide" href="index.html"/>
<link rel="next" title="Traffic Stats Administration" href="traffic_stats.html"/>
<link rel="prev" title="Traffic Monitor Administration" href="traffic_monitor.html"/>
@@ -159,7 +159,7 @@
<div class="rst-content">
<div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
- <li><a href="../index.html">Traffic Control master</a> »</li>
+ <li><a href="../index.html">Traffic Control 1.8-dev</a> »</li>
<li><a href="index.html">Administrator’s Guide</a> »</li>
@@ -904,7 +904,7 @@ in setenv.sh will override init scripts in /etc/init.d/tomcat.</p>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
- VERSION:'master',
+ VERSION:'1.8-dev',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true
http://git-wip-us.apache.org/repos/asf/incubator-trafficcontrol-website/blob/868aab4e/docs/latest/admin/traffic_server.html
----------------------------------------------------------------------
diff --git a/docs/latest/admin/traffic_server.html b/docs/latest/admin/traffic_server.html
index 10e4c61..bb43c99 100644
--- a/docs/latest/admin/traffic_server.html
+++ b/docs/latest/admin/traffic_server.html
@@ -7,7 +7,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
- <title>Traffic Server Administration — Traffic Control master documentation </title>
+ <title>Traffic Server Administration — Traffic Control 1.8-dev documentation </title>
@@ -33,7 +33,7 @@
- <link rel="top" title="Traffic Control master documentation" href="../index.html"/>
+ <link rel="top" title="Traffic Control 1.8-dev documentation" href="../index.html"/>
<link rel="up" title="Administrator\u2019s Guide" href="index.html"/>
<link rel="next" title="Traffic Vault Administration" href="traffic_vault.html"/>
<link rel="prev" title="Traffic Stats Administration" href="traffic_stats.html"/>
@@ -108,6 +108,7 @@
<li class="toctree-l2"><a class="reference internal" href="traffic_ops_extensions.html">Managing Traffic Ops Extensions</a></li>
<li class="toctree-l2"><a class="reference internal" href="traffic_portal.html">Traffic Portal Administration</a></li>
<li class="toctree-l2"><a class="reference internal" href="traffic_monitor.html">Traffic Monitor Administration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="traffic_monitor_golang.html">Traffic Monitor Administration</a></li>
<li class="toctree-l2"><a class="reference internal" href="traffic_router.html">Traffic Router Administration</a></li>
<li class="toctree-l2"><a class="reference internal" href="traffic_stats.html">Traffic Stats Administration</a></li>
<li class="toctree-l2 current"><a class="current reference internal" href="#">Traffic Server Administration</a></li>
@@ -122,6 +123,7 @@
<li class="toctree-l2"><a class="reference internal" href="../development/traffic_portal.html">Traffic Portal</a></li>
<li class="toctree-l2"><a class="reference internal" href="../development/traffic_router.html">Traffic Router</a></li>
<li class="toctree-l2"><a class="reference internal" href="../development/traffic_monitor.html">Traffic Monitor</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../development/traffic_monitor_golang.html">Traffic Monitor Golang</a></li>
<li class="toctree-l2"><a class="reference internal" href="../development/traffic_stats.html">Traffic Stats</a></li>
<li class="toctree-l2"><a class="reference internal" href="../development/traffic_server.html">Traffic Server</a></li>
</ul>
@@ -159,7 +161,7 @@
<div class="rst-content">
<div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
- <li><a href="../index.html">Traffic Control master</a> »</li>
+ <li><a href="../index.html">Traffic Control 1.8-dev</a> »</li>
<li><a href="index.html">Administrator’s Guide</a> »</li>
@@ -188,21 +190,64 @@
<h1>Traffic Server Administration<a class="headerlink" href="#traffic-server-administration" title="Permalink to this headline">�</a></h1>
<div class="section" id="installing-traffic-server">
<h2>Installing Traffic Server<a class="headerlink" href="#installing-traffic-server" title="Permalink to this headline">�</a></h2>
+<ol class="arabic">
+<li><p class="first">Get the Traffic Server RPM and the astats RPM.</p>
+<p>Sample command:</p>
+<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">wget</span> <span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">traffic</span><span class="o">-</span><span class="n">control</span><span class="o">-</span><span class="n">cdn</span><span class="o">.</span><span class="n">net</span><span class="o">/</span><span class="n">downloads</span><span class="o">/</span><span class="mf">1.7</span><span class="o">.</span><span class="mi">0</span><span class="o">/</span><span class="n">RELEASE</span><span class="o">-</span><span class="mf">1.7</span><span class="o">.</span><span class="mi">0</span><span class="o">/</span><span class="n">trafficserver</span><span class="o">-</span><span class="mf">5.3</span><span class="o">.</span><span class="mi">2</span><span class="o">-</span><span class="mf">759.</span><span class="n">ee14bbe</span><span class="o">.</span><span class="n">el6</span><span class="o">.</span><span class
="n">x86_64</span><span class="o">.</span><span class="n">rpm</span>
+<span class="n">wget</span> <span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">traffic</span><span class="o">-</span><span class="n">control</span><span class="o">-</span><span class="n">cdn</span><span class="o">.</span><span class="n">net</span><span class="o">/</span><span class="n">downloads</span><span class="o">/</span><span class="mf">1.6</span><span class="o">.</span><span class="mi">1</span><span class="o">/</span><span class="n">RELEASE</span><span class="o">-</span><span class="mf">1.6</span><span class="o">.</span><span class="mi">1</span><span class="o">/</span><span class="n">astats_over_http</span><span class="o">-</span><span class="mf">1.2</span><span class="o">-</span><span class="mf">8.</span><span class="n">el6</span><span class="o">.</span><span class="n">x86_64</span><span class="o">.</span><span class="n">rpm</span>
+</pre></div>
+</div>
+<p>(astats was not released as part of 1.7, so in this examples 1.6.1 was used)</p>
+</li>
+<li><p class="first">Install Traffic Server and astats:</p>
+<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">sudo</span> <span class="n">yum</span> <span class="o">-</span><span class="n">y</span> <span class="n">install</span> <span class="n">trafficserver</span><span class="o">-*.</span><span class="n">rpm</span> <span class="n">astats_over_http</span><span class="o">*.</span><span class="n">rpm</span>
+</pre></div>
+</div>
+</li>
+<li><p class="first">Add the server using the Traffic Ops web interface:</p>
+<ol class="arabic">
+<li><p class="first">Select <strong>Servers</strong>.</p>
+</li>
+<li><p class="first">Scroll to the bottom of the page and click <strong>Add Server</strong>.</p>
+</li>
+<li><dl class="first docutils">
+<dt>Complete the “Required Info:” section:</dt>
+<dd><ul class="first last simple">
+<li>Set ‘Interface Name’ to the name of the interface from which traffic server delivers content.</li>
+<li>Set ‘Type’ to ‘MID’ or ‘EDGE’.</li>
+</ul>
+</dd>
+</dl>
+</li>
+<li><p class="first">Click <strong>Submit</strong>.</p>
+</li>
+<li><p class="first">Click <strong>Save</strong>.</p>
+</li>
+<li><p class="first">Click <strong>Online Server</strong>.</p>
+</li>
+<li><p class="first">Verify that the server status is now listed as <strong>Reported</strong></p>
+</li>
+</ol>
+</li>
+<li><p class="first">Install the ORT script and run it in ‘badass’ mode to create the initial configuration, see <a class="reference internal" href="#reference-traffic-ops-ort"><span class="std std-ref">Configuring Traffic Server</span></a></p>
+</li>
+<li><p class="first">Start the service: <code class="docutils literal"><span class="pre">sudo</span> <span class="pre">service</span> <span class="pre">trafficserver</span> <span class="pre">start</span></code></p>
+</li>
+<li><p class="first">Configure traffic server to start automatically: <code class="docutils literal"><span class="pre">sudo</span> <span class="pre">chkconfig</span> <span class="pre">trafficserver</span> <span class="pre">on</span></code></p>
+</li>
+<li><p class="first">Verify that the installation is good:</p>
<ol class="arabic simple">
-<li>Select <strong>Servers</strong> in the Traffic Ops web interface.</li>
-<li>Scroll to the bottom of the page and click <strong>Add Server</strong>.</li>
-<li>Complete the <em>Required Info</em>: section.</li>
-<li>Click <strong>Submit</strong>.</li>
-<li>Click <strong>Save</strong>.</li>
+<li>Make sure that the service is running: <code class="docutils literal"><span class="pre">sudo</span> <span class="pre">service</span> <span class="pre">trafficserver</span> <span class="pre">status</span></code></li>
+<li>Assuming a traffic monitor is already installed, browse to it, and verify that the traffic server appears in the “Cahce States” table, in white.</li>
+</ol>
+</li>
</ol>
</div>
<div class="section" id="configuring-traffic-server">
<span id="reference-traffic-ops-ort"></span><h2>Configuring Traffic Server<a class="headerlink" href="#configuring-traffic-server" title="Permalink to this headline">�</a></h2>
-<p>All of the Traffic Server application configuration files are generated by Traffic Ops and installed by way of the traffic_ops_ort.pl script.</p>
-<dl class="docutils">
-<dt><strong>traffic_ops_ort.pl</strong></dt>
-<dd><p class="first">The traffic_ops_ort.pl should be installed on all caches (by puppet or other non Traffic Ops means), usually in /opt/ort. It is used to do initial install of the config files when the cache is being deployed, and to keep the config files up to date when the cache is already in service. The usage message of the script is shown below:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span>$ sudo ./traffic_ops_ort.pl syncds warn https://to.cdn.kabletown.net
+<p>All of the Traffic Server application configuration files are generated by Traffic Ops and installed by way of the traffic_ops_ort.pl script.
+The traffic_ops_ort.pl should be installed on all caches (by puppet or other non Traffic Ops means), usually in /opt/ort. It is used to do the initial install of the config files when the cache is being deployed, and to keep the config files up to date when the cache is already in service. The usage message of the script is shown below:</p>
+<div class="highlight-default"><div class="highlight"><pre><span></span>$ sudo /opt/ort/traffic_ops_ort.pl
Thu May 26 15:52:11 UTC 2016
====-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-====
Usage: ./traffic_ops_ort.pl <Mode> <Log_Level> <Traffic_Ops_URL> <Traffic_Ops_Login> [optional flags]
@@ -225,20 +270,56 @@ Usage: ./traffic_ops_ort.pl <Mode> <Log_Level> <Traffic_Ops_URL&g
$
</pre></div>
</div>
-<p>For initial configuration or when major changes (like a Profile change) need to be made, run the script in “badass mode”. All required rpm packages will be installed, all Traffic Server config files will be fetched and installed, and (if needed) the Traffic Server application will be restarted. Example run below:</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">run</span> <span class="n">here</span>
+<div class="section" id="installing-the-ort-script">
+<h3>Installing the ORT script<a class="headerlink" href="#installing-the-ort-script" title="Permalink to this headline">�</a></h3>
+<ol class="arabic">
+<li><p class="first">The ORT script is not a part of the traffic server distribution. In this sample session, we get it manually from github:</p>
+<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">sudo</span> <span class="n">mkdir</span> <span class="o">/</span><span class="n">opt</span><span class="o">/</span><span class="n">ort</span>
+<span class="n">sudo</span> <span class="n">wget</span> <span class="o">-</span><span class="n">P</span> <span class="o">/</span><span class="n">opt</span><span class="o">/</span><span class="n">ort</span> <span class="n">https</span><span class="p">:</span><span class="o">//</span><span class="n">raw</span><span class="o">.</span><span class="n">githubusercontent</span><span class="o">.</span><span class="n">com</span><span class="o">/</span><span class="n">apache</span><span class="o">/</span><span class="n">incubator</span><span class="o">-</span><span class="n">trafficcontrol</span><span class="o">/</span><span class="mf">1.7</span><span class="o">.</span><span class="n">x</span><span class="o">/</span><span class="n">traffic_ops</span><span class="o">/</span><span class="nb">bin</span><span class="o">/</span><span class="n">traffic_ops_ort</span><span class="o">.</span><span class="n">pl</span>
+<span class="n">sudo</span> <span class="n">chmod</span> <span class="o">+</span><span class="n">x</span> <span class="o">/</span><span class="n">opt</span><span class="o">/</span><span class="n">ort</span><span class="o">/</span><span class="n">traffic_ops_ort</span><span class="o">.</span><span class="n">pl</span>
+</pre></div>
+</div>
+</li>
+<li><p class="first">Install modules required by ORT: <code class="docutils literal"><span class="pre">sudo</span> <span class="pre">yum</span> <span class="pre">-y</span> <span class="pre">install</span> <span class="pre">perl-JSON</span> <span class="pre">perl-Crypt-SSLeay</span></code></p>
+</li>
+<li><p class="first">For initial configuration or when major changes (like a Profile change) need to be made, run the script in “badass mode”. All required rpm packages
+will be installed, all Traffic Server config files will be fetched and installed, and (if needed) the Traffic Server application will be restarted.</p>
+<p>Example run below:</p>
+<div class="highlight-default"><div class="highlight"><pre><span></span>$ sudo /opt/ort/traffic_ops_ort.pl --dispersion=0 badass warn https://ops.$tcDomain admin:admin123
</pre></div>
</div>
-<p>For “every day changes” such as adding deliveryservices or changing records.config parameters caches should run the script in “syncds” mode out of cron. Example crontab entry:</p>
+<div class="admonition note">
+<p class="first admonition-title">Note</p>
+<p class="last">First run gives a lot of state errors that are expected. The “badass” mode fixes these issue s. Run it a second time, this should be cleaner.
+Also, note that many ERROR messages emitted by ORT are actually information messages. Do not panic.</p>
+</div>
+</li>
+<li><p class="first">Create a cron entry for running ort in ‘syncds’ mode every 15 minutes.
+This makes traffic control check periodically if ‘Queue Updates’ was run on Traffic Ops, and it so, get the updated configuration.</p>
+<p>Run <code class="docutils literal"><span class="pre">sudo</span> <span class="pre">crontab</span> <span class="pre">-e</span></code> and add the following line</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="o">*/</span><span class="mi">15</span> <span class="o">*</span> <span class="o">*</span> <span class="o">*</span> <span class="o">*</span> <span class="o">/</span><span class="n">opt</span><span class="o">/</span><span class="n">ort</span><span class="o">/</span><span class="n">traffic_ops_ort</span><span class="o">.</span><span class="n">pl</span> <span class="n">syncds</span> <span class="n">warn</span> <span class="n">https</span><span class="p">:</span><span class="o">//</span><span class="n">traffops</span><span class="o">.</span><span class="n">kabletown</span><span class="o">.</span><span class="n">net</span> <span class="n">admin</span><span class="p">:</span><span class="n">password</span> <span class="o">></span> <span class="o">/</span><span class="n">tmp</span><span class="o">/</span><span class="n">ort</span><span class="o">/</span><span class="n">syncds</span><span class="o">.</span
><span class="n">log</span> <span class="mi">2</span><span class="o">>&</span><span class="mi">1</span>
</pre></div>
</div>
-<div class="last admonition note">
+<div class="admonition note">
<p class="first admonition-title">Note</p>
-<p class="last"><disclaimer on what is “hot changeable” here></p>
+<p class="last">By default, running ort on an edge traffic server waits for it’s parent (mid) servers to download their configuration before
+it downloads it’s own configuration. Because of this, scheduling ort for running every 15 minutes (with 5 minutes default dispersion) means
+that it might take up to ~35 minutes for a “Queue Updates” operation to affect all traffic servers.</p>
+</div>
+<div class="admonition note">
+<p class="first admonition-title">Note</p>
+<p>In ‘syncds’ mode, the ort script updates only configurations that might be changed as part of normal operations, such as:</p>
+<ul class="last simple">
+<li>Delivery Services</li>
+<li>SSL certificates</li>
+<li>Traffic Monitor IP addresses</li>
+<li>Logging configuration</li>
+<li>More stuff <To be completed></li>
+</ul>
+</div>
+</li>
+</ol>
</div>
-</dd>
-</dl>
</div>
</div>
@@ -280,7 +361,7 @@ $
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
- VERSION:'master',
+ VERSION:'1.8-dev',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true
http://git-wip-us.apache.org/repos/asf/incubator-trafficcontrol-website/blob/868aab4e/docs/latest/admin/traffic_stats.html
----------------------------------------------------------------------
diff --git a/docs/latest/admin/traffic_stats.html b/docs/latest/admin/traffic_stats.html
index f632f5b..13c6713 100644
--- a/docs/latest/admin/traffic_stats.html
+++ b/docs/latest/admin/traffic_stats.html
@@ -7,7 +7,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
- <title>Traffic Stats Administration — Traffic Control master documentation </title>
+ <title>Traffic Stats Administration — Traffic Control 1.8-dev documentation </title>
@@ -33,7 +33,7 @@
- <link rel="top" title="Traffic Control master documentation" href="../index.html"/>
+ <link rel="top" title="Traffic Control 1.8-dev documentation" href="../index.html"/>
<link rel="up" title="Administrator\u2019s Guide" href="index.html"/>
<link rel="next" title="Traffic Server Administration" href="traffic_server.html"/>
<link rel="prev" title="Traffic Router Administration" href="traffic_router.html"/>
@@ -159,7 +159,7 @@
<div class="rst-content">
<div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
- <li><a href="../index.html">Traffic Control master</a> »</li>
+ <li><a href="../index.html">Traffic Control 1.8-dev</a> »</li>
<li><a href="index.html">Administrator’s Guide</a> »</li>
@@ -462,7 +462,7 @@ They are specific for traffic stats and are not meant to be generic to influxdb.
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
- VERSION:'master',
+ VERSION:'1.8-dev',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true
http://git-wip-us.apache.org/repos/asf/incubator-trafficcontrol-website/blob/868aab4e/docs/latest/admin/traffic_vault.html
----------------------------------------------------------------------
diff --git a/docs/latest/admin/traffic_vault.html b/docs/latest/admin/traffic_vault.html
index f8f09d5..51d02f0 100644
--- a/docs/latest/admin/traffic_vault.html
+++ b/docs/latest/admin/traffic_vault.html
@@ -7,7 +7,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
- <title>Traffic Vault Administration — Traffic Control master documentation </title>
+ <title>Traffic Vault Administration — Traffic Control 1.8-dev documentation </title>
@@ -33,7 +33,7 @@
- <link rel="top" title="Traffic Control master documentation" href="../index.html"/>
+ <link rel="top" title="Traffic Control 1.8-dev documentation" href="../index.html"/>
<link rel="up" title="Administrator\u2019s Guide" href="index.html"/>
<link rel="next" title="Quick How To Guides" href="quick_howto/index.html"/>
<link rel="prev" title="Traffic Server Administration" href="traffic_server.html"/>
@@ -159,7 +159,7 @@
<div class="rst-content">
<div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
- <li><a href="../index.html">Traffic Control master</a> »</li>
+ <li><a href="../index.html">Traffic Control 1.8-dev</a> »</li>
<li><a href="index.html">Administrator’s Guide</a> »</li>
@@ -480,7 +480,7 @@ The installation instructions for Riak can be found <a class="reference external
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
- VERSION:'master',
+ VERSION:'1.8-dev',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true
http://git-wip-us.apache.org/repos/asf/incubator-trafficcontrol-website/blob/868aab4e/docs/latest/basics/cache_revalidation.html
----------------------------------------------------------------------
diff --git a/docs/latest/basics/cache_revalidation.html b/docs/latest/basics/cache_revalidation.html
index 64acbca..a6c4e70 100644
--- a/docs/latest/basics/cache_revalidation.html
+++ b/docs/latest/basics/cache_revalidation.html
@@ -7,7 +7,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
- <title>Cache Control Headers and Revalidation — Traffic Control master documentation </title>
+ <title>Cache Control Headers and Revalidation — Traffic Control 1.8-dev documentation </title>
@@ -33,7 +33,7 @@
- <link rel="top" title="Traffic Control master documentation" href="../index.html"/>
+ <link rel="top" title="Traffic Control 1.8-dev documentation" href="../index.html"/>
<link rel="up" title="CDN Basics" href="index.html"/>
<link rel="next" title="Traffic Control Overview" href="../overview/index.html"/>
<link rel="prev" title="Caching Proxies" href="caching_proxies.html"/>
@@ -159,7 +159,7 @@
<div class="rst-content">
<div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
- <li><a href="../index.html">Traffic Control master</a> »</li>
+ <li><a href="../index.html">Traffic Control 1.8-dev</a> »</li>
<li><a href="index.html">CDN Basics</a> »</li>
@@ -273,7 +273,7 @@
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
- VERSION:'master',
+ VERSION:'1.8-dev',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true
http://git-wip-us.apache.org/repos/asf/incubator-trafficcontrol-website/blob/868aab4e/docs/latest/basics/caching_proxies.html
----------------------------------------------------------------------
diff --git a/docs/latest/basics/caching_proxies.html b/docs/latest/basics/caching_proxies.html
index 8390aa0..d665e2e 100644
--- a/docs/latest/basics/caching_proxies.html
+++ b/docs/latest/basics/caching_proxies.html
@@ -7,7 +7,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
- <title>Caching Proxies — Traffic Control master documentation </title>
+ <title>Caching Proxies — Traffic Control 1.8-dev documentation </title>
@@ -33,7 +33,7 @@
- <link rel="top" title="Traffic Control master documentation" href="../index.html"/>
+ <link rel="top" title="Traffic Control 1.8-dev documentation" href="../index.html"/>
<link rel="up" title="CDN Basics" href="index.html"/>
<link rel="next" title="Cache Control Headers and Revalidation" href="cache_revalidation.html"/>
<link rel="prev" title="HTTP 1.1" href="http_11.html"/>
@@ -159,7 +159,7 @@
<div class="rst-content">
<div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
- <li><a href="../index.html">Traffic Control master</a> »</li>
+ <li><a href="../index.html">Traffic Control 1.8-dev</a> »</li>
<li><a href="index.html">CDN Basics</a> »</li>
@@ -447,7 +447,7 @@ client obtains, and is unaware of the proxy in the middle.</div></blockquote>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
- VERSION:'master',
+ VERSION:'1.8-dev',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true