Icinga und IDOUtils

Installiert wie in den Schnellstartanleitungen beschrieben, entweder über die Sourcen oder über Distributionspakete

	Anmerkung
	Ab Icinga 1.8 gibt es eine Funktion in der Datenbank die alle benötigten SLA- Informationen bereitstellt. Diese Funktion muss zusätzlich zu dem Report- Paket zu in die bestehende IDOUtils Datenbank importiert werden.

MySQL

#> /usr/bin/mysql icinga < icinga-reports-1.10.0/db/icinga/mysql/availability.sql

Stellen Sie bitte ebenfalls sicher, dass der Datenbank- Benutzer (hier icinga@localhost) das Recht EXECUTE besitzt.

#> /usr/bin/mysql -u root -p <password> icinga
mysql> GRANT EXECUTE ON icinga.* TO 'icinga'@'localhost' ;
quit

Apache Tomcat

Nur falls Sie nicht den mit JasperReports Server gebündelten Tomcat benutzen möchten.

 #> apt-get install tomcat6

PostgreSQL

Nur falls Sie nicht das mit JasperServer gebündelte PostgreSQL benutzen möchten. PostgreSQL ist für die JasperReports Server interne Speicherung erforderlich.

	Anmerkung
	Das Backend von JasperReports Server wurde ab Version 4.2.1 von MySQL nach PostgreSQL geändert! Source

JasperReports Server

	Anmerkung
	JasperReports Server 5.0.0 wird erst ab Icinga Reporting 1.9 unterstützt! Für die Installation Version des Icinga Reporting- Paketes < 1.9 , nutzen Sie bitte mindestens JasperReports Server 4.5.0.

Abhängig von Ihrer Architektur (uname -a) holen Sie sich den entsprechenden Installer - hier im Beispiel x64

 $> wget http://sourceforge.net/projects/jasperserver/files/JasperServer/JasperServer%205.0.0/jasperreports-server-cp-5.0.0-linux-x64-installer.run

 $> chmod +x jasperreports-server-cp-5.0.0-linux-x64-installer.run
 $> sudo ./jasperreports-server-cp-5.0.0-linux-x64-installer.run

Der Installer wird automatisch die benötigte Datenbank und das Schema anlegen und die Beispiele installieren.

	Anmerkung
	Die standardmäßig wird JasperReports Server nach /opt/jasperreports-server-cp-5.0.0/ installiert. Wenn Sie den JasperReports Server aktualisieren, versichern Sie sich mit der richtigen Version zu arbeiten!

Start

 #> cd /opt/jasperreports-server-cp-5.0.0/
 #> ./ctlscript.sh start

Für einzelne Komponenten

 #> ./ctlscript.sh postgresql start|stop
 #> ./ctlscript.sh tomcat start|stop

Sourcen

Laden Sie das Paket herunter und entpacken es. Falls Sie ein Problem haben, das ggf. in der Entwickerversion gelöst ist, dann holen Sie sich den aktuellen Entwickler-Snapshot aus git

 $> wget https://github.com/Icinga/icinga-reports/releases/download/v1.10.0/icinga-reports-1.10.0.tar.gz; \
    tar xzf icinga-reports-1.10.0.tar.gz; \
    cd icinga-reports-1.10.0

oder

 $> git clone git://git.icinga.org/icinga-reports.git ; \
    cd icinga-reports

Falls ein Entwickler Sie gebeten hat, ihren/seinen Branch zu benutzen, dann benutzen Sie

 $> git branch localbranch origin/devhead/devbranch
 $> git checkout localbranch
 $> git log

Konfigurieren

Falls Sie den JasperReports Server vorher nicht mit dem Default-Präfix installiert haben, dann müssen Sie configure den Standort mitteilen.

 $> ./configure --with-jasper-server=/opt/jasperreports-server-cp-5.0.0

Make

Rufen Sie 'make' ohne Parameter auf, um eine komplette Liste der verfügbaren Optionen zu erhalten.

IDO

Gehen Sie nach /root/Icinga/datasource (stellen Sie sicher, dass Refine den Wert "changed by anyone" enthält).

Abbildung 9.1. Icinga reporting datasource ido mysql

Anzeigefehler

 org.springframework.web.util.NestedServletException: Handler processing failed; 
 nested exception is java.lang.InternalError:
 Can't connect to X11 window server using ':0' as the value of the DISPLAY variable.

Der Tomcat läuft als root und versucht, auf das X11-Display des Benutzers zuzugreifen. Erlauben Sie es für jeden lokalen Benutzer.

 $> xhost +local:all

Generierungsfehler

 org.springframework.web.util.NestedServletException: Handler processing failed;
 nested exception is java.lang.NoClassDefFoundError:
 Could not initialize class net.sf.jasperreports.engine.util.JRStyledTextParser

Es könnte Sun AWT sein, das versucht, auf X11-Klassen zuzugreifen, aber tatsächlich ist es die PDF-Generierung für einen Report.

 $> sudo apt-get install msttcorefonts
 $> cd /opt/jasperreports-server-cp-5.0.0
 $> sudo sh ctlscript.sh stop
 $> sudo sh ctlscript.sh start