You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@trafficcontrol.apache.org by da...@apache.org on 2017/06/07 23:54:59 UTC

[49/51] [partial] incubator-trafficcontrol-website git commit: 1.8.0 is latest release

http://git-wip-us.apache.org/repos/asf/incubator-trafficcontrol-website/blob/0ba7314b/docs/latest/_sources/admin/traffic_ops_install.rst.txt
----------------------------------------------------------------------
diff --git a/docs/latest/_sources/admin/traffic_ops_install.rst.txt b/docs/latest/_sources/admin/traffic_ops_install.rst.txt
deleted file mode 100644
index ca49461..0000000
--- a/docs/latest/_sources/admin/traffic_ops_install.rst.txt
+++ /dev/null
@@ -1,381 +0,0 @@
-.. 
-.. 
-.. Licensed under the Apache License, Version 2.0 (the "License");
-.. you may not use this file except in compliance with the License.
-.. You may obtain a copy of the License at
-.. 
-..     http://www.apache.org/licenses/LICENSE-2.0
-.. 
-.. Unless required by applicable law or agreed to in writing, software
-.. distributed under the License is distributed on an "AS IS" BASIS,
-.. WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-.. See the License for the specific language governing permissions and
-.. limitations under the License.
-.. 
-
-.. index::
-  Traffic Ops - Installing 
-  
-.. _rl-ps:
-
-Installing Traffic Ops
-%%%%%%%%%%%%%%%%%%%%%%
-
-System Requirements
--------------------
-The user must have the following for a successful install:
-
-* CentOS 6
-* 4 vCPUs
-* 32GB RAM
-* 20 GB disk space
-* YUM repository with minimally the following dependecies avaliable
-
-  * apr 1.3.9-5 
-  * apr-util 1.3.9-3 
-  * apr-util-ldap 1.3.9-3   
-  * expat-devel 2.0.1-11 
-  * genisoimage 1.1.9-12  
-  * httpd 2.2.15
-  * httpd-tools 2.2.15  
-  * libpcap-devel 14:1.4
-  * mod_ssl  1:2.2.15-29
-  * mysql 5.1.71 
-  * autoconf 2.63-5.1.
-  * automake 1.11.1-4
-  * gcc 4.4.7-4
-  * gettext 0.17-16
-  * libcurl-devel 7.19.7-37
-  * libtool 2.2.6-15.5
-  * mysql-devel 5.1.73-3
-  * perl-CPAN 1.9402-136
-  * libcurl 7.19.7-37
-  * openssl 1.0.1e-30
-  * cloog-ppl 0.15.7-1.2
-  * cpp 4.4.7-4
-  * cvs 1.11.23-16
-  * libgomp 4.4.7-4
-  * libidn-devel 1.18-2
-  * m4 1.4.13-5
-  * mpfr 2.4.1-6
-  * perl-Digest-SHA 1:5.47-136
-  * ppl 0.10.2-11
-  * curl 7.19.7-37
-  * openssl-devel 1.0.1e-30
- 
-* Access to `The Comprehensive Perl Archive Network (CPAN) <http://www.cpan.org/>`_
-
-.. Note:: The above versions are known to work on CentOS 6.5. Higher versions may work.
-
-.. Note:: Although Traffic Ops supports both MySQL and Postgres as a database, support for MySQL is more mature and better tested. It is best to use MySQL when first getting started, and the rest of this guide assumes MySQL as the database.
-
-Navigating the Install
------------------------
-To begin the install:
-
-1. Install Traffic Ops: 
-
-  Download the traffic_ops rpm package from http://trafficcontrol.apache.org/downloads/index.html
-  
-  ``sudo rpm -ivh traffic_ops-1.*.*-****.x86_64.rpm``
-
-
-
-
-
-2. After installation of Traffic Ops rpm enter the following command: ``sudo /opt/traffic_ops/install/bin/postinstall``
-
-  Example output::
-
-
-      trafficops-vm # /opt/traffic_ops/install/bin/postinstall
-
-      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.
-
-      Hit ENTER to continue:
-
-
-  The first thing postinstall will do is install additional packages needed from the yum repo.
-
-  Ater that, it will automatically proceed to installing the required Perl packages from CPAN.
-
-  .. Note:: Especially when installing Traffic Ops for the first time on a system this can take a long time, since many dependencies for the Mojolicous application need to be downloaded. Expect 30 minutes. 
-
-  If there are any prompts in this phase, please just answer with the defaults (some CPAN installs can prompt for install questions). 
-
-  When this phase is complete, you will see:: 
-
-      ...
-      Successfully installed Test-Differences-0.63
-      Successfully installed DBIx-Class-Schema-Loader-0.07042
-      Successfully installed Time-HiRes-1.9726 (upgraded from 1.9719)
-      Successfully installed Mojolicious-Plugin-Authentication-1.26
-      113 distributions installed
-      Complete! Modules were installed into /opt/traffic_ops/app/local
-      Linking perl libraries...
-      Installing perl scripts
-
-
-      This script will initialize the Traffic Ops database.
-      Please enter the following information in order to completely
-      configure the Traffic Ops mysql database.
-
-
-      Database type [mysql]:
-
-
-  The next phase of the install will ask you about the local environment for your CDN.
-
-  .. Note:: Before proceeding to this step, the database has to have at least a root password, and needs to be started. When using mysql, please type ``service mysqld start`` as root in another terminal and follow the instructions on the screen to set the root password.
-
-  .. Note:: CentOS files note.
-
-  Example output::
-
-      Database type [mysql]:
-      Database name [traffic_ops_db]:
-      Database server hostname IP or FQDN [localhost]:
-      Database port number [3306]:
-      Traffic Ops database user [traffic_ops]:
-      Password for traffic_ops:
-      Re-Enter password for traffic_ops:
-
-      Error: passwords do not match, try again.
-
-      Password for traffic_ops:
-      Re-Enter password for traffic_ops:
-
-      Database server root (admin) user name [root]:
-      Database server root password:
-      Database Type: mysql
-      Database Name: traffic_ops_db
-      Hostname: localhost
-      Port: 3306
-      Database User: traffic_ops
-      Is the above information correct (y/n) [n]:  y
-
-      The database properties have been saved to /opt/traffic_ops/app/conf/production/database.conf
-
-        The database configuration has been saved.  Now we need to set some custom
-        fields that are necessary for the CDN to function correctly.
-
-
-      Traffic Ops url [https://localhost]:  https://traffic-ops.kabletown.net
-      Human-readable CDN Name.  (No whitespace, please) [kabletown_cdn]:
-      DNS sub-domain for which your CDN is authoritative [cdn1.kabletown.net]:
-      Fully qualified name of your CentOS 6.5 ISO kickstart tar file, or 'na' to skip and add files later [/var/cache/centos65.tgz]:  na
-      Fully qualified location to store your ISO kickstart files [/var/www/files]:
-
-      Traffic Ops URL: https://traffic-ops.kabletown.net
-      Traffic Ops Info URL: https://traffic-ops.kabletown.net/info
-      Domainname: cdn1.kabletown.net
-      CDN Name: kabletown_cdn
-      GeoLocation Polling URL: https://traffic-ops.kabletown.net/routing/GeoIP2-City.mmdb.gz
-      CoverageZone Polling URL: https://traffic-ops.kabletown.net/routing/coverage-zone.json
-
-      Is the above information correct (y/n) [n]:  y
-      Install information has been saved to /opt/traffic_ops/install/data/json/post_install.json
-
-
-      Adding an administration user to the Traffic Ops database.
-
-      Administration username for Traffic Ops:  admin
-      Password for the admin user admin:
-      Verify the password for admin:
-      Do you wish to create an ldap configuration for access to traffic ops [y/n] ? [n]:  n
-      creating database
-      Creating database...
-      Creating user...
-      Flushing privileges...
-      setting up database
-      Executing 'drop database traffic_ops_db'
-      Executing 'create database traffic_ops_db'
-      Creating database tables...
-      Migrating database...
-      goose: migrating db environment 'production', current version: 0, target: 20150316100000
-      OK    20141222103718_extension.sql
-      OK    20150108100000_add_job_deliveryservice.sql
-      OK    20150205100000_cg_location.sql
-      OK    20150209100000_cran_to_asn.sql
-      OK    20150210100000_ds_keyinfo.sql
-      OK    20150304100000_add_ip6_ds_routing.sql
-      OK    20150310100000_add_bg_fetch.sql
-      OK    20150316100000_move_hdr_rw.sql
-      Seeding database...
-      Database initialization succeeded.
-      seeding profile data...
-      name EDGE1 description Edge 1
-      name TR1 description Traffic Router 1
-      name TM1 description Traffic Monitor 1
-      name MID1 description Mid 1
-      seeding parameter data...
-
-  Explanation of the information that needs to be provided:
-
-    +----------------------------------------------------+-----------------------------------------------------------------------------------------------+
-    |                       Field                        |                                          Description                                          |
-    +====================================================+===============================================================================================+
-    | Database type                                      | mysql or postgres                                                                             |
-    +----------------------------------------------------+-----------------------------------------------------------------------------------------------+
-    | Database name                                      | The name of the database Traffic Ops uses to store the configuration information              |
-    +----------------------------------------------------+-----------------------------------------------------------------------------------------------+
-    | Database server hostname IP or FQDN                | The hostname of the database server                                                           |
-    +----------------------------------------------------+-----------------------------------------------------------------------------------------------+
-    | Database port number                               | The database port number                                                                      |
-    +----------------------------------------------------+-----------------------------------------------------------------------------------------------+
-    | Traffic Ops database user                          | The username Traffic Ops will use to read/write from the database                             |
-    +----------------------------------------------------+-----------------------------------------------------------------------------------------------+
-    | Password for traffic ops                           | The password for the above database user                                                      |
-    +----------------------------------------------------+-----------------------------------------------------------------------------------------------+
-    | Database server root (admin) user name             | Privileged database user that has permission to create the database and user for Traffic Ops  |
-    +----------------------------------------------------+-----------------------------------------------------------------------------------------------+
-    | Database server root (admin) user password         | The password for the above privileged database user                                           |
-    +----------------------------------------------------+-----------------------------------------------------------------------------------------------+
-    | Traffic Ops url                                    | The URL to connect to this instance of Traffic Ops, usually https://<traffic ops host FQDN>/  |
-    +----------------------------------------------------+-----------------------------------------------------------------------------------------------+
-    | Human-readable CDN Name                            | The name of the first CDN traffic Ops will be managing                                        |
-    +----------------------------------------------------+-----------------------------------------------------------------------------------------------+
-    | DNS sub-domain for which your CDN is authoritative | The DNS domain that will be delegated to this Traffic Control CDN                             |
-    +----------------------------------------------------+-----------------------------------------------------------------------------------------------+
-    | name of your CentOS 6.5 ISO kickstart tar file     | See :ref:`Creating-CentOS-Kickstart`                                                          |
-    +----------------------------------------------------+-----------------------------------------------------------------------------------------------+
-    | Administration username for Traffic Ops            | The Administration (highest privilege) Traffic Ops user to create;                            |
-    |                                                    | use this user to login for the first time and create other users                              |
-    +----------------------------------------------------+-----------------------------------------------------------------------------------------------+
-    | Password for the admin user                        | The password for the above user                                                               |
-    +----------------------------------------------------+-----------------------------------------------------------------------------------------------+
-
-
-  The postinstall script will now seed the database with some inital configuration settings for the CDN and the servers in the CDN.
-
-  The next phase is the download of the geo location database and configuration of information needed for SSL certificates.
-
-  Example output::
-
-    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: "GeoLite2-City.mmdb.gz"
-
-    100%[==================================================================================================================================================================>] 17,633,433  7.03M/s   in 2.4s
-
-    2015-04-14 02:14:35 (7.03 MB/s) - "GeoLite2-City.mmdb.gz" saved [17633433/17633433]
-
-    Copying coverage zone file to public dir.
-
-    Installing SSL Certificates.
-
-      We're now running a script to generate a self signed X509 SSL certificate.
-      When prompted to enter a pass phrase, just enter 'pass' each time.  The
-      pass phrase will be stripped from the private key before installation.
-
-      When prompted to enter a 'challenge password', just hit the ENTER key.
-
-      The remaining enformation Country, State, Locality, etc... are required to
-      generate a properly formatted SSL certificate.
-
-    Hit Enter when you are ready to continue:
-    Postinstall SSL Certificate Creation.
-
-    Generating an RSA Private Server Key.
-
-    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:
-
-    The server key has been generated.
-
-    Creating a Certificate Signing Request (CSR)
-
-    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 '.', 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's hostname) []:
-    Email Address []:
-
-    Please enter the following 'extra' attributes
-    to be sent with your certificate request
-    A challenge password []:pass
-    An optional company name []:
-
-    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
-
-    The pass phrase has been removed from the server key.
-
-    Generating a Self-signed certificate.
-    Signature ok
-    subject=/C=US/ST=CO/L=Denver/O=Default Company Ltd
-    Getting Private key
-
-    A server key and self signed certificate has been generated.
-
-    Installing the server key and server certificate.
-
-    The private key has been installed.
-
-    Installing the self signed certificate.
-
-    Saving the self signed csr.
-
-      The self signed certificate has now been installed.
-
-      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.
-
-
-
-    SSL Certificates have been installed.
-
-    Starting Traffic Ops.
-
-    Starting Traffic Ops
-
-    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.
-
-    Waiting for Traffic Ops to start.
-
-
-    Shutdown Traffic Ops [y/n] [n]:  n
-
-    To start Traffic Ops:  service traffic_ops start
-    To stop Traffic Ops:   service traffic_ops stop
-
-    traffic_ops #
-
-Traffic Ops is now installed!
-
-Upgrading Traffic Ops
-=====================
-To upgrade:
-
-1. Enter the following command:``service traffic_ops stop``
-2. Enter the following command:``yum upgrade traffic_ops``
-3. See :ref:`rl-ps` to run postinstall.
-4. Enter the following command:``service traffic_ops start``

http://git-wip-us.apache.org/repos/asf/incubator-trafficcontrol-website/blob/0ba7314b/docs/latest/_sources/admin/traffic_ops_install.txt
----------------------------------------------------------------------
diff --git a/docs/latest/_sources/admin/traffic_ops_install.txt b/docs/latest/_sources/admin/traffic_ops_install.txt
new file mode 100644
index 0000000..ca49461
--- /dev/null
+++ b/docs/latest/_sources/admin/traffic_ops_install.txt
@@ -0,0 +1,381 @@
+.. 
+.. 
+.. Licensed under the Apache License, Version 2.0 (the "License");
+.. you may not use this file except in compliance with the License.
+.. You may obtain a copy of the License at
+.. 
+..     http://www.apache.org/licenses/LICENSE-2.0
+.. 
+.. Unless required by applicable law or agreed to in writing, software
+.. distributed under the License is distributed on an "AS IS" BASIS,
+.. WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+.. See the License for the specific language governing permissions and
+.. limitations under the License.
+.. 
+
+.. index::
+  Traffic Ops - Installing 
+  
+.. _rl-ps:
+
+Installing Traffic Ops
+%%%%%%%%%%%%%%%%%%%%%%
+
+System Requirements
+-------------------
+The user must have the following for a successful install:
+
+* CentOS 6
+* 4 vCPUs
+* 32GB RAM
+* 20 GB disk space
+* YUM repository with minimally the following dependecies avaliable
+
+  * apr 1.3.9-5 
+  * apr-util 1.3.9-3 
+  * apr-util-ldap 1.3.9-3   
+  * expat-devel 2.0.1-11 
+  * genisoimage 1.1.9-12  
+  * httpd 2.2.15
+  * httpd-tools 2.2.15  
+  * libpcap-devel 14:1.4
+  * mod_ssl  1:2.2.15-29
+  * mysql 5.1.71 
+  * autoconf 2.63-5.1.
+  * automake 1.11.1-4
+  * gcc 4.4.7-4
+  * gettext 0.17-16
+  * libcurl-devel 7.19.7-37
+  * libtool 2.2.6-15.5
+  * mysql-devel 5.1.73-3
+  * perl-CPAN 1.9402-136
+  * libcurl 7.19.7-37
+  * openssl 1.0.1e-30
+  * cloog-ppl 0.15.7-1.2
+  * cpp 4.4.7-4
+  * cvs 1.11.23-16
+  * libgomp 4.4.7-4
+  * libidn-devel 1.18-2
+  * m4 1.4.13-5
+  * mpfr 2.4.1-6
+  * perl-Digest-SHA 1:5.47-136
+  * ppl 0.10.2-11
+  * curl 7.19.7-37
+  * openssl-devel 1.0.1e-30
+ 
+* Access to `The Comprehensive Perl Archive Network (CPAN) <http://www.cpan.org/>`_
+
+.. Note:: The above versions are known to work on CentOS 6.5. Higher versions may work.
+
+.. Note:: Although Traffic Ops supports both MySQL and Postgres as a database, support for MySQL is more mature and better tested. It is best to use MySQL when first getting started, and the rest of this guide assumes MySQL as the database.
+
+Navigating the Install
+-----------------------
+To begin the install:
+
+1. Install Traffic Ops: 
+
+  Download the traffic_ops rpm package from http://trafficcontrol.apache.org/downloads/index.html
+  
+  ``sudo rpm -ivh traffic_ops-1.*.*-****.x86_64.rpm``
+
+
+
+
+
+2. After installation of Traffic Ops rpm enter the following command: ``sudo /opt/traffic_ops/install/bin/postinstall``
+
+  Example output::
+
+
+      trafficops-vm # /opt/traffic_ops/install/bin/postinstall
+
+      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.
+
+      Hit ENTER to continue:
+
+
+  The first thing postinstall will do is install additional packages needed from the yum repo.
+
+  Ater that, it will automatically proceed to installing the required Perl packages from CPAN.
+
+  .. Note:: Especially when installing Traffic Ops for the first time on a system this can take a long time, since many dependencies for the Mojolicous application need to be downloaded. Expect 30 minutes. 
+
+  If there are any prompts in this phase, please just answer with the defaults (some CPAN installs can prompt for install questions). 
+
+  When this phase is complete, you will see:: 
+
+      ...
+      Successfully installed Test-Differences-0.63
+      Successfully installed DBIx-Class-Schema-Loader-0.07042
+      Successfully installed Time-HiRes-1.9726 (upgraded from 1.9719)
+      Successfully installed Mojolicious-Plugin-Authentication-1.26
+      113 distributions installed
+      Complete! Modules were installed into /opt/traffic_ops/app/local
+      Linking perl libraries...
+      Installing perl scripts
+
+
+      This script will initialize the Traffic Ops database.
+      Please enter the following information in order to completely
+      configure the Traffic Ops mysql database.
+
+
+      Database type [mysql]:
+
+
+  The next phase of the install will ask you about the local environment for your CDN.
+
+  .. Note:: Before proceeding to this step, the database has to have at least a root password, and needs to be started. When using mysql, please type ``service mysqld start`` as root in another terminal and follow the instructions on the screen to set the root password.
+
+  .. Note:: CentOS files note.
+
+  Example output::
+
+      Database type [mysql]:
+      Database name [traffic_ops_db]:
+      Database server hostname IP or FQDN [localhost]:
+      Database port number [3306]:
+      Traffic Ops database user [traffic_ops]:
+      Password for traffic_ops:
+      Re-Enter password for traffic_ops:
+
+      Error: passwords do not match, try again.
+
+      Password for traffic_ops:
+      Re-Enter password for traffic_ops:
+
+      Database server root (admin) user name [root]:
+      Database server root password:
+      Database Type: mysql
+      Database Name: traffic_ops_db
+      Hostname: localhost
+      Port: 3306
+      Database User: traffic_ops
+      Is the above information correct (y/n) [n]:  y
+
+      The database properties have been saved to /opt/traffic_ops/app/conf/production/database.conf
+
+        The database configuration has been saved.  Now we need to set some custom
+        fields that are necessary for the CDN to function correctly.
+
+
+      Traffic Ops url [https://localhost]:  https://traffic-ops.kabletown.net
+      Human-readable CDN Name.  (No whitespace, please) [kabletown_cdn]:
+      DNS sub-domain for which your CDN is authoritative [cdn1.kabletown.net]:
+      Fully qualified name of your CentOS 6.5 ISO kickstart tar file, or 'na' to skip and add files later [/var/cache/centos65.tgz]:  na
+      Fully qualified location to store your ISO kickstart files [/var/www/files]:
+
+      Traffic Ops URL: https://traffic-ops.kabletown.net
+      Traffic Ops Info URL: https://traffic-ops.kabletown.net/info
+      Domainname: cdn1.kabletown.net
+      CDN Name: kabletown_cdn
+      GeoLocation Polling URL: https://traffic-ops.kabletown.net/routing/GeoIP2-City.mmdb.gz
+      CoverageZone Polling URL: https://traffic-ops.kabletown.net/routing/coverage-zone.json
+
+      Is the above information correct (y/n) [n]:  y
+      Install information has been saved to /opt/traffic_ops/install/data/json/post_install.json
+
+
+      Adding an administration user to the Traffic Ops database.
+
+      Administration username for Traffic Ops:  admin
+      Password for the admin user admin:
+      Verify the password for admin:
+      Do you wish to create an ldap configuration for access to traffic ops [y/n] ? [n]:  n
+      creating database
+      Creating database...
+      Creating user...
+      Flushing privileges...
+      setting up database
+      Executing 'drop database traffic_ops_db'
+      Executing 'create database traffic_ops_db'
+      Creating database tables...
+      Migrating database...
+      goose: migrating db environment 'production', current version: 0, target: 20150316100000
+      OK    20141222103718_extension.sql
+      OK    20150108100000_add_job_deliveryservice.sql
+      OK    20150205100000_cg_location.sql
+      OK    20150209100000_cran_to_asn.sql
+      OK    20150210100000_ds_keyinfo.sql
+      OK    20150304100000_add_ip6_ds_routing.sql
+      OK    20150310100000_add_bg_fetch.sql
+      OK    20150316100000_move_hdr_rw.sql
+      Seeding database...
+      Database initialization succeeded.
+      seeding profile data...
+      name EDGE1 description Edge 1
+      name TR1 description Traffic Router 1
+      name TM1 description Traffic Monitor 1
+      name MID1 description Mid 1
+      seeding parameter data...
+
+  Explanation of the information that needs to be provided:
+
+    +----------------------------------------------------+-----------------------------------------------------------------------------------------------+
+    |                       Field                        |                                          Description                                          |
+    +====================================================+===============================================================================================+
+    | Database type                                      | mysql or postgres                                                                             |
+    +----------------------------------------------------+-----------------------------------------------------------------------------------------------+
+    | Database name                                      | The name of the database Traffic Ops uses to store the configuration information              |
+    +----------------------------------------------------+-----------------------------------------------------------------------------------------------+
+    | Database server hostname IP or FQDN                | The hostname of the database server                                                           |
+    +----------------------------------------------------+-----------------------------------------------------------------------------------------------+
+    | Database port number                               | The database port number                                                                      |
+    +----------------------------------------------------+-----------------------------------------------------------------------------------------------+
+    | Traffic Ops database user                          | The username Traffic Ops will use to read/write from the database                             |
+    +----------------------------------------------------+-----------------------------------------------------------------------------------------------+
+    | Password for traffic ops                           | The password for the above database user                                                      |
+    +----------------------------------------------------+-----------------------------------------------------------------------------------------------+
+    | Database server root (admin) user name             | Privileged database user that has permission to create the database and user for Traffic Ops  |
+    +----------------------------------------------------+-----------------------------------------------------------------------------------------------+
+    | Database server root (admin) user password         | The password for the above privileged database user                                           |
+    +----------------------------------------------------+-----------------------------------------------------------------------------------------------+
+    | Traffic Ops url                                    | The URL to connect to this instance of Traffic Ops, usually https://<traffic ops host FQDN>/  |
+    +----------------------------------------------------+-----------------------------------------------------------------------------------------------+
+    | Human-readable CDN Name                            | The name of the first CDN traffic Ops will be managing                                        |
+    +----------------------------------------------------+-----------------------------------------------------------------------------------------------+
+    | DNS sub-domain for which your CDN is authoritative | The DNS domain that will be delegated to this Traffic Control CDN                             |
+    +----------------------------------------------------+-----------------------------------------------------------------------------------------------+
+    | name of your CentOS 6.5 ISO kickstart tar file     | See :ref:`Creating-CentOS-Kickstart`                                                          |
+    +----------------------------------------------------+-----------------------------------------------------------------------------------------------+
+    | Administration username for Traffic Ops            | The Administration (highest privilege) Traffic Ops user to create;                            |
+    |                                                    | use this user to login for the first time and create other users                              |
+    +----------------------------------------------------+-----------------------------------------------------------------------------------------------+
+    | Password for the admin user                        | The password for the above user                                                               |
+    +----------------------------------------------------+-----------------------------------------------------------------------------------------------+
+
+
+  The postinstall script will now seed the database with some inital configuration settings for the CDN and the servers in the CDN.
+
+  The next phase is the download of the geo location database and configuration of information needed for SSL certificates.
+
+  Example output::
+
+    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: "GeoLite2-City.mmdb.gz"
+
+    100%[==================================================================================================================================================================>] 17,633,433  7.03M/s   in 2.4s
+
+    2015-04-14 02:14:35 (7.03 MB/s) - "GeoLite2-City.mmdb.gz" saved [17633433/17633433]
+
+    Copying coverage zone file to public dir.
+
+    Installing SSL Certificates.
+
+      We're now running a script to generate a self signed X509 SSL certificate.
+      When prompted to enter a pass phrase, just enter 'pass' each time.  The
+      pass phrase will be stripped from the private key before installation.
+
+      When prompted to enter a 'challenge password', just hit the ENTER key.
+
+      The remaining enformation Country, State, Locality, etc... are required to
+      generate a properly formatted SSL certificate.
+
+    Hit Enter when you are ready to continue:
+    Postinstall SSL Certificate Creation.
+
+    Generating an RSA Private Server Key.
+
+    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:
+
+    The server key has been generated.
+
+    Creating a Certificate Signing Request (CSR)
+
+    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 '.', 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's hostname) []:
+    Email Address []:
+
+    Please enter the following 'extra' attributes
+    to be sent with your certificate request
+    A challenge password []:pass
+    An optional company name []:
+
+    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
+
+    The pass phrase has been removed from the server key.
+
+    Generating a Self-signed certificate.
+    Signature ok
+    subject=/C=US/ST=CO/L=Denver/O=Default Company Ltd
+    Getting Private key
+
+    A server key and self signed certificate has been generated.
+
+    Installing the server key and server certificate.
+
+    The private key has been installed.
+
+    Installing the self signed certificate.
+
+    Saving the self signed csr.
+
+      The self signed certificate has now been installed.
+
+      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.
+
+
+
+    SSL Certificates have been installed.
+
+    Starting Traffic Ops.
+
+    Starting Traffic Ops
+
+    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.
+
+    Waiting for Traffic Ops to start.
+
+
+    Shutdown Traffic Ops [y/n] [n]:  n
+
+    To start Traffic Ops:  service traffic_ops start
+    To stop Traffic Ops:   service traffic_ops stop
+
+    traffic_ops #
+
+Traffic Ops is now installed!
+
+Upgrading Traffic Ops
+=====================
+To upgrade:
+
+1. Enter the following command:``service traffic_ops stop``
+2. Enter the following command:``yum upgrade traffic_ops``
+3. See :ref:`rl-ps` to run postinstall.
+4. Enter the following command:``service traffic_ops start``