[icinga-users] Installing the icinga-web head "skin"

c.doebler at tinxx.de c.doebler at tinxx.de
Thu Sep 17 14:49:42 CEST 2009

Hi guys,

first of all: you are BRAVE!

Since there is no installer available yet, it's not very easy to install the web frontend for the
first time.

Here is an example config. If you don't want to use the provided values (directories, database, etc.)
you have to modify the code a little bit.

Let's go:

1. move git clone to /var/www/icinga-web (in this example):
     mv icinga-web /var/www

2. check out icinga api and move it to /var/www/lib/icinga-api:
     git clone git://git.icinga.org/icinga-api.git
     mv icinga-api /var/www/icinga-web/lib/

3. change owner of web directory to http user:
     chown -R 33:33 /var/www/icinga-web

4. create database and set grants:
     create database icinga_web;
     grant all on icinga_web.* to icinga_web at localhost identified by 'icinga_web';

5. import database from the following files:

6. edit /var/www/icinga-web/app/config/databases.xml and set database credentials (block should begin at line 7):
--- SNIP ---
     <database name="appkit_default" class="AgaviDoctrineDatabase">
         <ae:parameter name="dsn">mysql://icinga_web:icinga_web@</ae:parameter>
         <ae:parameter name="username">icinga_web</ae:parameter>
         <ae:parameter name="password">icinga_web</ae:parameter>
         <ae:parameter name="charset">utf8</ae:parameter>
         <ae:parameter name="manager_attributes">
             <!-- This allows lazy loading of the models -->
             <ae:parameter name="MODEL_LOADING">CONSERVATIVE</ae:parameter>
         <ae:parameter name="load_models">%de.icinga.appkit.doctrine_model_path%</ae:parameter>
--- SNIP ---

7. edit /var/www/icinga-web/app/config/icinga.xml and set database credentials to give access to ido-db (block should 
begin at line 163):
--- SNIP ---
     <parameter name="IcingaData">
         <parameter name="class">IcingaData</parameter>
         <parameter name="api_file">%core.root_dir%/lib/icinga-api/IcingaApi.php</parameter>
         <parameter name="api_type">IcingaApi::CONNECTION_IDO</parameter>
         <parameter name="config_type">mysql</parameter>
         <parameter name="config_host"></parameter>

         <parameter name="config_port">3306</parameter>
         <parameter name="config_database">icinga</parameter>

         <parameter name="config_user">icinga</parameter>
         <parameter name="config_password">icinga</parameter>

         <parameter name="config_table_prefix">icinga_</parameter>
--- SNIP ---

8. set up a virtual host:
--- SNIP ---
<VirtualHost *:80>

         ServerName icinga-web

         DocumentRoot /var/www/icinga-web/pub/

         DirectoryIndex index.php

         <Directory /var/www/icinga-web/pub/>
         Options -MultiViews -Indexes +FollowSymLinks
         AllowOverride none
         Order allow,deny
         Allow from all

         <IfModule mod_rewrite.c>
                 RewriteEngine On
                         RewriteBase /

                         # If the requested URL does not exist (it's likely an agavi route),
                         # pass it as path info to index.php, the Agavi dispatch script.
                         RewriteRule ^$ index.php?/ [QSA,L]
                         RewriteCond %{REQUEST_FILENAME} !-f
                         RewriteCond %{REQUEST_FILENAME} !-d
                         RewriteRule (.*) index.php?/$1 [QSA,L]


     # deny something!
     <Location />
         Options -MultiViews -Indexes +FollowSymLinks
         Order allow,deny
         Allow from all

     # JS frameworks
     Alias /js/yui               /var/www/icinga-web/lib/yui
     Alias /js/swfobject         /var/www/icinga-web/lib/swfobject
     Alias /js/mootools          /var/www/icinga-web/lib/mootools
     Alias /js/jquery            /var/www/icinga-web/lib/jquery
     Alias /js/appkit            /var/www/icinga-web/lib/appkit/js
     Alias /js/gc-prettify       /var/www/icinga-web/lib/gc-prettify
     Alias /js/firebug           /var/www/icinga-web/lib/firebug
     Alias /js/ext3              /var/www/icinga-web/lib/ext3

     # Flash frameworks
     Alias /flash/flexchart      /var/www/icinga-web/lib/flexchart

         <IfDefine APACHE2>
                 AcceptPathInfo On

--- SNIP ---

9. clear cache
     rm /var/www/icinga-web/app/cache/config/*.php

10. reload your web server config

I hope that's it. Please don't punish if there's something missing or wrong!



Christoph Maser schrieb:
> Am Donnerstag, den 17.09.2009, 12:58 +0200 schrieb Assaf flatto:
>> Hello all
>> I just downloaded the icinga-web-HEAD tar and am trying to have that
>> installed on my test icinga platform , but i must admit that i am abit
>> lost on how to get it up and running.
>> I hoped to find some info in the /doc directory , but there was
>> nothing there .
>> Has anyone tried to install it ?
>> Thanks
>> Assaf
> Funny I had just the same question coming up..
> Chris
> financial.com AG
> Munich head office/Hauptsitz München: Maria-Probst-Str. 19 | 80939 München | Germany
> Frankfurt branch office/Niederlassung Frankfurt: Messeturm | Friedrich-Ebert-Anlage 49 | 60327 Frankfurt | Germany
> Management board/Vorstand: Dr. Steffen Boehnert (CEO/Vorsitzender) | Dr. Alexis Eisenhofer | Dr. Yann Samson | Matthias Wiederwach
> Supervisory board/Aufsichtsrat: Dr. Dr. Ernst zur Linden (chairman/Vorsitzender)
> Register court/Handelsregister: Munich – HRB 128 972 | Sales tax ID number/St.Nr.: DE205 370 553
> ------------------------------------------------------------------------------
> Come build with us! The BlackBerry® Developer Conference in SF, CA
> is the only developer event you need to attend this year. Jumpstart your
> developing skills, take BlackBerry mobile applications to market and stay 
> ahead of the curve. Join us from November 9-12, 2009. Register now!
> http://p.sf.net/sfu/devconf
> _______________________________________________
> icinga-users mailing list
> icinga-users at lists.sourceforge.net
> https://lists.sourceforge.net/lists/listinfo/icinga-users

More information about the icinga-users mailing list