Chapter 2. Installing the Ansible Engine and RHEL System Roles for SAP

Procedure

1. Install Ansible Core:

   # dnf install ansible-core

   Copy to Clipboard Toggle word wrap

   Continue with step 2 for installing the RHEL package rhel-system-roles-sap or with step 3 for installing the Automation Hub collection redhat.sap_install.

2. For installing the RHEL package rhel-system-roles-sap:

   1. Enable the RHEL for SAP Solutions repository using Red Hat Subscription Manager:

      # subscription-manager repos
      --enable=rhel-$(rpm -E %rhel)-for-$(uname -m)-sap-solutions-rpms

      Copy to Clipboard Toggle word wrap

   2. Install the RHEL System Roles for SAP:

      # dnf install rhel-system-roles-sap

      Copy to Clipboard Toggle word wrap

      The rhel-system-roles-sap package is installed to /usr/share/ansible/roles/<role>, where <role> is the name of the individual role, for example,sap_hana_preconfigure. Each role includes a README.md file which explains all variables and how to use the role.

3. For installing the Automation Hub collection redhat.sap_install, you can either directly install the collection from Automation Hub or first download it and then install it from the downloaded file.

   1. To install the collection directly from Automation Hub, follow the instructions on this page. The essential steps are:

      1. Make a copy of your Offline token, the Server URL, and the SSO URL from this page and note the Server URL and SSO URL on the same page. If needed (e.g. because it expired), recreate the token.

      2. Use these values to configure file /etc/ansible/ansible.cfg according to the instructions in this chapter. Use the Server URL for variable url, the SSO URL for variable auth_url, and the Offline token for variable token, as in the following example (replace the dummy token by the actual token):

         [galaxy]
         server_list = automation_hub_install
         
         [galaxy_server.automation_hub_install]
         url = https://console.redhat.com/api/automation-hub/[https://console.redhat.com/api/automation-hub/]
         auth_url = https://sso.redhat.com/auth/realms/redhat-external/protocol/openid-connect/token[https://sso.redhat.com/auth/realms/redhat-external/protocol/openid-connect/token]
         token = 123567890abcdef...abcdef1234

         Copy to Clipboard Toggle word wrap

      3. Install the collection by running the following command as the user which will use the collection (the user which will run the playbooks to install software or configure settings on managed nodes):

         # ansible-galaxy collection install redhat.sap_install

         Copy to Clipboard Toggle word wrap

         This will install the collection into the default location for the user (necessary directories will be created recursively), which is: ~/.ansible/collections/ansible_collections/redhat/sap_install.

   2. To download the collection from Automation Hub and then install it, perform the following step:

      1. Download the collection tar file from this page (use the Download tarball link) and then run the following command as the user which will use the collection:

         # ansible-galaxy collection install
         ./redhat-sap_install-1.2.1.tar.gz

         Copy to Clipboard Toggle word wrap

         This will also install the collection into the default location for the user, as described before.
         The file README.md in each role’s subdirectory below sap_install, e.g. roles/sap_general_preconfigure, contains the documentation for each of the roles.