.readme-footer

## Requirements

_FreeIPA SSSD Tools_ from git repository:

- https://gitlab.com/gcoop-libre/freeipa-sssd-tools
- https://gitlab.com/gcoop-libre/freeipa-sssd-tools
- https://gitlab.com/osiux/freeipa-sssd-tools
- https://github.com/gcoop-libre/freeipa-sssd-tools
- https://github.com/gcoop-libre/freeipa-sssd-tools
- https://github.com/osiris/freeipa-sssd-tools
- https://codeberg.org/osiux/freeipa-sssd-tools

## Role Variables

Available variables with default values in `defaults/main.yml`.

## Dependencies

- `git`
- `gnuplot`
- `ldap-utils`
- `ldb-tools`
- `sssd-tools`

## Example Playbook

```yaml

---

- name: Install FreeIPA SSSD Tools
  hosts: [all]

  roles:
    - role: gcoop-libre.freeipa_sssd_tools

```

## Useful Playbooks

| _playbook_                                        | _description_                                                     |
|---------------------------------------------------|-------------------------------------------------------------------|
| [`cron.yml`](../tests/cron.yml)                   | Configure Crontab entries for _FreeIPA_ _SSSD_ _Tools_            |
| [`ipa-health-check.yml`](../ipa-health-check.yml) | Clone `freeipa-sssd-tools` and execute `ipa-hlt-chk`              |
| [`log.yml`](../tests/log.yml)                     | Generate stats report from _FreeIPA_ _SSSD_ _Tools_ _logs_        |
| [`start.yml`](../tests/start.md)                  | Start _FreeIPA_ _Tools_ Services and restore persistent `RAMDISK` |
| [`test.yml`](../tests/test.yml)                   | Install and configure _FreeIPA_ _Tools_                           |

## License

GNU General Public License, GPLv3.

## Author Information

This role was created in 2021 by
 [Osiris Alejandro Gomez](https://osiux.com/), worker cooperative of
 [gcoop Cooperativa de Software Libre](https://www.gcoop.coop/).