Ansible Tower v2.3.1 Install/Upgrade

upgrade_ansible_tower_2.3.1.txt

I got many errors while working on the Ansible Tower upgrade from v2.1.0 to v2.3.1. I faced many issues in this journey, so thought of documenting those here.

============== 
 ISSUES FIXED 
============== 
1) ./setup.sh script fails while trying to look for postgres user 'awx'
TASK: [postgres | determine if postgresql user exists] ************************ 
fatal: [localhost] => error while evaluating conditional: pg_user_exists.stdout != '1'

2) Error while trying to upgrade supervisor
pkg_resources.DistributionNotFound: The 'meld3>=0.6.5' distribution was not found and is required by superviso

3) Error while importing module pkg_resources
ImportError: No module named pkg_resources

4) EPEL Repo Issue
https://github.com/ansible/ansible/issues/12898

====================
 FOLLOW THESE STEPS 
====================
# pip install --upgrade pip
# pip install --upgrade distribute
# pip install meld3

You might need to run the above commands multiple times, unless you get the output as below
# pip install --upgrade pip
Requirement already up-to-date: pip in /usr/lib/python2.6/site-packages
#
# pip install --upgrade distribute
Requirement already up-to-date: distribute in /usr/lib/python2.6/site-packages
Requirement already up-to-date: setuptools>=0.7 in /usr/lib/python2.6/site-packages (from distribute)
#
# pip install --upgrade meld3
Requirement already up-to-date: meld3 in /usr/lib/python2.6/site-packages
#

# curl -O https://bitbucket.org/pypa/setuptools/raw/bootstrap/ez_setup.py
# python ez_setup.py

# wget http://releases.ansible.com/ansible-tower/setup/ansible-tower-setup-2.3.1.tar.gz
# tar xf ansible-tower-setup-2.3.1.tar.gz && cd ansible-tower-setup-2.3.1
# cp /from/old/setup/tower_setup_conf.yml . -v   (Or recreate the file manually)

# vim roles/packages_el/files/epel-6.repo
...
baseurl=http://download.fedoraproject.org/pub/epel/6/$basearch
#mirrorlist=https://mirrors.fedoraproject.org/metalink?repo=epel-6&arch=$basearch
...
#

# vim roles/postgres/tasks/conf.yml  (Comment these lines)
...
... Delete/Comment the below lines and all lines after this
- name: determine if postgresql user exists
...
#

# ./configure -o tower_setup_conf.yml
# ./setup.sh