Summary

AWX is a web-based task engine built on top of ansible. This guide will walk you through installing AWX on a fresh CentOS7 machine. In this guide Docker is used without Docker-compose and the bare-minimum options were selected to get the application up and running. Please refer to the official guide for more information or options.

Prerequisites

Virtual Machine Specs

• At least 4GB of memory
• At least 2 cpu cores
• At least 20GB of space
• Centos7 Image

Checklist

1. Operating System
   • [ ] Update OS
   • [ ] Install Git
   • [ ] Clone AWX
   • [ ] Install Ansible
   • [ ] Install Docker
   • [ ] Install Docker-py
   • [ ] Install GNU Make
2. Config File
   • [ ] Edit Postgres settings
3. Build and Run
   • [ ] Start Docker
   • [ ] Run Installer
4. Access AWX
   • [ ] Open up port 80
   • [ ] Enjoy

1. Operating System

All commands are assumed to be run as root.

If you are not already logged in as root, sudo before getting started

sudo su -

Update OS

1. Make sure your ‘/etc/resolv.conf’ file can resolve dns. Example resolv.conf file

   nameserver 8.8.8.8
   

2. Run

   yum update

   Note: If you are still unable to run a update you may need to clear your local cache.

   yum clean all && yum makecache

Install Git

3. Install Git

   yum install git

Clone AWX

4. Make a new directory and change to that directory

   cd /usr/local

5. Clone the official git repository to the working directory

   git clone https://github.com/ansible/awx.git

   cd /usr/local/awx

Install Ansible

6. Download and install ansible

   yum install ansible

   Unofficial Reference Documentation

Install Docker

7. Download yum-utils

   sudo yum install -y yum-utils \
   device-mapper-persistent-data \
   lvm2
   

8. Set up the repository

   sudo yum-config-manager \
   	--add-repo \
   	https://download.docker.com/linux/centos/docker-ce.repo
   

9. Install the latest version of Docker CE

   sudo yum install docker-ce docker-ce-cli containerd.io

   Official Reference Documentation

Install Docker-py

10. Enable the EPEL repository

    yum install epel-release

11. Install PIP

    yum install python-pip

    Unofficial Reference Documentation

12. Using pip install docker-py

    pip install docker-py

    Official Reference Documentation

Install GNU Make

13. Make should already be included in the OS, this can be verified using

    make --version

    If it has not been installed you can run

    yum install make

2. Config File

Edit Postgres Settings

Note: We will persist the PostgresDB to a custom directory.

15. Make the directory

    mkdir /etc/awx

    mkdir /etc/awx/db

16. Edit the inventory file

    vi /usr/local/awx/installer/inventory

    Find the entry that says "#postgres_data_dir" and replace it with

    postgres_data_dir=/etc/awx/db

    Save changes

    Note: As of 12/03/2019, there is a bug running with docker, to overcome the bug you need to find in the inventory "#pg_sslmode=require" and replace it with

    pg_sslmode=disable

3. Build

Start docker

17. Start the docker service

    systemctl start docker

Run installer

18. Change to the right path

    cd /usr/local/awx/installer/

19. Run the installer

    ansible-playbook -i inventory install.yml

    Note: You can track progress by running

    docker logs -f awx_task

4. Access AWX

Open up port 80

20. Check if firewalld is turned on, if it is not it is recommended

    To check:

    systemctl status firewalld

    To start:

    systemcl start firewalld

21. Open up port 80

    firewall-cmd --permanent --add-port=80/tcp

    firewall-cmd --reload

Enjoy

22. You can now browse your host IP and access and enjoy "http://<your host ip>"!

    Note: Default username is "admin" and password is "password"