[29/44] incubator-trafficcontrol-website git commit: updates rst docs

Fri, 21 Jul 2017 09:57:59 -0700 

http://git-wip-us.apache.org/repos/asf/incubator-trafficcontrol-website/blob/42d25dc5/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 06d112e..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 &mdash; Traffic Control master documentation 
</title>
+  <title>Installing Traffic Ops &mdash; 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’s Guide" href="index.html"/>
         <link rel="next" title="Configuring Traffic Ops" 
href="traffic_ops_config.html"/>
         <link rel="prev" title="Administrator’s Guide" href="index.html"/> 
@@ -102,12 +102,13 @@
 </ul>
 <ul class="current">
 <li class="toctree-l1 current"><a class="reference internal" 
href="index.html">Administrator&#8217;s Guide</a><ul class="current">
-<li class="toctree-l2 current"><a class="current reference internal" 
href="">Installing Traffic Ops</a></li>
+<li class="toctree-l2 current"><a class="current reference internal" 
href="#">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"><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> &raquo;</li>
+    <li><a href="../index.html">Traffic Control 1.8-dev</a> &raquo;</li>
       
           <li><a href="index.html">Administrator&#8217;s Guide</a> &raquo;</li>
       
@@ -254,13 +256,13 @@
 </ol>
 <blockquote>
 <div><p>Example output:</p>
-<div class="highlight-python"><div class="highlight"><pre>trafficops-vm # 
/opt/traffic_ops/install/bin/postinstall
+<div class="highlight-default"><div class="highlight"><pre><span></span><span 
class="n">trafficops</span><span class="o">-</span><span class="n">vm</span> 
<span class="c1"># /opt/traffic_ops/install/bin/postinstall</span>
 
-This script will build and package the required Traffic Ops perl modules.
-In order to complete this operation, Development tools such as the gcc
-compiler must be installed on this machine.
+<span class="n">This</span> <span class="n">script</span> <span 
class="n">will</span> <span class="n">build</span> <span class="ow">and</span> 
<span class="n">package</span> <span class="n">the</span> <span 
class="n">required</span> <span class="n">Traffic</span> <span 
class="n">Ops</span> <span class="n">perl</span> <span 
class="n">modules</span><span class="o">.</span>
+<span class="n">In</span> <span class="n">order</span> <span 
class="n">to</span> <span class="n">complete</span> <span class="n">this</span> 
<span class="n">operation</span><span class="p">,</span> <span 
class="n">Development</span> <span class="n">tools</span> <span 
class="n">such</span> <span class="k">as</span> <span class="n">the</span> 
<span class="n">gcc</span>
+<span class="n">compiler</span> <span class="n">must</span> <span 
class="n">be</span> <span class="n">installed</span> <span class="n">on</span> 
<span class="n">this</span> <span class="n">machine</span><span 
class="o">.</span>
 
-Hit ENTER to continue:
+<span class="n">Hit</span> <span class="n">ENTER</span> <span 
class="n">to</span> <span class="k">continue</span><span class="p">:</span>
 </pre></div>
 </div>
 <p>The first thing postinstall will do is install additional packages needed 
from the yum repo.</p>
@@ -271,7 +273,7 @@ Hit ENTER to continue:
 </div>
 <p>If there are any prompts in this phase, please just answer with the 
defaults (some CPAN installs can prompt for install questions).</p>
 <p>When this phase is complete, you will see:</p>
-<div class="highlight-python"><div class="highlight"><pre>...
+<div class="highlight-default"><div class="highlight"><pre><span></span>...
 Successfully installed Test-Differences-0.63
 Successfully installed DBIx-Class-Schema-Loader-0.07042
 Successfully installed Time-HiRes-1.9726 (upgraded from 1.9719)
@@ -300,7 +302,7 @@ Database type [mysql]:
 <p class="last">CentOS files note.</p>
 </div>
 <p>Example output:</p>
-<div class="highlight-python"><div class="highlight"><pre>Database type 
[mysql]:
+<div class="highlight-default"><div 
class="highlight"><pre><span></span>Database type [mysql]:
 Database name [traffic_ops_db]:
 Database server hostname IP or FQDN [localhost]:
 Database port number [3306]:
@@ -426,7 +428,7 @@ seeding parameter data...
 <td>The DNS domain that will be delegated to this Traffic Control CDN</td>
 </tr>
 <tr class="row-odd"><td>name of your CentOS 6.5 ISO kickstart tar file</td>
-<td>See <a class="reference internal" 
href="traffic_ops_config.html#creating-centos-kickstart"><em>Creating the 
CentOS Kickstart File</em></a></td>
+<td>See <a class="reference internal" 
href="traffic_ops_config.html#creating-centos-kickstart"><span class="std 
std-ref">Creating the CentOS Kickstart File</span></a></td>
 </tr>
 <tr class="row-even"><td>Administration username for Traffic Ops</td>
 <td>The Administration (highest privilege) Traffic Ops user to create;
@@ -441,120 +443,120 @@ use this user to login for the first time and create 
other users</td>
 <p>The postinstall script will now seed the database with some inital 
configuration settings for the CDN and the servers in the CDN.</p>
 <p>The next phase is the download of the geo location database and 
configuration of information needed for SSL certificates.</p>
 <p>Example output:</p>
-<div class="highlight-python"><div class="highlight"><pre>Downloading MaxMind 
data.
---2015-04-14 02:14:32--  
http://geolite.maxmind.com/download/geoip/database/GeoLite2-City.mmdb.gz
-Resolving geolite.maxmind.com... 141.101.115.190, 141.101.114.190, 
2400:cb00:2048:1::8d65:73be, ...
-Connecting to geolite.maxmind.com|141.101.115.190|:80... connected.
-HTTP request sent, awaiting response... 200 OK
-Length: 17633433 (17M) [application/octet-stream]
-Saving to: &quot;GeoLite2-City.mmdb.gz&quot;
+<div class="highlight-default"><div class="highlight"><pre><span></span><span 
class="n">Downloading</span> <span class="n">MaxMind</span> <span 
class="n">data</span><span class="o">.</span>
+<span class="o">--</span><span class="mi">2015</span><span 
class="o">-</span><span class="mi">04</span><span class="o">-</span><span 
class="mi">14</span> <span class="mi">02</span><span class="p">:</span><span 
class="mi">14</span><span class="p">:</span><span class="mi">32</span><span 
class="o">--</span>  <span class="n">http</span><span class="p">:</span><span 
class="o">//</span><span class="n">geolite</span><span class="o">.</span><span 
class="n">maxmind</span><span class="o">.</span><span class="n">com</span><span 
class="o">/</span><span class="n">download</span><span class="o">/</span><span 
class="n">geoip</span><span class="o">/</span><span 
class="n">database</span><span class="o">/</span><span 
class="n">GeoLite2</span><span class="o">-</span><span 
class="n">City</span><span class="o">.</span><span class="n">mmdb</span><span 
class="o">.</span><span class="n">gz</span>
+<span class="n">Resolving</span> <span class="n">geolite</span><span 
class="o">.</span><span class="n">maxmind</span><span class="o">.</span><span 
class="n">com</span><span class="o">...</span> <span 
class="mf">141.101</span><span class="o">.</span><span 
class="mf">115.190</span><span class="p">,</span> <span 
class="mf">141.101</span><span class="o">.</span><span 
class="mf">114.190</span><span class="p">,</span> <span 
class="mi">2400</span><span class="p">:</span><span class="n">cb00</span><span 
class="p">:</span><span class="mi">2048</span><span class="p">:</span><span 
class="mi">1</span><span class="p">::</span><span class="mi">8</span><span 
class="n">d65</span><span class="p">:</span><span class="mi">73</span><span 
class="n">be</span><span class="p">,</span> <span class="o">...</span>
+<span class="n">Connecting</span> <span class="n">to</span> <span 
class="n">geolite</span><span class="o">.</span><span 
class="n">maxmind</span><span class="o">.</span><span class="n">com</span><span 
class="o">|</span><span class="mf">141.101</span><span class="o">.</span><span 
class="mf">115.190</span><span class="o">|</span><span class="p">:</span><span 
class="mf">80.</span><span class="o">..</span> <span 
class="n">connected</span><span class="o">.</span>
+<span class="n">HTTP</span> <span class="n">request</span> <span 
class="n">sent</span><span class="p">,</span> <span class="n">awaiting</span> 
<span class="n">response</span><span class="o">...</span> <span 
class="mi">200</span> <span class="n">OK</span>
+<span class="n">Length</span><span class="p">:</span> <span 
class="mi">17633433</span> <span class="p">(</span><span 
class="mi">17</span><span class="n">M</span><span class="p">)</span> <span 
class="p">[</span><span class="n">application</span><span 
class="o">/</span><span class="n">octet</span><span class="o">-</span><span 
class="n">stream</span><span class="p">]</span>
+<span class="n">Saving</span> <span class="n">to</span><span 
class="p">:</span> <span class="s2">&quot;GeoLite2-City.mmdb.gz&quot;</span>
 
-100%[==================================================================================================================================================================&gt;]
 17,633,433  7.03M/s   in 2.4s
+<span class="mi">100</span><span class="o">%</span><span 
class="p">[</span><span 
class="o">==================================================================================================================================================================&gt;</span><span
 class="p">]</span> <span class="mi">17</span><span class="p">,</span><span 
class="mi">633</span><span class="p">,</span><span class="mi">433</span>  <span 
class="mf">7.03</span><span class="n">M</span><span class="o">/</span><span 
class="n">s</span>   <span class="ow">in</span> <span 
class="mf">2.4</span><span class="n">s</span>
 
-2015-04-14 02:14:35 (7.03 MB/s) - &quot;GeoLite2-City.mmdb.gz&quot; saved 
[17633433/17633433]
+<span class="mi">2015</span><span class="o">-</span><span 
class="mi">04</span><span class="o">-</span><span class="mi">14</span> <span 
class="mi">02</span><span class="p">:</span><span class="mi">14</span><span 
class="p">:</span><span class="mi">35</span> <span class="p">(</span><span 
class="mf">7.03</span> <span class="n">MB</span><span class="o">/</span><span 
class="n">s</span><span class="p">)</span> <span class="o">-</span> <span 
class="s2">&quot;GeoLite2-City.mmdb.gz&quot;</span> <span 
class="n">saved</span> <span class="p">[</span><span 
class="mi">17633433</span><span class="o">/</span><span 
class="mi">17633433</span><span class="p">]</span>
 
-Copying coverage zone file to public dir.
+<span class="n">Copying</span> <span class="n">coverage</span> <span 
class="n">zone</span> <span class="n">file</span> <span class="n">to</span> 
<span class="n">public</span> <span class="nb">dir</span><span 
class="o">.</span>
 
-Installing SSL Certificates.
+<span class="n">Installing</span> <span class="n">SSL</span> <span 
class="n">Certificates</span><span class="o">.</span>
 
-  We&#39;re now running a script to generate a self signed X509 SSL 
certificate.
-  When prompted to enter a pass phrase, just enter &#39;pass&#39; each time.  
The
-  pass phrase will be stripped from the private key before installation.
+  <span class="n">We</span><span class="s1">&#39;re now running a script to 
generate a self signed X509 SSL certificate.</span>
+  <span class="n">When</span> <span class="n">prompted</span> <span 
class="n">to</span> <span class="n">enter</span> <span class="n">a</span> <span 
class="k">pass</span> <span class="n">phrase</span><span class="p">,</span> 
<span class="n">just</span> <span class="n">enter</span> <span 
class="s1">&#39;pass&#39;</span> <span class="n">each</span> <span 
class="n">time</span><span class="o">.</span>  <span class="n">The</span>
+  <span class="k">pass</span> <span class="n">phrase</span> <span 
class="n">will</span> <span class="n">be</span> <span class="n">stripped</span> 
<span class="kn">from</span> <span class="nn">the</span> <span 
class="n">private</span> <span class="n">key</span> <span 
class="n">before</span> <span class="n">installation</span><span 
class="o">.</span>
 
-  When prompted to enter a &#39;challenge password&#39;, just hit the ENTER 
key.
+  <span class="n">When</span> <span class="n">prompted</span> <span 
class="n">to</span> <span class="n">enter</span> <span class="n">a</span> <span 
class="s1">&#39;challenge password&#39;</span><span class="p">,</span> <span 
class="n">just</span> <span class="n">hit</span> <span class="n">the</span> 
<span class="n">ENTER</span> <span class="n">key</span><span class="o">.</span>
 
-  The remaining enformation Country, State, Locality, etc... are required to
-  generate a properly formatted SSL certificate.
+  <span class="n">The</span> <span class="n">remaining</span> <span 
class="n">enformation</span> <span class="n">Country</span><span 
class="p">,</span> <span class="n">State</span><span class="p">,</span> <span 
class="n">Locality</span><span class="p">,</span> <span 
class="n">etc</span><span class="o">...</span> <span class="n">are</span> <span 
class="n">required</span> <span class="n">to</span>
+  <span class="n">generate</span> <span class="n">a</span> <span 
class="n">properly</span> <span class="n">formatted</span> <span 
class="n">SSL</span> <span class="n">certificate</span><span class="o">.</span>
 
-Hit Enter when you are ready to continue:
-Postinstall SSL Certificate Creation.
+<span class="n">Hit</span> <span class="n">Enter</span> <span 
class="n">when</span> <span class="n">you</span> <span class="n">are</span> 
<span class="n">ready</span> <span class="n">to</span> <span 
class="k">continue</span><span class="p">:</span>
+<span class="n">Postinstall</span> <span class="n">SSL</span> <span 
class="n">Certificate</span> <span class="n">Creation</span><span 
class="o">.</span>
 
-Generating an RSA Private Server Key.
+<span class="n">Generating</span> <span class="n">an</span> <span 
class="n">RSA</span> <span class="n">Private</span> <span 
class="n">Server</span> <span class="n">Key</span><span class="o">.</span>
 
-Generating RSA private key, 1024 bit long modulus
-..........................++++++
-.....................++++++
-e is 65537 (0x10001)
-Enter pass phrase for server.key:
-Verifying - Enter pass phrase for server.key:
+<span class="n">Generating</span> <span class="n">RSA</span> <span 
class="n">private</span> <span class="n">key</span><span class="p">,</span> 
<span class="mi">1024</span> <span class="n">bit</span> <span 
class="n">long</span> <span class="n">modulus</span>
+<span class="o">..........................++++++</span>
+<span class="o">.....................++++++</span>
+<span class="n">e</span> <span class="ow">is</span> <span 
class="mi">65537</span> <span class="p">(</span><span 
class="mh">0x10001</span><span class="p">)</span>
+<span class="n">Enter</span> <span class="k">pass</span> <span 
class="n">phrase</span> <span class="k">for</span> <span 
class="n">server</span><span class="o">.</span><span class="n">key</span><span 
class="p">:</span>
+<span class="n">Verifying</span> <span class="o">-</span> <span 
class="n">Enter</span> <span class="k">pass</span> <span 
class="n">phrase</span> <span class="k">for</span> <span 
class="n">server</span><span class="o">.</span><span class="n">key</span><span 
class="p">:</span>
 
-The server key has been generated.
+<span class="n">The</span> <span class="n">server</span> <span 
class="n">key</span> <span class="n">has</span> <span class="n">been</span> 
<span class="n">generated</span><span class="o">.</span>
 
-Creating a Certificate Signing Request (CSR)
+<span class="n">Creating</span> <span class="n">a</span> <span 
class="n">Certificate</span> <span class="n">Signing</span> <span 
class="n">Request</span> <span class="p">(</span><span 
class="n">CSR</span><span class="p">)</span>
 
-Enter pass phrase for server.key:
-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 &#39;.&#39;, the field will be left blank.
------
-Country Name (2 letter code) [XX]:US
-State or Province Name (full name) []:CO
-Locality Name (eg, city) [Default City]:Denver
-Organization Name (eg, company) [Default Company Ltd]:
-Organizational Unit Name (eg, section) []:
-Common Name (eg, your name or your server&#39;s hostname) []:
-Email Address []:
+<span class="n">Enter</span> <span class="k">pass</span> <span 
class="n">phrase</span> <span class="k">for</span> <span 
class="n">server</span><span class="o">.</span><span class="n">key</span><span 
class="p">:</span>
+<span class="n">You</span> <span class="n">are</span> <span 
class="n">about</span> <span class="n">to</span> <span class="n">be</span> 
<span class="n">asked</span> <span class="n">to</span> <span 
class="n">enter</span> <span class="n">information</span> <span 
class="n">that</span> <span class="n">will</span> <span class="n">be</span> 
<span class="n">incorporated</span>
+<span class="n">into</span> <span class="n">your</span> <span 
class="n">certificate</span> <span class="n">request</span><span 
class="o">.</span>
+<span class="n">What</span> <span class="n">you</span> <span 
class="n">are</span> <span class="n">about</span> <span class="n">to</span> 
<span class="n">enter</span> <span class="ow">is</span> <span 
class="n">what</span> <span class="ow">is</span> <span class="n">called</span> 
<span class="n">a</span> <span class="n">Distinguished</span> <span 
class="n">Name</span> <span class="ow">or</span> <span class="n">a</span> <span 
class="n">DN</span><span class="o">.</span>
+<span class="n">There</span> <span class="n">are</span> <span 
class="n">quite</span> <span class="n">a</span> <span class="n">few</span> 
<span class="n">fields</span> <span class="n">but</span> <span 
class="n">you</span> <span class="n">can</span> <span class="n">leave</span> 
<span class="n">some</span> <span class="n">blank</span>
+<span class="n">For</span> <span class="n">some</span> <span 
class="n">fields</span> <span class="n">there</span> <span 
class="n">will</span> <span class="n">be</span> <span class="n">a</span> <span 
class="n">default</span> <span class="n">value</span><span class="p">,</span>
+<span class="n">If</span> <span class="n">you</span> <span 
class="n">enter</span> <span class="s1">&#39;.&#39;</span><span 
class="p">,</span> <span class="n">the</span> <span class="n">field</span> 
<span class="n">will</span> <span class="n">be</span> <span 
class="n">left</span> <span class="n">blank</span><span class="o">.</span>
+<span class="o">-----</span>
+<span class="n">Country</span> <span class="n">Name</span> <span 
class="p">(</span><span class="mi">2</span> <span class="n">letter</span> <span 
class="n">code</span><span class="p">)</span> <span class="p">[</span><span 
class="n">XX</span><span class="p">]:</span><span class="n">US</span>
+<span class="n">State</span> <span class="ow">or</span> <span 
class="n">Province</span> <span class="n">Name</span> <span 
class="p">(</span><span class="n">full</span> <span class="n">name</span><span 
class="p">)</span> <span class="p">[]:</span><span class="n">CO</span>
+<span class="n">Locality</span> <span class="n">Name</span> <span 
class="p">(</span><span class="n">eg</span><span class="p">,</span> <span 
class="n">city</span><span class="p">)</span> <span class="p">[</span><span 
class="n">Default</span> <span class="n">City</span><span 
class="p">]:</span><span class="n">Denver</span>
+<span class="n">Organization</span> <span class="n">Name</span> <span 
class="p">(</span><span class="n">eg</span><span class="p">,</span> <span 
class="n">company</span><span class="p">)</span> <span class="p">[</span><span 
class="n">Default</span> <span class="n">Company</span> <span 
class="n">Ltd</span><span class="p">]:</span>
+<span class="n">Organizational</span> <span class="n">Unit</span> <span 
class="n">Name</span> <span class="p">(</span><span class="n">eg</span><span 
class="p">,</span> <span class="n">section</span><span class="p">)</span> <span 
class="p">[]:</span>
+<span class="n">Common</span> <span class="n">Name</span> <span 
class="p">(</span><span class="n">eg</span><span class="p">,</span> <span 
class="n">your</span> <span class="n">name</span> <span class="ow">or</span> 
<span class="n">your</span> <span class="n">server</span><span 
class="s1">&#39;s hostname) []:</span>
+<span class="n">Email</span> <span class="n">Address</span> <span 
class="p">[]:</span>
 
-Please enter the following &#39;extra&#39; attributes
-to be sent with your certificate request
-A challenge password []:pass
-An optional company name []:
+<span class="n">Please</span> <span class="n">enter</span> <span 
class="n">the</span> <span class="n">following</span> <span 
class="s1">&#39;extra&#39;</span> <span class="n">attributes</span>
+<span class="n">to</span> <span class="n">be</span> <span 
class="n">sent</span> <span class="k">with</span> <span class="n">your</span> 
<span class="n">certificate</span> <span class="n">request</span>
+<span class="n">A</span> <span class="n">challenge</span> <span 
class="n">password</span> <span class="p">[]:</span><span class="k">pass</span>
+<span class="n">An</span> <span class="n">optional</span> <span 
class="n">company</span> <span class="n">name</span> <span class="p">[]:</span>
 
-The Certificate Signing Request has been generated.
-Removing the pass phrase from the server key.
-Enter pass phrase for server.key.orig:
-writing RSA key
+<span class="n">The</span> <span class="n">Certificate</span> <span 
class="n">Signing</span> <span class="n">Request</span> <span 
class="n">has</span> <span class="n">been</span> <span 
class="n">generated</span><span class="o">.</span>
+<span class="n">Removing</span> <span class="n">the</span> <span 
class="k">pass</span> <span class="n">phrase</span> <span 
class="kn">from</span> <span class="nn">the</span> <span 
class="n">server</span> <span class="n">key</span><span class="o">.</span>
+<span class="n">Enter</span> <span class="k">pass</span> <span 
class="n">phrase</span> <span class="k">for</span> <span 
class="n">server</span><span class="o">.</span><span class="n">key</span><span 
class="o">.</span><span class="n">orig</span><span class="p">:</span>
+<span class="n">writing</span> <span class="n">RSA</span> <span 
class="n">key</span>
 
-The pass phrase has been removed from the server key.
+<span class="n">The</span> <span class="k">pass</span> <span 
class="n">phrase</span> <span class="n">has</span> <span class="n">been</span> 
<span class="n">removed</span> <span class="kn">from</span> <span 
class="nn">the</span> <span class="n">server</span> <span 
class="n">key</span><span class="o">.</span>
 
-Generating a Self-signed certificate.
-Signature ok
-subject=/C=US/ST=CO/L=Denver/O=Default Company Ltd
-Getting Private key
+<span class="n">Generating</span> <span class="n">a</span> <span 
class="n">Self</span><span class="o">-</span><span class="n">signed</span> 
<span class="n">certificate</span><span class="o">.</span>
+<span class="n">Signature</span> <span class="n">ok</span>
+<span class="n">subject</span><span class="o">=/</span><span 
class="n">C</span><span class="o">=</span><span class="n">US</span><span 
class="o">/</span><span class="n">ST</span><span class="o">=</span><span 
class="n">CO</span><span class="o">/</span><span class="n">L</span><span 
class="o">=</span><span class="n">Denver</span><span class="o">/</span><span 
class="n">O</span><span class="o">=</span><span class="n">Default</span> <span 
class="n">Company</span> <span class="n">Ltd</span>
+<span class="n">Getting</span> <span class="n">Private</span> <span 
class="n">key</span>
 
-A server key and self signed certificate has been generated.
+<span class="n">A</span> <span class="n">server</span> <span 
class="n">key</span> <span class="ow">and</span> <span class="bp">self</span> 
<span class="n">signed</span> <span class="n">certificate</span> <span 
class="n">has</span> <span class="n">been</span> <span 
class="n">generated</span><span class="o">.</span>
 
-Installing the server key and server certificate.
+<span class="n">Installing</span> <span class="n">the</span> <span 
class="n">server</span> <span class="n">key</span> <span class="ow">and</span> 
<span class="n">server</span> <span class="n">certificate</span><span 
class="o">.</span>
 
-The private key has been installed.
+<span class="n">The</span> <span class="n">private</span> <span 
class="n">key</span> <span class="n">has</span> <span class="n">been</span> 
<span class="n">installed</span><span class="o">.</span>
 
-Installing the self signed certificate.
+<span class="n">Installing</span> <span class="n">the</span> <span 
class="bp">self</span> <span class="n">signed</span> <span 
class="n">certificate</span><span class="o">.</span>
 
-Saving the self signed csr.
+<span class="n">Saving</span> <span class="n">the</span> <span 
class="bp">self</span> <span class="n">signed</span> <span 
class="n">csr</span><span class="o">.</span>
 
-  The self signed certificate has now been installed.
+  <span class="n">The</span> <span class="bp">self</span> <span 
class="n">signed</span> <span class="n">certificate</span> <span 
class="n">has</span> <span class="n">now</span> <span class="n">been</span> 
<span class="n">installed</span><span class="o">.</span>
 
-  You may obtain a certificate signed by a Certificate Authority using the
-  server.csr file saved in the current directory.  Once you have obtained
-  a signed certificate, copy it to /etc/pki/tls/certs/localhost.crt and
-  restart Traffic Ops.
+  <span class="n">You</span> <span class="n">may</span> <span 
class="n">obtain</span> <span class="n">a</span> <span 
class="n">certificate</span> <span class="n">signed</span> <span 
class="n">by</span> <span class="n">a</span> <span class="n">Certificate</span> 
<span class="n">Authority</span> <span class="n">using</span> <span 
class="n">the</span>
+  <span class="n">server</span><span class="o">.</span><span 
class="n">csr</span> <span class="n">file</span> <span class="n">saved</span> 
<span class="ow">in</span> <span class="n">the</span> <span 
class="n">current</span> <span class="n">directory</span><span 
class="o">.</span>  <span class="n">Once</span> <span class="n">you</span> 
<span class="n">have</span> <span class="n">obtained</span>
+  <span class="n">a</span> <span class="n">signed</span> <span 
class="n">certificate</span><span class="p">,</span> <span 
class="n">copy</span> <span class="n">it</span> <span class="n">to</span> <span 
class="o">/</span><span class="n">etc</span><span class="o">/</span><span 
class="n">pki</span><span class="o">/</span><span class="n">tls</span><span 
class="o">/</span><span class="n">certs</span><span class="o">/</span><span 
class="n">localhost</span><span class="o">.</span><span class="n">crt</span> 
<span class="ow">and</span>
+  <span class="n">restart</span> <span class="n">Traffic</span> <span 
class="n">Ops</span><span class="o">.</span>
 
 
 
-SSL Certificates have been installed.
+<span class="n">SSL</span> <span class="n">Certificates</span> <span 
class="n">have</span> <span class="n">been</span> <span 
class="n">installed</span><span class="o">.</span>
 
-Starting Traffic Ops.
+<span class="n">Starting</span> <span class="n">Traffic</span> <span 
class="n">Ops</span><span class="o">.</span>
 
-Starting Traffic Ops
+<span class="n">Starting</span> <span class="n">Traffic</span> <span 
class="n">Ops</span>
 
-Subroutine TrafficOps::has redefined at 
/opt/traffic_ops/app/local/lib/perl5/Mojo/Base.pm line 38.
-Subroutine TrafficOps::has redefined at 
/opt/traffic_ops/app/local/lib/perl5/Mojo/Base.pm line 38.
-Loading config from /opt/traffic_ops/app/conf/cdn.conf
-Reading log4perl config from /opt/traffic_ops/app/conf/production/log4perl.conf
-Starting hot deployment for Hypnotoad server 32192.
+<span class="n">Subroutine</span> <span class="n">TrafficOps</span><span 
class="p">::</span><span class="n">has</span> <span class="n">redefined</span> 
<span class="n">at</span> <span class="o">/</span><span 
class="n">opt</span><span class="o">/</span><span 
class="n">traffic_ops</span><span class="o">/</span><span 
class="n">app</span><span class="o">/</span><span class="n">local</span><span 
class="o">/</span><span class="n">lib</span><span class="o">/</span><span 
class="n">perl5</span><span class="o">/</span><span class="n">Mojo</span><span 
class="o">/</span><span class="n">Base</span><span class="o">.</span><span 
class="n">pm</span> <span class="n">line</span> <span class="mf">38.</span>
+<span class="n">Subroutine</span> <span class="n">TrafficOps</span><span 
class="p">::</span><span class="n">has</span> <span class="n">redefined</span> 
<span class="n">at</span> <span class="o">/</span><span 
class="n">opt</span><span class="o">/</span><span 
class="n">traffic_ops</span><span class="o">/</span><span 
class="n">app</span><span class="o">/</span><span class="n">local</span><span 
class="o">/</span><span class="n">lib</span><span class="o">/</span><span 
class="n">perl5</span><span class="o">/</span><span class="n">Mojo</span><span 
class="o">/</span><span class="n">Base</span><span class="o">.</span><span 
class="n">pm</span> <span class="n">line</span> <span class="mf">38.</span>
+<span class="n">Loading</span> <span class="n">config</span> <span 
class="kn">from</span> <span class="o">/</span><span class="n">opt</span><span 
class="o">/</span><span class="n">traffic_ops</span><span 
class="o">/</span><span class="n">app</span><span class="o">/</span><span 
class="n">conf</span><span class="o">/</span><span class="n">cdn</span><span 
class="o">.</span><span class="n">conf</span>
+<span class="n">Reading</span> <span class="n">log4perl</span> <span 
class="n">config</span> <span class="kn">from</span> <span 
class="o">/</span><span class="n">opt</span><span class="o">/</span><span 
class="n">traffic_ops</span><span class="o">/</span><span 
class="n">app</span><span class="o">/</span><span class="n">conf</span><span 
class="o">/</span><span class="n">production</span><span 
class="o">/</span><span class="n">log4perl</span><span class="o">.</span><span 
class="n">conf</span>
+<span class="n">Starting</span> <span class="n">hot</span> <span 
class="n">deployment</span> <span class="k">for</span> <span 
class="n">Hypnotoad</span> <span class="n">server</span> <span 
class="mf">32192.</span>
 
-Waiting for Traffic Ops to start.
+<span class="n">Waiting</span> <span class="k">for</span> <span 
class="n">Traffic</span> <span class="n">Ops</span> <span class="n">to</span> 
<span class="n">start</span><span class="o">.</span>
 
 
-Shutdown Traffic Ops [y/n] [n]:  n
+<span class="n">Shutdown</span> <span class="n">Traffic</span> <span 
class="n">Ops</span> <span class="p">[</span><span class="n">y</span><span 
class="o">/</span><span class="n">n</span><span class="p">]</span> <span 
class="p">[</span><span class="n">n</span><span class="p">]:</span>  <span 
class="n">n</span>
 
-To start Traffic Ops:  service traffic_ops start
-To stop Traffic Ops:   service traffic_ops stop
+<span class="n">To</span> <span class="n">start</span> <span 
class="n">Traffic</span> <span class="n">Ops</span><span class="p">:</span>  
<span class="n">service</span> <span class="n">traffic_ops</span> <span 
class="n">start</span>
+<span class="n">To</span> <span class="n">stop</span> <span 
class="n">Traffic</span> <span class="n">Ops</span><span class="p">:</span>   
<span class="n">service</span> <span class="n">traffic_ops</span> <span 
class="n">stop</span>
 
-traffic_ops #
+<span class="n">traffic_ops</span> <span class="c1">#</span>
 </pre></div>
 </div>
 </div></blockquote>
@@ -565,11 +567,117 @@ traffic_ops #
 <ol class="arabic simple">
 <li>Enter the following command:<code class="docutils literal"><span 
class="pre">service</span> <span class="pre">traffic_ops</span> <span 
class="pre">stop</span></code></li>
 <li>Enter the following command:<code class="docutils literal"><span 
class="pre">yum</span> <span class="pre">upgrade</span> <span 
class="pre">traffic_ops</span></code></li>
-<li>See <a class="reference internal" href="#rl-ps"><em>Installing Traffic 
Ops</em></a> to run postinstall.</li>
+<li>See <a class="reference internal" href="#rl-ps"><span class="std 
std-ref">Installing Traffic Ops</span></a> to run postinstall.</li>
 <li>Enter the following command:<code class="docutils literal"><span 
class="pre">service</span> <span class="pre">traffic_ops</span> <span 
class="pre">start</span></code></li>
 </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 &#39;.&#39;, the field will be left blank.
+-----
+Country Name (2 letter code) [XX]:US&lt;enter&gt;
+State or Province Name (full name) []:CO&lt;enter&gt;
+Locality Name (eg, city) [Default City]:Denver&lt;enter&gt;
+Organization Name (eg, company) [Default Company Ltd]: &lt;enter&gt;
+Organizational Unit Name (eg, section) []: &lt;enter&gt;
+Common Name (eg, your name or your server&#39;s hostname) []: &lt;enter&gt;
+Email Address []: &lt;enter&gt;
+
+Please enter the following &#39;extra&#39; attributes
+to be sent with your certificate request
+A challenge password []: pass&lt;enter&gt;
+An optional company name []: &lt;enter&gt;
+$ 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 &#39;.&#39;, the field will be left blank.
+-----
+Country Name (2 letter code) [XX]: &lt;enter country code&gt;
+State or Province Name (full name) []: &lt;enter state or province&gt;
+Locality Name (eg, city) [Default City]: &lt;enter locality name&gt;
+Organization Name (eg, company) [Default Company Ltd]: &lt;enter organization 
name&gt;
+Organizational Unit Name (eg, section) []: &lt;enter organizational unit 
name&gt;
+Common Name (eg, your name or your server&#39;s hostname) []: &lt;enter 
server&#39;s hostname name&gt;
+Email Address []: &lt;enter e-mail address&gt;
+
+Please enter the following &#39;extra&#39; attributes
+to be sent with your certificate request
+A challenge password []: &lt;enter challenge password&gt;
+An optional company name []: &lt;enter&gt;
+$ 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
+      &#39;hypnotoad&#39; =&gt; ...
+          &#39;listen&#39; =&gt; 
&#39;https://[::]:443?cert=/etc/pki/tls/certs/trafficops.crt&amp;key=/etc/pki/tls/private/trafficops.key&amp;ca=/etc/pki/tls/certs/localhost.ca&amp;verify=0x00&amp;ciphers=AES128-GCM-SHA256:HIGH:!RC4:!MD5:!aNULL:!EDH:!ED&#39;
+       ...
+</pre></div>
+</div>
+</div>
+</div>
+</div>
 </div>
 
 
@@ -610,7 +718,7 @@ traffic_ops #
     <script type="text/javascript">
         var DOCUMENTATION_OPTIONS = {
             URL_ROOT:'../',
-            VERSION:'master',
+            VERSION:'1.8-dev',
             COLLAPSE_INDEX:false,
             FILE_SUFFIX:'.html',
             HAS_SOURCE:  true

Reply via email to