README.md

redhat-access-insights-client

Installs, configures, and registers a system to the Red Hat Insights service. This role is intended to work on RHEL 6 or RHEL 7, though it will generally work on any yum based system that has access to the redhat-access-insights RPM.

Requirements

N/A

Role Variables

• insights_display_name:

  Sets or resets the Display Name/System Name within Insights. Insights needs an easily identifiable name for each system. If no explicit display name is given to a system, Insights uses it's hostname. If a system's hostname is not easily identifiable, like "localhost" or "d4098731408", you can give it a better name by setting 'insights_display_name'

  If undefined (not set at all), this role will not make changes to a system's display name.

  If defined (set) to be the empty string, this role will remove any previously set display name for the system, and cause it to use the systems hostname as it's Display name/System name.

  If defined to be a non-empty string, this role will replace any previously set display name for the system with the given string.

Dependencies

N/A

Example Playbook

- hosts: all
  roles:
  - { role: redhataccess.redhat-access-insights-client, when: ansible_os_family == 'RedHat' }

If a system's hostname is not easily identifieable, but inventory_hostname is, set insights_display_name set to be inventory_hostname:

- hosts: all
  roles:
  - role: redhataccess.redhat-access-insights-client
    insights_display_name: "{{ inventory_hostname }}"
    when: ansible_os_family == 'RedHat'

Example Use

1. On a system where Ansible is installed, run the following command:

   $ ansible-galaxy install redhataccess.redhat-access-insights-client

2. Copy the Example Playbook to a file named 'install-insights.yml'.

3. Run the command, replacing 'myhost.example.com' with the name of the system where you want to install the insights client.

   $ ansible-playbook --limit=myhost.example.com install-insights.yml

License and Author

See GitHub source repo