Chapter 3. Editing the inventory file

Edit the inventory file to specify an installation of automation hub and update the required parameters.

  1. Navigate to the installer.

    1. [bundled installer] 

      $ cd ansible-automation-platform-setup-bundle-<latest-version>

    2. [online installer] 

      $ cd ansible-automation-platform-setup-<latest-version>
  2. Open the inventory file with a text editor.

  3. Edit the inventory file parameters to specify an installation of automation hub host only. Refer to the following example.

    1. Leave [automationcontroller] inventory information empty.

    2. Add [automationhub] group host information.

      Note

      Provide a reachable IP address for the [automationhub] host to ensure users can sync content from private automation hub from a different node.

    3. Update the values for automationhub_admin_password and automation_pg_password and any additional parameters based on your installation specifications:

      Example

      [automationcontroller]


[automationhub]
<reachable-ip> ansible_connection=local

[all:vars]
automationhub_admin_password= <PASSWORD>

automationhub_pg_host=''
automationhub_pg_port=''

automationhub_pg_database='automationhub'
automationhub_pg_username='automationhub'
automationhub_pg_password=<PASSWORD>
automationhub_pg_sslmode='prefer'

# The default install will deploy a TLS enabled Automation Hub.
# If for some reason this is not the behavior wanted one can
# disable TLS enabled deployment.
#
# automationhub_disable_https = False
# The default install will generate self-signed certificates for the Automation
# Hub service. If you are providing valid certificate via automationhub_ssl_cert
# and automationhub_ssl_key, one should toggle that value to True.
#
# automationhub_ssl_validate_certs = False
# SSL-related variables
# If set, this will install a custom CA certificate to the system trust store.
# custom_ca_cert=/path/to/ca.crt
# Certificate and key to install in Automation Hub node
# automationhub_ssl_cert=/path/to/automationhub.cert
# automationhub_ssl_key=/path/to/automationhub.key

3.1. Connecting automation hub to a Red Hat Single Sign-On environment

To connect automation hub to a Red Hat Single Sign-On installation, configure inventory variables in the inventory file before you run the installer setup script.

You must configure a different set of variables when connecting to a Red Hat Single Sign-On installation managed by Ansible Automation Platform than when connecting to an external Red Hat Single Sign-On installation.

3.1.1. Inventory file variables for connecting automation hub to a Red Hat Single Sign-On instance

If you are installing automation hub and Red Hat Single Sign-On together for the first time or you have an existing Ansible Automation Platform managed Red Hat Single Sign-On, configure the variables for Ansible Automation Platform managed Red Hat Single Sign-On.

If you are installing automation hub and you intend to connect it to an existing externally managed Red Hat Single Sign-On instance, configure the variables for externally managed Red Hat Single Sign-On.

For more information about these inventory variables, refer to Ansible automation hub variables in the Red Hat Ansible Automation Platform Installation Guide.

The following variables can be configured for both Ansible Automation Platform managed and external Red Hat Single Sign-On:

VariableRequired or optional

sso_console_admin_password

Required

sso_console_admin_username

Optional

sso_use_https

Optional

sso_redirect_host

Optional

sso_ssl_validate_certs

Optional

sso_automation_platform_realm

Optional

sso_automation_platform_realm_displayname

Optional

sso_automation_platform_login_theme

Optional

The following variables can be configured for Ansible Automation Platform managed Red Hat Single Sign-On only:

VariableRequired or optional

sso_keystore_password

Required only if sso_use_https = true

sso_custom_keystore_file

Optional

sso_keystore_file_remote

Optional

sso_keystore_name

Optional

The following variable can be configured for external Red Hat Single Sign-On only:

VariableDescription

sso_host

Required