NConf is a PHP based web-tool for configuring the Nagios monitoring software. It differs from similar tools by offering enterprise-class features like templates, dependencies and the ability to configure a large-scale, distributed Nagios server topology. It is mainly targeted at sysadmins, who already know Nagios, but are looking for a more convenient way of managing their configuration files.
Main features
- effortlessly maintain a distributed Nagios topology
- user-friendly web-GUI
- host & service templates
- graphical dependency viewer
- multiple authentication modes
- Nagios config importer
- CSV file importer
- perl database API
- data schema customizable and expandable
- runs on Linux / Apache / PHP / MySQL
Installing Dependencies
apt-get install apache2 php5 php5-mysql mysql-server perl libdbi-perl libdbd-mysql-perl gawk
/etc/init.d/apache2 restart
Download NConf & Extracting it to Web Directory
mkdir ~/downloads
cd ~/downloads
wget http://sourceforge.net/projects/nconf/files/nconf/1.2.6-0/nconf-1.2.6-0.tgz
cd /var/www
tar zxvf ~/downloads/nconf-1.2.6-0.tgz
cd /var/www/nconf
chown www-data config output static_cfg temp
chmod 777 /usr/local/nagios/bin/nagios
Creating database for NConf in MySQL
mysql -u root -p
mysql>create database nconf;
mysql>grant all on nconf.* to nconf@localhost identified by 'nconf';
Start Installation by typing http://localhost/nconf in your web browser
Click on click here to start the installation.
At the next screen NConf will check pre-installation dependencies. If NConf find any missing dependencies, installaer will not start the setup process. Click on Next button to go further.
Give your MySQL database details. In our setup
DBHOST = localhost
DBNAME = nconf
DBUSER = nconf
DBPASS = nconf
Click Next to go further
In General configuration
NCONFDIR = /var/www/nconf
NAGIOS_BIN = /usr/local/nagios/bin/nagios
TEMPLATE_DIR = nconf_fresh
In Authentication configuration, We are disabling authentication.
If everything goes well you will get Finish screen without any error. Don’t click on Finish button after getting this screen please run below commands and then click on finish button.
cd /var/www/nconf/
rm -rf INSTALL INSTALL.php UPDATE UPDATE.php
Once installed you can add host via the main contol panel.
After adding host click on Generate Nagios config. It will genrate config files in /var/www/nconf/output.
To apply Nconf configuration first we need to copy NConf files to Nagios directory and also make it’s entry in nagios.cfg
Following script will rename the existing .cfg to with cfg.bak and add new cfg files location in nagios.cfg
Create a file name nconf_nagios.sh in /root and copy following lines in it
#!/bin/bash
PATH=/usr/kerberos/sbin:/usr/kerberos/bin:/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin:/root/bin
#renaming existing files in /usr/local/nagios/etc/objects from .cfg to .cfg.bak
cd /usr/local/nagios/etc/objects
ORIGINAL=`ls -l | grep -v "total" | gawk '{ print $NF }'`
for BACKUP in $ORIGINAL
do
mv $BACKUP $BACKUP.bak
done
chown nagios:nagios /usr/local/nagios/etc/objects/*
chmod 644 /usr/local/nagios/etc/objects/*
#Copying new .cfg files to /usr/local/nagios/etc/objects/
cd /var/www/nconf/output
rm -rf global Default_collector
tar zxvf NagiosConfig.tgz
cp -av /var/www/nconf/output/global/* /usr/local/nagios/etc/objects/
cp -av /var/www/nconf/output/Default_collector/* /usr/local/nagios/etc/objects/
chown nagios:nagios /usr/local/nagios/etc/objects/*
chmod 644 /usr/local/nagios/etc/objects/*
#Adding new cfg files entry in /usr/local/nagios/etc/nagios.cfg
sed -i 's/^cfg_file=/#cfg_file=/g' /usr/local/nagios/etc/nagios.cfg
ls -l /usr/local/nagios/etc/objects/ | grep -v "total" | gawk '{ print $NF}' | grep -v "bak" | sed 's/^/cfg_file=\/usr\/local\/nagios\/etc\/objects\//g' >> /usr/local/nagios/etc/nagios.cfgNow run the script
chmod 777 /root/nconf_nagios.sh
/root/nconf_nagios.sh
Now our NConf and Nagios are working fine. Next time whenever you update or add any host/service in NConf run following script to apply the changes in Nagios. We are naming the script as nconf_update.sh. The script is in /root folder.
#!/bin/bash
PATH=/usr/kerberos/sbin:/usr/kerberos/bin:/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin:/root/bin
#Copying files from Nconf output directory to Nagios objects directory
cd /var/www/nconf/output
rm -rf global Default_collector
tar zxvf NagiosConfig.tgz
mv /var/www/nconf/output/global/* /usr/local/nagios/etc/objects/
mv /var/www/nconf/output/Default_collector/* /usr/local/nagios/etc/objects/
chown nagios:nagios /usr/local/nagios/etc/objects/*
chmod 644 /usr/local/nagios/etc/objects/*
/etc/init.d/nagios restart
To run the script
chmod 777 /root/nconf_update.sh
/root/nconf_update.sh
