Ansible Role icingaweb2_module_reporting¶
This role installs and configures the IcingaWeb2 Reporting Module.
This role is tested with the following IcingaWeb2 Reporting Module versions:
1.0.2
Available since LFOps 3.0.0.
Requirements¶
Manual steps:
Deploy a configured IcingaWeb2 by running the icingaweb2 playbook (role: linuxfabrik.lfops.icingaweb2).
Deploy a SQL database server and create the database and user by running the mariadb_server playbook (role: linuxfabrik.lfops.mariadb_server).
Optional: deploy the IcingaWeb2 PDF Export Module by running the icingaweb2_module_pdfexport playbook (role: linuxfabrik.lfops.icingaweb2_module_pdfexport). It enables exporting to PDF (else only CSV and JSON are available).
Mandatory Role Variables¶
icingaweb2_module_reporting__database_login
The user account for accessing the reporting SQL database. Currently, only MySQL is supported.
Type: Dictionary.
icingaweb2_module_reporting__version
The module version to install. Possible options: https://github.com/Icinga/icingaweb2-module-reporting/releases.
Type: String.
Example:
# mandatory
icingaweb2_module_reporting__database_login:
username: 'icinga_reporting_user'
password: 'linuxfabrik'
icingaweb2_module_reporting__version: 'v1.0.2'
Optional Role Variables¶
icingaweb2_module_reporting__database_host
The host of the SQL database server.
Type: String.
Default:
'localhost'
icingaweb2_module_reporting__database_name
The name of the reporting SQL database.
Type: String.
Default:
'icinga_reporting'
icingaweb2_module_reporting__service_enabled
Enables or disables the reporting service, analogous to
systemctl enable/disable --now.Type: Bool.
Default:
true
Example:
# optional
icingaweb2_module_reporting__database_host: 'localhost'
icingaweb2_module_reporting__database_name: 'icinga_reporting'
icingaweb2_module_reporting__service_enabled: true