Trusted, Bureaucrats, Administrators
12,424
edits
Changes
From Amahi Wiki
→New Interface
= What is Icinga? =
* Fedora 14
* Amahi set up and running
* and update your HDA Server and install all of the following packages installedprereqs for Icinga/Icinga-web'''NOTE:''' If there is a kernel update then you should restart your machine after running yum update and start these instructions over. <pre>yum check-updateyum update -y{{Code|yum groupinstall "Development Tools" "Legacy Software Development"}}-yyum install <nowiki>httpd httpd-devel gcc glibc glibc-common gd gd-devel libjpeg libjpeg-devel libpng libpng-devel mysql mysql-server libdbi libdbi-devel libdbi-drivers libdbi-dbd-mysql net-snmp net-snmp-devel net-snmp-utils php php-cli php-pear php-xmlrpc php-xsl php-pdo php-gd php-ldap php-mysql php-mysql php-soap java-1.6.0-openjdk java-1.6.0-openjdk-devel zip unzip</nowiki> -y</PRE> == Create a Webapp ==Go to your HDA CP (HDA Control Panel) and go to Apps > Webapps and click New Webapp. Name it "icinga" without quotes.Root path should be /var/hda/web-apps/icinga (which is automatically generated by Amahi). Create /var/hda/web-apps/icinga/html/index.html and give it the following contents.<pre><nowiki><html><head><title>Icinga Monitoring Server</title><meta HTTP-EQUIV="REFRESH" content="0; url=/icinga/"></head><body></body></html></nowiki></pre> '''NOTE:''' Icinga will install to /usr/local/icinga. Icinga Web will install to /usr/local/icinga-web == Download required source tarballs ==Download the following packages from the [http://sourceforge.net/projects/icinga/files/ Icinga Project Page].* icinga/icinga-1.4.2.tar.gz or latest 1.4.x* icinga-web/icinga-web-1.4.1.tar.gz or latest 1.4.x* icinga-mobile/icinga-mobile-0.1.0.zip or latestDownload the following packages from the [http://sourceforge.net/projects/nagiosplug/files/ Nagios Plugin Project Page].* nagiosplug/1.4.15/nagios-plugins-1.4.15.tar.gz or latestDownload the [https://git.icinga.org/index?p=icinga-api.git;a=snapshot;h=refs/heads/master;sf=tgz latest Icinga API] from git snapshot as seen in the [http://docs.icinga.org/1.4.0/en/icinga-api.html Icinga API] documentation. Move all source tarballs to /usr/local/src/ on your HDA server. == Compile and install Icinga with IDOUtils ==Create an icinga user, icinga-cmd group, and add the apache user and icinga user to the icinga-cmd group.<pre>useradd -m icingagroupadd icinga-cmdusermod -a -G icinga-cmd icingausermod -a -G icinga-cmd apache</pre>
Now lets do some compiling.<pre>cd /usr/local/src/tar -xzf icinga-1.4.2.tar.gzcd icinga-1.4.2./configure <nowiki>--with-command-group== Installation ==icinga-cmd --enable-idoutils --enable-event-broker</nowiki>make allmake fullinstall</pre>Follow Edit the [http:''/usr/local/icinga/etc/objects/docscontacts.cfg'' config file with your favorite editor and change the email address associated with the icingaadmin contact definition to the address you'd like to use for receiving alerts.<pre>vim /usr/local/icinga/etc/objects/contacts.orgcfgcp /1usr/local/icinga/etc/ido2db.4cfg-sample /usr/local/icinga/etc/ido2db.0cfgcp /usr/local/icinga/enetc/quickstartidomod.cfg-sample /usr/local/icinga/etc/idomod.html Quickstart Installation Guide for Icinga] to compile and install Icinga and common Nagios pluginscfgcp /usr/local/icinga/etc/modules/idoutils.cfg-sample /usr/local/icinga/etc/modules/idoutils.cfg</pre>
#and move </VirtualHost> from the middle of the file to the end.
#be sure to confirm that the contents of icinga.conf are within 10071002-icinga.conf before removing itrm -f /etc/httpd/conf.d/icinga.conf</pre> Start icinga, idoutils and restart the apache server.<pre>service icinga startservice ido2db startservice httpd restart</pre> Visit http://icinga and make sure that it is currently working. '''Note:''' http://icinga should redirect to http://icinga/icinga and your localhost (which is the Amahi HDA) will show up as down. == Install Nagios Plugins ==Time to compile again!<pre>cd /usr/local/src/tar -xzf nagios-plugins-1.4.15.tar.gzcd nagios-plugins-1.4.15./configure <nowiki>--prefix=/usr/local/icinga --with-cgiurl=/icinga/cgi-bin --with-htmurl=/icinga --with-nagios-user=icinga --with-nagios-group=icinga</nowiki>makemake installservice icinga restart</pre>Now visit http://icinga/ and click on Service Detail in the menu on the left under Status. After about 5 mins everything should slowly start turning green. == Install the latest Icinga API ==Don't worry, there's nothing to compile here. But you still have to configure and install the Icinga API.<pre>cd /usr/local/src/tar -xzf icinga-api-refs-heads-master.tar.gzcd icinga-api./configure <nowiki>--datarootdir=/usr/local/icinga/share --sysconfdir=/usr/local/icinga/etc --with-command-user=icinga-cmd --with-command-group=icinga-cmd --with-icinga-user=icinga --with-icinga-group=icinga --with-web-user=apache --with-web-group=apache</nowiki>make install</pre> == Install the Icinga Web 2.0 Interface ==Create the Icinga Web db/user/pass.<pre>hda-create-db-and-user icinga_web</pre>Configure and install the new web interface.<pre>cd /usr/local/src/tar -xzf icinga-web-1.4.1.tar.gzcd icinga-web-1.4.1./configure <nowiki>--with-web-user=apache --with-web-group=apache --with-web-apache-path=/etc/httpd/conf.d</nowiki>make installmake install-apache-configmake db-initialize#Choose y for every question asked by make db-initialize</pre>Now we need to do the same thing with the virtual server as we did originally with the Icinga install so that it shows up for our Virtual Host.<pre>ls /etc/httpd/conf.d/ <nowiki>|</nowiki> grep icinga#you should see two files. Something like 1002-icinga.conf and icinga-web.confcat /etc/httpd/conf.d/icinga-web.conf >> /etc/httpd/conf.d/1002-icinga.conf#Now edit /etc/httpd/conf.d/1002-icinga.confvim /etc/httpd/conf.d/1002-icinga.conf#and move </VirtualHost> from the middle of the file to the end.#be sure to confirm that the contents of icinga-web.conf are within 1002-icinga.conf before removing itrm -f /etc/httpd/conf.d/icinga-web.conf*</pre>Restart icinga, idoutils, and apache.<pre>service icinga restartservice httpd restart</pre>Go to the webpath (http://icinga/icinga-web/) and check if the web interface starts without exceptions (database connections web and api). You can login with user 'root' and password 'password'. == Install the Icinga Mobile Interface ==Time for more source work!<pre>cd /usr/local/src/#if you want the latest then run git clone http://git.icinga.org/icinga-mobile.gitunzip icinga-mobile-0.1.0.zipcd icinga-mobileautoconf./configure <nowiki>--with-web-user=apache --with-web-group=apache --with-web-apache-path=/etc/httpd/conf.d</nowiki>make compilemake installmake install-apache-config</pre> Now we need to do the same thing with the virtual server as we did originally with the Icinga install so that it shows up for our Virtual Host.<pre>ls /etc/httpd/conf.d/ <nowiki>|</nowiki> grep icinga#you should see two files. Something like 1002-icinga.conf and icinga-mobile.confcat /etc/httpd/conf.d/icinga-mobile.conf >> /etc/httpd/conf.d/1002-icinga.conf#Now edit /etc/httpd/conf.d/1002-icinga.confvim /etc/httpd/conf.d/1002-icinga.conf#and move </VirtualHost> from the middle of the file to the end.#be sure to confirm that the contents of icinga-mobile.conf are within 1002-icinga.conf before removing itrm -f /etc/httpd/conf.d/icinga-mobile.conf*</pre>Restart icinga, idoutils, and apache.<pre>service httpd restart</pre>}}Now go to http://icinga/icinga-web and log in as root. Click on Admin > Users and Add new user. Give it the following settings.* User name: mobile* Auth via: auth_key* password: whateveryouwant (different the the Api authkey)* Authkey for Api (optional): mobileaccess* Make sure that the moble user is part of these groups: appkit_user, icinga_user* The rest of the settings you can fill in what ever you want. Now on your iPhone or Android phone visit http://icinga/icinga-mobile. After it says request failed click on config. Change the Icinga Web URL to reflect your server name. For instance my server is icinga.home so your URL should be http://icinga.home/icinga-web. Make the Auth key "mobileaccess" without quotes.=== Known Issues ===* You have to make the server for icinga-web the exact same as what you access icinga-mobile on the config page of Icinga Mobile. For security reasons cross domain AJAX requests are denied. Example if you're accessing http://xyz/icinga-mobile then Icinga Web URL must be http://xyz/icinga-web. You can change the default credentials in Icinga Mobile from the instructions in the [https://wiki.icinga.org/display/howtos/Setting+up+icinga-mobile#Settingupicinga-mobile-Changingdefaultcredentials%28optional%29 Icinga Wiki] by editing ''/usr/local/src/icinga-mobile/lib/Model/IcingaConfiguration.js''. You will have to recompile and reinstall Icinga Mobile (without running "make install-apache-config").* Icinga Mobile works neither with the desktop or mobile version of Firefox.* You may have to visit your fully qualified domain name on your mobile phone to access Icinga. For instance going to http://icinga.home/icinga-mobile instead of http://icinga/icinga-mobile because the mobile browsers will attempt to search it like icinga is a keyword for a search engine. = Overview and further Amahi integration =To get a better understanding of how Icinga works [http://www.youtube.com/watch?v=jLqhXvGTazI view this video]. So basically you have the Icinga core which runs locally on the machine. Then you access the core using the Classic Web Interface, Icinga Web 2.0, and Icinga Mobile. == Add Icinga servers to the Admin CP ==You will want to add two servers to your HDA Admin Control Panel. One for Icinga and one for IDOUtils.<pre><nowiki>echo 'Server.create(:name => "icinga", :comment => "Icinga")' | (cd /var/hda/platform/html && ./script/console production)</nowiki></pre> <pre><nowiki>echo 'Server.create(:name => "ido2db", :comment => "IDOUtils")' | (cd /var/hda/platform/html && ./script/console production)</nowiki></pre> Now go to http://hda and visit Setup > Settings > Servers and you will see Icinga and IDOUtils showing up at the bottom. == Smarter index.html ==Wouldn't it be awesome if when you visit http://icinga that it would default to the classic interface if JavaScript is disabled, default to web 2.0 interface if Javascript is enabled, or default to the mobile interface if you're visiting from a 1007mobile phone? Well you can if you configure your server right. # Browse to ''/var/hda/web-apps/icinga/html/''.# Visit my [http://sourceforge.net/projects/webtechtools/files/Javascript%20Browser%20Detect/ sourceforge project] and download the latest browser_detect.js_XXXX.# Unzip browser_detect.js to ''/var/hda/web-apps/icinga/html/''# Create /var/hda/web-apps/icinga/html/index.html with the following contents.<pre><nowiki><html><head><title>Icinga Monitoring Server</title><meta HTTP-EQUIV="REFRESH" content="1; url=/icinga/"><script type="text/javascript" src="browser_detect.js"></script><script type="text/javascript">window.top.location.href=(isMobile)?"/icinga-mobile/":"/icinga-web/";</script></head><body></body></html></nowiki></pre> = Icinga Plugins === PNP4Nagios ===== About ===This documentation is the combined effort from:* [http://docs.pnp4nagios.org/pnp-0.6/start PNP4Nagios Documentation] (click this to learn more about PNP4Nagios)* [http://docs.icinga.org/1.2.0/en/icinga-web-pnp.html Integration of PNP4Nagios into Icinga Web]=== Prerequisites ===* Icinga and all of its prerequisites.* Download latest [http://sourceforge.net/projects/pnp4nagios/files/PNP-0.6/ PNP4Nagios from sourceforge] and move it to ''/usr/local/src/''* Install the following packages<pre>yum install <nowiki>perl rrdtool rrdtool-perl</nowiki> -y</pre> === Set up PNP4Nagios ===More compiling!<pre>cd /usr/local/src/tar -xzf pnp4nagios-0.6.13.tar.gzcd pnp4nagios-0.6.13./configure <nowiki>--with-nagios-user=icinga --with-nagios-group=icinga --with-httpd-conf=/etc/httpd/conf.d</nowiki>make allmake fullinstall</pre> Change some PNP4Nagios settings<pre>sed -i 's/\/nagios\/cgi-bin/\/icinga\/cgi-bin/' /usr/local/pnp4nagios/etc/config.php</pre> Apache integration for PNP4Nagios.<pre>cd /etc/httpd/conf.d/sed -i 's/nagios\/etc\/htpasswd.users/icinga\/etc\/htpasswd.users/' pnp4nagios.conf sed -i 's/Nagios Access/Icinga Access/' pnp4nagios.confcat pnp4nagios.conf >> 1002-icinga.conf#Don't forget to move </VirtualHost> from the middle to the end of the file similar to vim 1002-icinga.confrm pnp4nagios.confservice httpd restart</pre>Visit http://icinga/pnp4nagios/ and make sure all tests pass. Then remove the install.php file.<pre>rm /usr/local/pnp4nagios/share/install.php</pre> Now enable processing performance data in Icinga. Edit icinga.conf and set ''process_performance_data=1''.<pre>vim /usr/local/icinga/etc/icinga.cfg</pre>Uncommend the following lines in /usr/local/icinga/etc/icinga.cfg.<pre>host_perfdata_command=process-host-perfdataservice_perfdata_command=process-service-perfdata}}Now create the process performance data commands (not exactsimply add them to the end of the file ''/usr/local/icinga/etc/objects/commands.cfg''){{Text|Text=<pre><nowiki>define command{ command_name process-host-perfdata command_line /usr/bin/perl /usr/local/pnp4nagios/libexec/process_perfdata.pl -d HOSTPERFDATA}define command{ command_name process-service-perfdata command_line /usr/bin/perl /usr/local/pnp4nagios/libexec/process_perfdata.pl}</nowiki><VirtualHost */pre></pre>Restart Icinga<pre>service icinga restart</pre>Now PNP4Nagios is installed. You can visit PNP4Nagios by going to http://icinga/pnp4nagios === Integrating PNP4Nagios into Icinga ===Read [http://docs.pnp4nagios.org/pnp-0.6/webfe PNP4Nagios documentation] for integrating PNP4Nagios into the Icinga Classic web interface. Read the [http:80//docs.icinga.org/1.2.0/en/icinga-web-pnp.html Icinga documentation] for integrating PNP4Nagios into the new Icinga Web 2.0 interface.==== Classic Interface ====Add the following lines to the top of ''/usr/local/icinga/etc/objects/templates.cfg''<pre><nowiki>define host{ name host-pnp action_url /pnp4nagios/index.php/graph?host=$HOSTNAME$&srv=_HOST_ register 0} define service{ name srv-pnp action_url /pnp4nagios/index.php/graph?host=$HOSTNAME$&srv=$SERVICEDESC$ register 0}</nowiki></pre>Edit /usr/local/icinga/etc/objects/templates.cfg and within the ''generic-host'' definition add the following line underneath "''name generic-host''".<pre><nowiki>use host-pnp</nowiki></pre>Edit /usr/local/icinga/etc/objects/templates.cfg and within the ''generic-service'' definition add the following line underneath "''name generic-service''".<pre><nowiki>use srv-pnp</nowiki></pre> ==== New Interface ====First make backup copies of the configuration files you need to modify.<pre>cd /usr/local/icinga-web/app/modules/Cronks/data/xml/grid/cp icinga-host-template.xml icinga-host-template.bakcp icinga-service-template.xml icinga-service-template.bak</pre>Now edit ''icinga-host-template.xml'' and right before the line ''<field name="host_info">'' add the following following field definition.<pre><nowiki><field name="pnp4nagios_host_link"><!-- datasource maps a data field from api call --><datasource><parameter name="field">HOST_NAME</parameter></datasource> <display><parameter name="visible">true</parameter><parameter name="label">Perfdata</parameter><parameter name="width">55</parameter> <parameter name="Ext.grid.Column"><parameter name="menuDisabled">true</parameter><parameter name="fixed">true</parameter></parameter> <parameter name="jsFunc"><!-- function to display column with icon in host status grid view --><parameter><parameter name="namespace">Cronk.grid.ColumnRenderer</parameter><parameter name="function">columnImage</parameter><parameter name="type">renderer</parameter> <parameter name="arguments"><parameter name="image">images/icons/application_view_gallery.png</parameter><parameter name="css">x-icinga-grid-link</parameter><parameter name="attr"><parameter name="qtip">Show host perfdata for this host</parameter></parameter></parameter></parameter> <!-- create cell click event for the previously defined column --><parameter><parameter name="namespace">Cronk.grid.IcingaColumnRenderer</parameter><parameter name="function">iFrameCronk</parameter><parameter name="type">cellclick</parameter><parameter name="arguments"><parameter name="title">Host perfdata for {host_name}</parameter><parameter name="url"><![CDATA[/pnp4nagios/index.php/graph?host={host_name}&srv=_HOST_]]></parameter><parameter name="activateOnClick">true</parameter></parameter></parameter></parameter></display> <filter><parameter name="enabled">false</parameter></filter> <order><parameter name="enabled">false</parameter></order></field></nowiki></pre>Edit ''icinga-service-template.xml'' and right before the line ''<field name="service_info">'' add the following following field definition.<pre><nowiki><field name="pnp4nagios_service_link"><!-- datasource maps a data field from api call --><datasource><parameter name="field">SERVICE_NAME</parameter></datasource> <display><parameter name="visible">true</parameter><parameter name="label">Perfdata</parameter><parameter name="width">55</parameter>
