Icinga 2 Web

Table of Contents

1. Vagrant - Virtual development environment

Vagrant

The Icinga 2 Web project ships with a Vagrant virtual machine that integrates the source code with various services and example data in a controlled environment. This enables developers and users to test Livestatus, status.dat, MySQL and PostgreSQL backends as well as the LDAP authentication. All you have to do is install Vagrant and run:

vagrant up

After you should be able to browse localhost:8080/icinga2-web.

Environment

Forwarded ports:

Proctocol	Local port (virtual machine host)	Remote port (the virtual machine)
SSH	2222	22
HTTP	8080	80

Installed packages:

• Apache2 with PHP enabled
• PHP with MySQL and PostgreSQL libraries
• MySQL server and client software
• PostgreSQL server and client software
• Icinga prerequisites

Installed users and groups:

• User icinga with group icinga and icinga-cmd
• Webserver user added to group icinga-cmd

Installed software:

• Icinga 1.9.1 with IDOUtils using a MySQL database
• Icinga 1.9.1 with IDOUtils using a PostgreSQL database

Installed files:

• /usr/share/icinga/htpasswd.users account information for logging into the Icinga classic web interface for both icinga instances
• /usr/lib64/nagios/plugins Nagios Plugins 1.4.16 for both icinga instances

Icinga with IDOUtils using a MySQL database

Installation path: /usr/local/icinga-mysql

Services:

• icinga-mysql
• ido2db-mysql

Connect to the icinga mysql database using the following command:

mysql -u icinga -p icinga icinga

Access the Classic UI (CGIs) via localhost:8080/icinga-mysql. For logging into the Icinga classic web interface use user icingaadmin with password icinga.

Icinga with IDOUtils using a PostgreSQL database

Installation path: /usr/local/icinga-pgsql

Services:

• icinga-pgsql
• ido2db-pgsql

Connect to the icinga mysql database using the following command:

sudo -u postgres psql -U icinga -d icinga

Access the Classic UI (CGIs) via localhost:8080/icinga-pgsql. For logging into the Icinga classic web interface use user icingaadmin with password icinga.

MK Livestatus

MK Livestatus is added to the Icinga installation using a MySQL database.

Installation path:

• /usr/local/icinga-mysql/bin/unixcat
• /usr/local/icinga-mysql/lib/mk-livestatus/livecheck
• /usr/local/icinga-mysql/lib/mk-livestatus/livestatus.o
• /usr/local/icinga-mysql/etc/modules/mk-livestatus.cfg
• /usr/local/icinga-mysql/var/rw/live