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``