4 Installing Oracle Linux Automation Manager on a Single-Host Deployment

This chapter shows you how to set up a host and install the Oracle Linux Automation Manager software and includes an option for using a remote or local database.

Installing on a Single Host

This section provides instructions for installing the Oracle Linux Automation Manager on a single host where the database is local or on a remote host.

To set up the host:

  1. On the Oracle Linux Automation Manager host, run the following commands:

    sudo su -l awx -s /bin/bash
    
  2. Enter the following command:

    awx-manage provision_instance --hostname=<hostname or IP address> --node_type=hybrid

    In the previous example, hostname or IP address is the hostname or IP address of the system running Oracle Linux Automation Manager. If hostname is used, the host must be resolvable.

  3. Run the following command to register the default execution environments, which are:
    • Control Plane Execution Environment
    • OLAM EE: (Latest)
    awx-manage register_default_execution_environments
  4. Run the following command to create the default queue for standard jobs that run playbooks:

    awx-manage register_queue --queuename=default --hostnames=<hostname or IP address>
  5. Run the following command to create the controlplane queue for Oracle Linux Automation Manager management type jobs.
    awx-manage register_queue --queuename=controlplane --hostnames=<hostname or IP address>
    
                
  6. Exit the awx shell environment.
    exit
  7. Remove any default configuration for Receptor. Edit /etc/receptor/receptor.conf to contain the following configuration:

    ---
    - node:
        id: <IP address>
     
    - log-level: debug
     
    - tcp-listener:
        port: port_number
     
    - control-service:
        service: control
        filename: /var/run/receptor/receptor.sock
     
    - work-command:
        worktype: local
        command: /var/lib/ol-automation-manager/venv/awx/bin/ansible-runner
        params: worker
        allowruntimeparams: true
    #    verifysignature: true
    In the previous example, hostname or IP address is the IP address of the host and port_number is the port number that this node is listening on. For example, you can call the host single1-192.0.121.30 where you provide a node name and the IP address of the node. And you could configure the tcp-listener list listen on port 27199.
  8. Start the service:

    sudo systemctl enable --now ol-automation-manager.service
  9. Run the following command to preload data, such as:
    • Demo Project
    • Default Galaxy Credentials
    • Demo Organization
    • Demo Inventory
    • Demo Job template
    • And so on
    sudo su -l awx -s /bin/bash
    awx-manage create_preload_data 
  10. Exit the awx shell environment.
    exit
  11. The host is now ready. Using a browser, you can now log in as the admin user.
    https://<hostname or IP address>