This section provides instructions for installing the Private Automation Hub on a single host where the database is local or on a remote host and assumes that you have setup a passwordless SSH connection.

To set up the host:

1. On the deployment host, login as the user configured with Passwordless SSH to the target host. For more information, see Set Up Passwordless SSH.
2. Ensure python 3.6 is installed on your host. If python 3.6 is not installed, run the following command:

   sudo dnf install python36

3. Install the Private Automation Hub software:

   sudo dnf install ol-private-automation-hub-installer
           

4. Copy the contents of the /single-node folder to a working directory.

   cp -r /usr/share/ansible/collections/ansible_collections/oraclelinux/private_automation_hub/playbooks/single-node/ ~/single_node

5. From the working directory, create a hosts file from the hosts.singlenode.example. For example,

   cd ~/single_node
   cp hosts.singlenode.example hosts

6. Edit the hosts file as follows:

   all:
     hosts:
       hub:
         ansible_host: <ip_address_or_hostname>
         ansible_user: <username>

   In the previous example,

   • <ip_address_or_hostname> is the IP address or host name of the target node where you want to install Private Automation Hub. This host must be reacheable using SSH from the deployment host.

     Note:

     Valid characters for hostnames are a to z, 0 to 9, and the hyphen (-). A hostname may not start with a hyphen.
   • <username> is the username running the installer playbook commands on the target node where you want to install Private Automation Hub. This user must have sudo privileges.
7. If you want to configure additional installation paramaters to use during the installation, setup the installation parameter file as described in Configuring the Installation Parameter File.
8. Do one of the following:
   • If you want to install a local database on the same host running Private Automation Hub, run the following command:

     ansible-playbook single-node-install.yml -i hosts -e "olpah_admin_password=<admin_password> olpah_db_password=<db_password>"

     In the previous example, <admin_password> and <db_password> are the passwords for the default admin user and the database user account.

     Note:

     If you want to use the paramter file, add the following to the end of the command:

     -e "@single-node-vars.yml"

   • If you want to use an existing database on a remote host, run the following command:
     1. Log into the remote database.
     2. Create the database user accounts. For example:

        sudo su - postgres -c "createuser -S -P pulp"

     3. Enter and confirm the password for the pulp user.

        Note:

        This must be the same <db_password> as specified in the previous step.

        Enter password for new role: 
        Enter it again: 

     4. Create the database instance. For example:

        sudo su - postgres -c "createdb -O pulp pulp"

     5. From the single-node-install.yml file, remove the pulp_database role.
     6. Set the database hostname or IP address for the remote database (existing_db_host: <db_hostname_or_ip_address>) in the "@single-node-vars.yml" variables file. For more information about installing using the parameter file, see Configuring the Installation Parameter File.
     7. Return to the deployment server and run the following command:

        ansible-playbook single-node-install.yml -i hosts -e "olpah_admin_password=<admin_password> olpah_db_password=<db_password>" -e "@single-node-vars.yml"

        In the previous example, <admin_password> and <db_password> are the passwords for the default admin user and the database user account.
9. The host is now ready. Using a browser, you can now log in as the admin user.

   https://<ip_address_or_hostname>