.. 
.. Copyright 2015 Comcast Cable Communications Management, LLC
.. 
.. 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.
.. 

*****************************
Traffic Router Administration
*****************************
Installing Traffic Router
==========================
The following are requirements to ensure an accurate set up:

* Successful install of Traffic Ops
* Successful install of Traffic Monitor
* Administrative access to the Traffic Ops
* Physical address of the site
* perl-JSON
* perl-WWW-Curl

1. Enter the Traffic Router server into Traffic Ops.
2. Make sure the FQDN of the Traffic Monitor is resolvable in DNS.
3. Install a traffic router: ``sudo yum install traffic_router``.
4. Edit ``/opt/traffic_router/conf/traffic_monitor.properties`` and put in the correct online Traffic Monitor(s) for your CDN.

 Example: ::

	# list of ips or hostnames delimited by semicolon (;)
	traffic_monitor.bootstrap.hosts=traffic-mon-01.cdn.kabletown.net:80;

	# Instead of using the traffic_monitor.bootstrap.hosts property as a bootstrap
	# source before switching to ONLINE Monitors in the TrConfig, always
	# use the hosts listed for TrConfig and TrStates. Defaults to false.
	traffic_monitor.bootstrap.local = false

	# traffic_monitor.properties: url that should normally point to this file
	traffic_monitor.properties=file:/opt/traffic_router/conf/traffic_monitor.properties

	# Frequency for reloading this file
	# traffic_monitor.properties.reload.period=60000
   

5. Start Tomcat: ``sudo service tomcat start``, and test lookups with dig and curl against that server.
6. Snapshot CRConfig 

* This instantly associates production traffic on the servers. They need to be online when you change the DNS records.

9. Add the correct DNS entries to the SOA records for the CDN on which you are working.

10. Add the servers to the NS and SOA records for your domain.

Configuring Traffic Router
==========================
1. From **Misc > Profiles**, verify the following:
 
 * The Traffic Router information.
 * The profile is set correctly.
 * The Status is set to OFFLINE.

2. Verify the functionality of the DNS entry for the Traffic Router.
3. Click **Tools > Generate ISO**.
4. Complete the necessary fields.
5. Click **Download ISO**.

Troubleshooting and log files
=============================
Traffic Router log files are in ``/opt/traffic_router/var/log/``, and tomcat log files are in ``/opt/tomcat/logs/``.