[3/4] incubator-trafficcontrol git commit: adds example urls and vars; other small fixes

[de...@apache.org]

adds example urls and vars; other small fixes

Project: http://git-wip-us.apache.org/repos/asf/incubator-trafficcontrol/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-trafficcontrol/commit/7cc3ae16
Tree: http://git-wip-us.apache.org/repos/asf/incubator-trafficcontrol/tree/7cc3ae16
Diff: http://git-wip-us.apache.org/repos/asf/incubator-trafficcontrol/diff/7cc3ae16

Branch: refs/heads/master
Commit: 7cc3ae1662ab4e8a08057048a2f2567b010ffca8
Parents: 62a737d
Author: Dan Kirkwood <da...@gmail.com>
Authored: Wed Mar 15 13:43:10 2017 -0600
Committer: Dewayne Richardson <de...@apache.org>
Committed: Thu Mar 30 07:23:15 2017 -0600

----------------------------------------------------------------------
 traffic_ops/INSTALL.md | 39 +++++++++++++++++++++++++++++++--------
 1 file changed, 31 insertions(+), 8 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-trafficcontrol/blob/7cc3ae16/traffic_ops/INSTALL.md
----------------------------------------------------------------------
diff --git a/traffic_ops/INSTALL.md b/traffic_ops/INSTALL.md
index f1a9ab0..4b41fb9 100644
--- a/traffic_ops/INSTALL.md
+++ b/traffic_ops/INSTALL.md
@@ -8,14 +8,19 @@
 Instructions are here: https://yum.postgresql.org/
 
 - grab the link for CentOS 7 and install:
-    $ sudo yum install https://download.postgresql.org/pub/repos/yum/9.6/redhat/rhel-7-x86_64/pgdg-centos96-9.6-xxxx.noarch.rpm
 
+    $ sudo yum install https://download.postgresql.org/pub/repos/yum/9.6/redhat/rhel-7-x86_64/pgdg-centos96-9.6-xxxx.noarch.rpm
+    
+  NOTE: get a valid link from https://yum.postgresql.org/ with the correct version number.
+  
 - install `postgresql96` (for psql commands) and `postgresql96-devel` (for includes/libraries needed to install `DBD::Pg` perl library)
+
     $ sudo yum install postgresql96 postgresql96-devel
 
 ## Install Postgres 9.6 server (in a container or on the host)
 
 ### on the host:
+
    $ sudo yum install postgresql96-server
 
 ### -or- in a container
@@ -23,10 +28,13 @@ Instructions are here: https://yum.postgresql.org/
 NOTE: you do *not* need postgresql96-server if running postgres within a `docker` container.
 
 Install `docker` and `docker-compose` using instructions here:
+
     https://docs.docker.com/engine/installation/linux/centos/
+    
     https://docs.docker.com/compose/install/
 
 Add yourself to `docker` group
+
     $ sudo usermod -G docker $USER
 
 Remember to logout and login again..   You should see `docker` in your list of groups:
@@ -34,27 +42,37 @@ Remember to logout and login again..   You should see `docker` in your list of g
     $ id
     uid=9876(myuser) gid=9876(myuser) groups=9876(myuser),990(docker) ...
 
+Edit `mysql-to-postgres.env` to suit your needs.
+* modify `POSTGRES_*` vars to apply to new postgres container that will house your database, e.g.
+  * POSTGRES_USER=postgres
+  * POSTGRES_PASSWORD=itSas3cre4
+  
+If migrating from an existing pre-2.0 traffic_ops server (mysql):
+* `TO_*` vars for admin access to existing mysql-based `traffic_ops` (to get a db dump), e.g.
+  * TO_SERVER=https://trafficops.example.com
+  * TO_USER=dennisr
+  
+* `MYSQL_*` vars to apply to temporary mysql container -- really no need to change..
+
 Start a docker container to run postgres
+
     $ cd incubator-trafficcontrol/traffic_ops/app/db/pg-migration
     $ ./start_postgres.sh
 
-Edit `mysql-to-postgres.yml` to suit your needs.
-- modify `POSTGRES_*` vars to apply to new postgres container that will house
-
-If migrating from an existing pre-2.0 traffic_ops server (mysql):
-- `TO_*` vars for admin access to existing mysql-based `traffic_ops` (to get a db dump)
-- `MYSQL_*` vars to apply to temporary mysql container
-
 Run migration from existing mysql-based `traffic_ops`
+
     $ ./migrate.sh
 
 ## Install `traffic_ops`
+
     $ sudo yum install traffic_ops
 
 ## Install `go` and `gcc` (required for `goose` and some `Perl` modules)
+
     $ sudo yum install go gcc
     
 ## Install Perl modules
+
     $ sudo cpanm Carton
 
 IMPORTANT!!: We're using a later version of Postgresql,  so it's not installed in the default place.
@@ -66,6 +84,7 @@ We need to tell carton where it is so the `DBD::Pg` module is installed correctl
 
 
 ## Install goose
+
     $ sudo GOPATH=/tmp GOBIN=/usr/local/bin go get bitbucket.org/liamstask/goose/cmd/goose
 
 
@@ -88,14 +107,18 @@ We need to tell carton where it is so the `DBD::Pg` module is installed correctl
       - if logging data needed,  change ERROR to DEBUG on first line
 
 ## Initialize the db
+
     $ cd /opt/traffic_ops/app
     $ PERL5LIB=$(pwd)/lib:$(pwd)/local/lib/perl5 db/admin.pl --env=production setup
     
 ## Install any extensions needed
+
    - install in /opt/traffic_ops_extensions
    
 ## Install `openssl` certs (or use this to generate them)
+
    - `sudo /opt/traffic_ops/install/bin/generateCert`
    
 ## Install web dependencies
+
    - `sudo /opt/traffic_ops/install/bin/download_web_deps`