4 Please note that the current version of Icinga 2 isn't much more than a tech
5 demo. Expect some rough edges when installing and running Icinga 2.
7 For the "finished" version we're planning to release packages for the most
8 common Linux distributions as well as for Windows - or at least co-operate
9 with the package maintainers.
11 Please check the documentation in the doc/ directory for a current list
12 of available packages.
17 The following requirements need to be fulfilled in order to build the
18 application using a dist tarball (package names for RHEL and Debian in
23 * C++ compiler (gcc-c++ on RHEL, build-essential on Debian)
24 * OpenSSL library and header files (openssl-devel on RHEL, libssl-dev
26 * Boost library and header files (boost-devel on RHEL, libboost-all-dev
30 * optional: Doxygen (doxygen)
31 * optional: MySQL (mysql-devel on RHEL, libmysqlclient-dev on Debian)
32 * optional: Python (python-devel on RHEL, python-dev on Debian)
37 By default Icinga will run as user 'icinga' and group 'icinga'. Additionally the
38 external command pipe and livestatus features require a dedicated command group
39 'icingacmd'. You can choose your own user/group names and pass them to the
40 configure script using the --with-icinga-user, --with-icinga-group,
41 --with-icingacmd-user and --with-icingacmd-group options.
45 # useradd -c "icinga" -s /sbin/nologin -G icingacmd -g icinga
47 Add the web server user to the icingacmd group in order to grant it write
48 permissions to the external command pipe and livestatus socket:
50 # usermod -a -G icingacmd www-data
52 Make sure to replace "www-data" with the name of the user your web server
58 Once you have installed all the necessary build requirements you can build
59 Icinga 2 using the following commands:
61 $ mkdir build && cd build
66 You can specify an alternative installation prefix using -DCMAKE_INSTALL_PREFIX:
68 $ cmake .. -DCMAKE_INSTALL_PREFIX=/tmp/icinga2
73 Icinga 2 comes with a single binary that takes care of loading all the relevant
74 components (e.g. for check execution, notifications, etc.):
77 [2013-10-22 13:06:22 +0200] <Main Thread> information/icinga-app: Icinga application loader (version: 0.0.3, git branch master, commit 07d9a59f + changes)
78 [2013-10-22 13:06:22 +0200] <Main Thread> information/base: Adding library search dir: /usr/lib/icinga2
79 [2013-10-22 13:06:22 +0200] <Main Thread> information/base: Loading library 'libicinga.la'
80 [2013-10-22 13:06:22 +0200] <Main Thread> information/config: Adding include search dir: /usr/share/icinga2
81 [2013-10-22 13:06:22 +0200] <Main Thread> critical/icinga-app: You need to specify at least one config file (using the --config option).
83 Icinga 2 can be started as daemon using the provided init script:
86 Usage: /etc/init.d/icinga2 {start|stop|restart|reload|checkconfig|status}
88 Icinga 2 reads a single configuration file which is used to specify all
89 configuration settings (global settings, hosts, services, etc.). The
90 configuration format is explained in detail in the doc/ directory.
92 By default "make install" installs example configuration files in
93 /usr/local/etc/icinga2 unless you have specified a different prefix or