|| what is icinga

Icinga is an enterprise grade open source monitoring system which keeps watch over a network and any conceivable network resource, notifies the user of errors and recoveries, and generates performance data for reporting. Scalable and extensible, Icinga can monitor complex, large environments across dispersed locations. :: icinga

|| how to install icinga on linux debian 6.0
| installing apache2 and mysqld

# apt-get install apache2 build-essential libgd2-xpm-dev
# apt-get install mysql-server mysql-client libdbi0 libdbi0-dev libdbd-mysql

| create user for icingad

# useradd -m icinga
# passwd icinga
# groupadd icinga-cmd
# usermod -a -G icinga-cmd icinga
# usermod -a -G icinga-cmd www-data

| download icinga core and nagios plugins

# cd /usr/src/
# wget //sourceforge.net/projects/icinga/files/icinga/1.3.1/icinga-1.3.1.tar.gz
# wget //sourceforge.net/projects/nagiosplug/files/nagiosplug/1.4.15/nagios-plugins-1.4.15.tar.gz

| build / compiling icinga from source

# tar -xzf icinga-1.3.1.tar.gz
# cd icinga-1.3.1
# ./configure --with-command-group=icinga-cmd --enable-idoutils
# make all && make fullinstall && make install-api

| configure icinga core

# vi /usr/local/icinga/etc/objects/contacts.cfg
### change on email contacts
# cd /usr/local/icinga/etc/
# mv idomod.cfg-sample idomod.cfg
# mv ido2db.cfg-sample ido2db.cfg
# vi icinga.cfg
### Uncomment this to enable idomod.o
broker_module=/usr/local/icinga/bin/idomod.o config_file=/usr/local/icinga/etc/idomod.cfg

| create database for icinga core

mysql> CREATE DATABASE icinga;
mysql> GRANT USAGE ON *.* TO 'icinga'@'localhost' IDENTIFIED BY 'icinga' WITH MAX_QUERIES_PER_HOUR 0 MAX_CONNECTIONS_PER_HOUR 0 MAX_UPDATES_PER_HOUR 0;
mysql> GRANT SELECT , INSERT , UPDATE , DELETE ON icinga.* TO 'icinga'@'localhost';
mysql> FLUSH PRIVILEGES ;
mysql> quit

| create tables for icinga database

# cd /usr/src/icinga-1.3.1/module/idoutils/db/mysql/
# mysql icinga < mysql.sql 

| setup icinga db on ido2db.cfg

# vi /usr/local/icinga/etc/ido2db.cfg
### setup on db connection, like:
db_servertype=mysql
db_host=localhost
db_port=3306
db_name=icinga
db_user=icinga
db_pass=icinga

| setup icinga on httpd / apache

# cd /usr/src/icinga-1.3.1
# make cgis && make install-cgis && make install-html && make install-webconf
# htpasswd -c /usr/local/icinga/etc/htpasswd.users icingaadmin

| restarting apache / httpd

# /etc/init.d/apache2 restart

| installing nagios-plugins for icinga core

# cd /usr/src/
# tar -xzf nagios-plugins-1.4.15.tar.gz
# cd nagios-plugins-1.4.15
# ./configure --prefix=/usr/local/icinga --with-cgiurl=/icinga/cgi-bin --with-htmurl=/icinga --with-nagios-user=icinga --with-nagios-group=icinga
# make && make install

|| starting ido2db and icingad

# /etc/init.d/ido2db start
# /etc/init.d/icinga start

|| add icingad on rc.d

# update-rc.d icinga defaults

|| checking icinga core
open your browser and go to :

//yourhostname.tld/icinga

|| links
| google
| icinga