Auf ein paar Nachfragen hin, hier ein kurzes HowTo um das DokuWiki von Splitbrain in ICINGA zu integrieren.

Keine Angst, es wird nicht so ein Martyrium wie die Installation von NAGVIS und ICINGA :) Oder gar mit Mysteriösen Erweiterungen wie es auf einigen anderen Seiten im www beschrieben ist. Ich bin da doch eher pragmatisch.

Voraussetzungen

Wenn man sich an die Installationsanleitung gehalten hat, sollten Apache und ICINGA schon ihre Dienste verrichten. Wir installieren das DokuWiki auf den ICINGA Server (192.168.1.1). Also können wir sofort loslegen.

# sudo su
# cd /var/www
# wget http://www.splitbrain.org/_media/projects/dokuwiki/dokuwiki-2013-05-10.tgz

Wie in den anderen HowTos auch, prüft die aktuelle Version des DokuWikis! Und weiter gehts.

# tar xvfz dokuwiki-2013-05-10.tgz
# mv dokuwiki-2013-05-10 dokuwiki
# chown -c www-data:www-data dokuwiki/ -R

Jetzt via Browser das DokuWiki installieren http://192.168.1.1/dokuwiki/install.php. Nachdem das DokuWiki installiert ist, können wir es bei den Hosts auf ICINGA nutzen.

Einbinden in ICINGA

Unsere Host Konfigurationen liegen unter /etc/icinga/objects. Im letzten Beispiel haben wir als externen Server den server2.cfg angelegt. Diesen werden wir jetzt für DokuWiki nutzen.

# vim /etc/icinga/objects/server2.cfg

Jetzt wird es richtig kompliziert … Wir suchen die Stelle

define host{
       use generic-host
       host_name server2.local
       alias server2
       address 192.168.1.2
}
define service{
       use generic-service
       host_name server2.local
       service_description PING
       check_command check_ping!100.0,20%!500.0,60%
}

und passen diese wie folgt an

define host{
       use generic-host
       host_name server2.local
       alias server2
       address 192.168.1.2
}
define hostextinfo{
            host_name         server2.local
            notes_url         http://192.168.1.1/dokuwiki/server/icinga/server2.local
}
define service{
       use generic-service
       host_name server2.local
       service_description PING
       check_command check_ping!100.0,20%!500.0,60%
}

Jetzt noch schnell speichern und ICINGA neu starten

# /etc/init.d/icinga restart

Und man hat ein Ordnersymbol neben seinem Host welches auf das Wiki verweist :)

Anmerkung

In der notes_url habe ich / als Trenner der URL. Dafür muss im DokuWiki URL rewrite aktiv sein. Bei einer Standard Installation des Apache unter Ubuntu 12 LTS gibt es jedoch einen Bug. Durch diesen funktioniert Dokuwiki mit der .htaccess nicht. Dies lässt sich aber schnell beheben. Öffne die default Seite das Apache

# vim /etc/apache2/sites-enabled/000-default

und ersetze alle AllowOverride none mit AllowOverride all.

:%s/AllowOverride none/AllowOverride all/g

Das ganze sollte dann wie folgt aussehen.

<VirtualHost *:80>
	ServerAdmin webmaster@localhost

	DocumentRoot /var/www
	<Directory />
		Options FollowSymLinks
		AllowOverride all
	</Directory>
	<Directory /var/www/>
		Options Indexes FollowSymLinks MultiViews
		AllowOverride all
		Order allow,deny
		allow from all
	</Directory>

	ScriptAlias /cgi-bin/ /usr/lib/cgi-bin/
	<Directory "/usr/lib/cgi-bin">
		AllowOverride all
		Options +ExecCGI -MultiViews +SymLinksIfOwnerMatch
		Order allow,deny
		Allow from all
	</Directory>

	ErrorLog ${APACHE_LOG_DIR}/error.log

	# Possible values include: debug, info, notice, warn, error, crit,
	# alert, emerg.
	LogLevel warn

	CustomLog ${APACHE_LOG_DIR}/access.log combined

    Alias /doc/ "/usr/share/doc/"
    <Directory "/usr/share/doc/">
        Options Indexes MultiViews FollowSymLinks
        AllowOverride all
        Order deny,allow
        Deny from all
        Allow from 127.0.0.0/255.0.0.0 ::1/128
    </Directory>

</VirtualHost>

einmal den Apache neu starten und die schönen URLs funktionieren.

# /etc/init.d/apache2 restart

 Nachtrag

Auch hier sei wieder erwähnt das Kommentare erwünscht sind :)