Chapter 6. Troubleshooting RPM installation of Ansible Automation Platform


Use this information to troubleshoot your RPM installation of Ansible Automation Platform.

6.1. Gathering Ansible Automation Platform logs

With the sos utility, you can collect configuration, diagnostic, and troubleshooting data, and provide those files to Red Hat Technical Support. An sos report is a common starting point for Red Hat technical support engineers when performing analysis of a service request for the Ansible Automation Platform.

As part of the troubleshooting with Red Hat Support, you can collect the sos report for each node in your RPM installation of Ansible Automation Platform using the installation inventory and the installer.

Procedure

  1. Access the installer folder with the inventory file and run the installer setup script the following command:

    $ ./setup.sh -s

    With this command, you can connect to each node present in the inventory, install the sos tool, and generate new logs.

    Note

    If you are running the setup as a non-root user with sudo privileges, you can use the following command:

    $ ANSIBLE_BECOME_METHOD='sudo'
    ANSIBLE_BECOME=True ./setup.sh -s
  2. Optional: If required, change the location of the sos report files.

    The sos report files are copied to the /tmp folder for the current server. To change the location, specify the new location by using the following command:

    $ ./setup.sh -e 'target_sos_directory=/path/to/files' -s

    Where target_sos_directory=/path/to/files is used to specify the destination directory where the sos report will be saved. In this case, the sos report is stored in the directory /path/to/files.

  3. Gather the files described on the playbook output and share with the support engineer or directly upload the sos report to Red Hat.

    To create an sos report with additional information or directly upload the data to Red Hat, use the following command:

    $ ./setup.sh -e 'case_number=0000000' -e 'clean=true' -e 'upload=true' -s
    Table 6.1. Parameter Reference Table

    Parameter

    Description

    Default value

    case_number

    Specifies the support case number that you want.

    -

    clean

    Obfuscates sensitive data that might be present on the sos report.

    false

    upload

    Automatically uploads the sos report data to Red Hat.

    false

To know more about the sos report tool, see the KCS article: What is an sos report and how to create one in Red Hat Enterprise Linux?

Red Hat logoGithubRedditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

© 2024 Red Hat, Inc.