nagios2Docs

The patch is adding new feature in core nagios. It allos to integrate nagios with documentation -HowTo systems like Wiki, mediawiki,Confluence .. etc.

It is connecting each check to corresponding page on WIKI where you can describe in detail what to do if there is alarm.

Here is the quick installation guide.

Download latest core version of nagios for example 3.4.1 version.

http://prdownloads.sourceforge.net/sourceforge/nagios/nagios-3.4.1.tar.gz

root@adminx:/usr/local/src# tar -zxvf nagios-3.4.1.tar.gz
root@adminx:/usr/local/src# cd nagios-3.4.1
root@adminx:/usr/local/src/nagios-3.4.1#

Copy the attached 2 files this project to the nagios folder

just verify it
root@adminx:/usr/local/src/nagios-3.4.1# ls -la *.diff
-rw-r--r-- 1 root root 964 Sep 5 17:20 nagios-3.4.1-cgiutils.c.diff
-rw-r--r-- 1 root root 2607 Sep 5 17:22 nagios-3.4.1-status.c.diff

now patch the source codes

root@adminx:/usr/local/src/nagios-3.4.1# patch cgi/status.c < nagios-3.4.1-status.c.diff
root@adminx:/usr/local/src/nagios-3.4.1# cgi/cgiutils.c < nagios-3.4.1-cgiutils.c.diff


Now go a head and compile your nagios as usual.

when nagiso is ready to run add teh following configuration lines into [YOUR_NAGIOS_PATH]/etc/cgi.cfg



# DOCUMENTATION URL (Optional)
# This option is allow to make interconection betwin Nagios and your
# documentation system like wiki,confluence .. etc.
#
# Example:
# docs_url=http://wiki.ghevondyan.net/mediawiki/index.php/Monitroing_HowTo:
# docs_title=HowTo
# docs_icon=/images/info.png
#
docs_url=http://[your wiki page URL]
docs_title=HowTo
docs_icon=/images/info.png




Restart The nagios and enjoy :-)
root@adminx:/usr/local/src/nagios-3.4.1# /etc/init.d/nagios restart
Running configuration check...done.
Stopping nagios: .done.
Starting nagios: done.

Now everything is ready you can go to the nagios web interface and will see the icons linked with the documents on "Service Status Details For All Host Groups" page.


Hope you will like the feature - I implement it in my previews companies Lycos Europe and Orange Armenia. This is really helpful and making very fast and efficient of 1-rs level support work.


If it is needed I can help to have the feature on old version of nagios also.


Thank you
Arsen Ghevondyan