Eric Schirra bc8469eb7b Accepting request 1286904 from home:ecsos:monitoring
- Update to 1.0.5
  - This releases fixes a minor issue resulting in a deprecation notice when previewing a template #255
- Changes from 1.0.4
 - This release fixes the failing database migration of version 1.0.3 on PostgreSQL #252
- Changes from 1.0.3
  This is a security release. It is recommended to upgrade immediately.
  * Fixes
    - Stored XSS leads to SSRF CVE-2025-27406
    - Relative timeframe validation not working correctly #240
    - Timeframe with fixed date are not saved correctly #241
    - Provide better error message when attempting to create a duplicate report #218
    - Icon for "Reporting"-menu-item missing in icingaweb2 #249 (Requires Icinga Web 2.12)
- Changes from 1.0.2
  * Enhancements
    - Ensure compatibility with PHP 8.3
  * Fixes
    - Scheduler does not work with PDF type #229
    - DbMigration: Break once a correct schema version is found #235
- Changes from 1.0.1
  - https://github.com/Icinga/icingaweb2-module-reporting/milestone/5?closed=1
- Changes from 1.0.0
  - https://github.com/Icinga/icingaweb2-module-reporting/milestone/4?closed=1

OBS-URL: https://build.opensuse.org/request/show/1286904
OBS-URL: https://build.opensuse.org/package/show/server:monitoring/icingaweb2-module-reporting?expand=0&rev=4
2025-06-19 10:49:41 +00:00

Database Setup
==============
The module needs a MySQL/MariaDB database with the schema that's provided in the etc/schema/mysql.sql file.

Example command for creating the MySQL/MariaDB database. Please change the password:

CREATE DATABASE reporting;
GRANT SELECT, INSERT, UPDATE, DELETE, DROP, CREATE VIEW, INDEX, EXECUTE ON reporting.* TO reporting@localhost IDENTIFIED BY 'secret';

After, you can import the schema using the following command:

mysql -p -u root reporting < schema/mysql.sql

Module Installation
===================
1. Just drop this module to a reporting subfolder in your Icinga Web 2 module path.
2. Log in with a privileged user in Icinga Web 2 and enable the module in 
   Configuration -> Modules -> reporting. Or use the icingacli and run icingacli module enable reporting.
3. Once you've set up the database, create a new Icinga Web 2 resource for it 
   using the Configuration -> Application -> Resources menu. 
   Make sure that you set the character set to utf8mb4.
4. The next step involves telling the Reporting module which database resource to use.
   This can be done in Configuration -> Modules -> reporting -> Backend.

This concludes the installation. You should now be able create reports.

You also must enable modules: ipl, pdfexport and reactbundle.

Scheduler Daemon
================

systemctl enable icinga-reporting.service


Upgrading to Version x.y.z
==========================

Icinga Reporting version x.y.z requires a schema update for the database.
A new table template, linked to table report, has been introduced.
Please find the upgrade script in schema/mysql-migrations.

You may use the following command to apply the database schema upgrade file:

# mysql -u root -p reporting <schema/mysql-migrations/vx.y.z.sql

Description
No description provided
Readme 40 KiB
Languages
RPM Spec 100%