Installation¶
Requirements¶
- PHP (>= 7.2)
- MySQL or PostgreSQL PHP libraries
- The following PHP modules must be installed: cURL, dom, json, libxml, pdo
- Icinga DB
- Icinga Web 2 (>= 2.9)
- Icinga PHP Library (ipl) (>= 0.9)
- Icinga PHP Thirdparty (>= 0.11)
- For exports to PDF the pdfexport (>= 0.10) module is required (Optional)
Installation¶
Using Packages¶
We provide a package for supported platforms. Search for icingadb-web
with your preferred package manager.
From Source¶
Please see Icinga Web 2’s documentation on how to install modules.
Use icingadb
as name.
Setup¶
-
Log in with a privileged user in Icinga Web 2 and enable the module in
Configuration -> Modules -> icingadb
. Or use theicingacli
and runicingacli module enable icingadb
. -
Create a new Icinga Web 2 resource for Icinga DB’s database using the
Configuration -> Application -> Resources
menu. -
The next step involves telling the module which database resource to use. This can be done in
Configuration -> Modules -> icingadb -> Database
. Choose the resource you’ve created just now. -
Finally head over to
Configuration -> Modules -> icingadb -> Redis
and define how the module should connect with Icinga DB’s Redis.
The full configuration is described in its own chapter.
If you previously had the monitoring module installed and configured, you might want to migrate some settings.
This concludes the installation. You should now be able to use Icinga DB Web.