From 429346116255629987070f8841444ef8aca5b86a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Lorenz=20K=C3=A4stle?= <12514511+RincewindsHat@users.noreply.github.com> Date: Mon, 18 Mar 2024 09:58:01 +0100 Subject: [PATCH] Add document for the configuration of the IcingaDB-Modul (#971) This adds a listing of the possible settings for the module in the configuration files. It is quite similar to the monitoring module, but wasn't documented for this one. --------- Co-authored-by: Johannes Meyer --- doc/03-Configuration.md | 39 +++++++++++++++++++++++++++++++++++++++ doc/10-Migration.md | 13 +++++++++++++ 2 files changed, 52 insertions(+) diff --git a/doc/03-Configuration.md b/doc/03-Configuration.md index ce24277b7..c02992fb4 100644 --- a/doc/03-Configuration.md +++ b/doc/03-Configuration.md @@ -61,6 +61,45 @@ For this you need an `ApiUser` object with at least the following permissions on also configure the secondary master's API command transport. Icinga DB Web then uses this transport if the primary one is not available. +## General Configuration + +You can adjust some default values of options users have while interacting with particular dialogs in the UI. (e.g. While acknowledging a problem) +These options can not be adjusted in the UI directly, but have to be set in the +configuration file `/etc/icingaweb2/modules/icingadb/config.ini`. + +### Available Settings and defaults + +Option | Description | Default +----------------------------------|-----------------------------------|------------ +acknowledge_expire | Sets "Use Expire Time" in Acknowledgement dialog. | **0 (false)** +acknowledge_expire_time | Sets the value for "Expire Time" in Acknowledgement dialog, its calculated as now + this setting. Format is a [PHP Dateinterval](http://www.php.net/manual/en/dateinterval.construct.php). | **1 hour (PT1H)**. +acknowledge_notify | Sets "Send Notification" in Acknowledgement dialog. | **1 (true)** +acknowledge_persistent | Sets "Persistent Comment" in Acknowledgement dialog. | **0 (false)** +acknowledge_sticky | Sets "Sticky Acknowledgement" in Acknowledgement dialog. | **0 (false)** +comment_expire | Sets "Use Expire Time" in Comment dialog. | **0 (false)** +hostdowntime_comment_text | Sets default text for "Comment" in Host Downtime dialog | "" +servicedowntime_comment_text | Sets default text for "Comment" in Service Downtime dialog. | "" +comment_expire_time | Sets default value for "Expire Time" in Comment dialog, its calculated as now + this setting. Format is a [PHP Dateinterval](http://www.php.net/manual/en/dateinterval.construct.php). | **1 hour (PT1H)** +custom_notification_forced | Sets "Forced" in Custom Notification dialog. | **0 (false)** +hostdowntime_all_services | Sets "All Services" in Schedule Host Downtime dialog. | **0 (false)** +hostdowntime_end_fixed | Sets default value for "End Time" in Schedule Host Downtime dialog for **Fixed** downtime, its calculated as now + this setting. Format is a [PHP Dateinterval](http://www.php.net/manual/en/dateinterval.construct.php). | **1 hour (PT1H)**. +hostdowntime_end_flexible | Sets default value for "End Time" in Schedule Host Downtime dialog for **Flexible** downtime, its calculated as now + this setting. Format is a [PHP Dateinterval](http://www.php.net/manual/en/dateinterval.construct.php). | **2 hours (PT2H)**. +hostdowntime_flexible_duration | Sets default value for "Flexible Duration" in Schedule Host Downtime dialog for **Flexible** downtime. Format is a [PHP Dateinterval](http://www.php.net/manual/en/dateinterval.construct.php). | **2 hour (PT2H)**. +servicedowntime_end_fixed | Sets default value for "End Time" in Schedule Service Downtime dialog for **Fixed** downtime, its calculated as now + this setting. Format is a [PHP Dateinterval](http://www.php.net/manual/en/dateinterval.construct.php). | **1 hour (PT1H)**. +servicedowntime_end_flexible | Set default value for "End Time" in Schedule Service Downtime dialog for **Flexible** downtime, its calculated as now + this setting. Format is a [PHP Dateinterval](http://www.php.net/manual/en/dateinterval.construct.php). | **1 hour (PT1H)**. +servicedowntime_flexible_duration | Set default value for "Flexible Duration" in Schedule Service Downtime dialog for **Flexible** downtime. Format is a [PHP Dateinterval](http://www.php.net/manual/en/dateinterval.construct.php). | **2 hour (PT2H)**. + + +### Example + +Setting acknowledgements with 2 hours expire time by default. + +``` +[settings] +acknowledge_expire = 1 +acknowledge_expire_time = PT2H +``` + ## Security To grant users permissions to run commands and restrict them to specific views, diff --git a/doc/10-Migration.md b/doc/10-Migration.md index a8ed80fa3..43fa1dbdd 100644 --- a/doc/10-Migration.md +++ b/doc/10-Migration.md @@ -8,6 +8,18 @@ If that is the case, this chapter has you covered. ## Configuration +### General configuration via config.ini + +Icinga DB Web still uses the same configuration format as the monitoring module. This means that the file +`/etc/icingaweb2/modules/monitoring/config.ini` can simply be copied over to +`/etc/icingaweb2/modules/icingadb/config.ini`: + +``` +cp /etc/icingaweb2/modules/monitoring/config.ini /etc/icingaweb2/modules/icingadb/config.ini +``` + +The behaviour of those options remains the same. + ### Command Transports Icinga DB Web still uses the same configuration format for command transports. This means that the file @@ -158,3 +170,4 @@ general access to the monitoring module, this is not automatically migrated. You It gives you the chance to review the performed changes, before letting them loose on your users. Please also take in mind, that Icinga DB Web handles permissions and restrictions differently. Our blog provides details on that: https://icinga.com/blog/2021/04/07/web-access-control-redefined/#icingadb-permission-linkage +