Icinga

Configuration Overview of Icinga-Web

Where are my config files?

We're trying to reduce global configuration files. Icinga operates in modules, every module has its own configuration. The Icinga-Web configuration settings like api, authentication and database settings are stored in etc/conf.d/. They won't get overwritten during the next upgrade process. The folder may be changed during installation using --with-conf-folder.

This is also done with the libraries. If you need information about the cronk library, take a look into app/modules/Cronks/lib (for js things app/modules/Cronks/lib/js).

A sample module looks like this:

tree -d -L 1 app/modules/AppKit/
app/modules/AppKit/
|-- actions
|-- config
|-- lib
|-- models
|-- templates
|-- validate
|-- views

Index

Global Configuration Section

app/config

Here you find the global configuration files for e.g. the Web session, the Icinga web path and the database information.

The main interesting files:

Session Cookie Lifetime

Example: change the session_cookie_lifetime

The Session Lifetime is the time in seconds until the Icinga Web session expires. It can be configured on global level in the file app/config/factories.xml.

#> vi app/config/factories.xml
<ae:parameter name="session_cookie_lifetime">3600</ae:parameter>

Please make your customised settings in factories.site.xml.

Change Icinga-Web timezone

Example: Change the default timezone for Icinga-Web

If the time(zone) in Icinga-Web differs from your system time(zone), please check the date.timezone entry in app/modules/AppKit/config/module.xml (e.g. 'Europe/Berlin')

#> vi app/modules/AppKit/config/module.xml
<ae:parameter name="date.timezone">GMT</ae:parameter>

Module Configuration

Customised Configuration

Notes

When creating and/or editing configuration files, keep the following in mind:

[Note] Note

After changing those configs you need to clear the config cache!

 #> rm -rf app/cache/config/*.php

or

 #> /usr/local/icinga-web/bin/clearcache.sh

You need more information? Please have a look at our Development Wiki.