Icinga

From Amahi Wiki
Revision as of 04:40, 11 June 2011 by Sag47 (talk | contribs)
Jump to: navigation, search


This is for intermediate to advanced users of Linux and Amahi. Understand that without a web interface to do the configuration of objects the learning curve is large to configure Icinga for the first time.

What is Icinga?

Icinga is a fork of Nagios. It is network monitoring software designed to monitor the overall status of your network through a polling system. This way when computers go down you know before anyone else because it will show up in Icinga.

In my Amahi HDA, I use Icinga to monitor: file share servers, network printers, router, internet modem, different internet websites. The reason why I monitor my router, internet mode and internet websites is because when my internet goes down I want to know if it's my router that is the problem or my ISP.

Icinga will also track statistics so you can measure how much downtime your computers have (or downtime of the internet) so you have exact statistics of your network monitored in realtime.

Now on to the good stuff.

How to install Icinga

Prerequisites

  • Fedora 14
  • Amahi set up and running
  • and the following packages installed
bash code
​yum groupinstall "Development Tools" "Legacy Software Development"


Installation

Follow the Quickstart Installation Guide for Icinga to compile and install Icinga and common Nagios plugins.

Once you have Icinga running when you attempt to access the web interface you should get permission denied. That is okay because we're going to fix that now.

Visit your hda at http://hda because now you have to set up a webapp. I know that this is in reverse order and that it should be compiled for the webapp directory but I'm still new to Amahi and not new to other things. So more detailed and correct instructions will come later.

Anyway, go to http://hda/setup?sub=webapps&tab=app and create a new webapp and call it icinga.

Now it's time to go into the terminal. All commands will be run as root and lines that start with # are comments.

bash code
​ls /etc/httpd/conf.d/ | grep icinga #you should see two files. Something like 1007-icinga.conf and icinga.conf cat /etc/httpd/conf.d/icinga.conf >> /etc/httpd/conf.d/1007-icinga.conf #Now edit /etc/httpd/conf.d/1007-icinga.conf vim /etc/httpd/conf.d/1007-icinga.conf #and move </VirtualHost> from the middle of the file to the end. #be sure to confirm that the contents of icinga.conf are within 1007-icinga.conf before removing it rm /etc/httpd/conf.d/icinga.conf ​

Now you should have a 1007-icinga.conf file similar to the following (not exact)

Text
​'"`UNIQ--pre-00000003-QINU`"'​

NOTE: The Icinga instructions should be rewritten so that it conforms to the icinga app path for Amahi standards.

Go to Icinga

Now visit Icinga at

Link
​http://icinga/icinga​

You can add a simple html redirect to /var/hda/web-apps/icinga/html/index.html to automatically redirect you so that you only have to visit http://icinga/.

TODO:

When I update the instructions I'll write compiling instructions to:

  • Install icinga to /var/hda/web-apps/icinga/html/icinga.
  • Create a ScriptAlias to /cgi-bin instead of /icinga/cgi-bin
  • Create an Alias to / instead of /icinga so that a user only need to visit http://icinga/

That's all for now...

Sag47 21:37, 10 June 2011 (PDT)