Icinga

Installation des Icinga-Reporting-Pakets mit JasperServer

Das Icinga-Reporting-Paket basiert auf einem IDOUtils-Backend und dem Icinga-Core.

Dies ist eine Kurzanleitung zur Installation des Icinga-Reporting mit dem JasperServer.

Voraussetzungen

Der Icinga-Core und die IDOUtils sind installiert und konfiguriert. Das Icinga-Reporting benötigt außerdem ein System mit installiertem JasperServer, sowie einen Tomcat-Server.

[Anmerkung] Anmerkung

Wenn Sie Icinga noch nicht installiert haben, folgen Sie bitte den Anweisungen in der "quickstart-idoutils"-Dokumentation.

Installation des JasperServers

Sie können das JasperServer-Installations-Binary verwenden, oder Sie nutzen das spezifische WAR-Archiv, um die Software auf einem bereits existierenden Server bereitzustellen.

Installation von Tomcat

Fedora/RHEL/CentOS/openSuSE/SLES

 #> yum install tomcat6

Debian/Ubuntu

#> apt-get install tomcat6

Installation des JasperServer CE in Ihren Tomcat Server

Nach erfolgreicher JasperServer-Installation können Sie das Interface erreichen über: http://<IhrHost>:8080/jasperserver. Melden Sie sich an mit jasperadmin/jasperadmin. Bitte ändern Sie das Passwort so schnell wie möglich.

Falls Sie irgendwelche Fehler erhalten, konsultieren Sie bitte den JasperServer Troubleshooting Guide

Download der Templates

Installation des Icinga-Reporting-Pakets

Entpacken Sie die heruntergeladene Datei und kopieren Sie diese in Ihr JasperServer-Verzeichnis.

#> tar xzvf icinga-reports-xxx.tar.gz
#> cp icinga-reports/ReportPackage/icinga_report_package.zip /opt/jasperserver/scripts/
#> cd /opt/jasperserver/scripts/

Für das Importieren des gesamten Reporting-Pakets benötigen Sie nur ein Kommando:

#> ./js-import.sh --input-zip icinga_report_package.zip

Möchten Sie ein existierendes Repository updaten, benutzen Sie bitte folgendes Kommando:

#> ./js-import.sh --input-zip icinga_report_package.zip --update

Das Icinga- Repository können Sie exportieren mit:

#> ./js-export.sh --uris /Icinga --output-zip icinga_report_package.zip
[Anmerkung] Anmerkung

Falls das Import-Skript fehlschlägt, überprüfen Sie bitte Ihre Angaben zu Benutzer und Passwort in jasperserver.xml. Sie können den Benutzer und das Passwort ändern in der Datei <jasperserver-ce-dir>/scripts/config/js.jdbc.properties.

[Anmerkung] Anmerkung

Der export-/import-Prozess ist detailliert beschrieben in Kapitel 5.12 des JasperServer CE-Install-Guide

Installieren der JAVA- Klassen für die SLA- Reports

Das automatische Generieren von monatlichen, wöchentlichen und jährlichen Reports setzt die automatische Datumsberechnung für den jeweiligen Bericht voraus. Um dieses Feature nutzen zu können, müssen Sie das icinga-reporting.jar- Archiv ( zu finden unter icinga-reports/ReportClasses/) in das lib- Verzeichnis Ihres Jasperservers installieren (kopieren). Dies sollte unter dem WEB-INF- Verzeichnis Ihrer Installation zu finden sein, z.B. /opt/jasperserver-ce-3.7.1/apache-tomcat/webapps/jasperserver/WEB-INF/lib. Bitte starten Sie nach der Installation Ihren Jasperserver neu!

Konfigurieren des Quartzscheduler

Die Verteilung der Reports erfolgt über den Quartzscheduler. Um die Absenderadresse und Ihre lokalen Gateways zu konfigurieren, editieren Sie bitte:

<tomcat_home>/webapps/jasperserver/WEB-INF/js.quartz.properties und starten Sie Ihren Tomcat neu.

service tomcat6 restart or /etc/init.d/tomcat restart

Konfigurieren der Datenbankverbindung

Einloggen auf http://localhost:8080/jasperserver mit jasperadmin/jasperadmin.

Nach erfolgreicher Paketinstallation finden Sie die Datasource hier:

/root/Icinga/datasource (stellen Sie sicher, dass Refine "changed by anyone" eingestellt ist).

- Editieren Sie die existierende Datasource und geben Sie Ihre Verbindungsparameter ein.

- Testen Sie die Konfiguration und speichern Sie die Verbindung.

- Alle Reporte in unserem Paket verwenden diese Datasource und sollten nun ausführbar sein.

[Anmerkung] Anmerkung

Denken Sie daran das Suchfeld zu ändern und setzen Sie die 4 "Dropdowns" auf die folgenden Werte um Ihre Datenquelle zu finden:

Wenn Sie nun den Suche- Button betätigen, sollten Sie die Datenquellen sehen.

Unterschiedliche Tabellen- Präfix

Falls Sie Ihren Tabellen- Präfix während der Installation geändert haben, können Sie den existierenden Präfix mit folgendem Skript ersetzen:

grep -l -r " icinga_" .  | xargs sed -i.BAK -e 's/ icinga_/ /g'
grep -l -r "icinga_" . | xargs sed -i.BAK -e 's/^icinga_//g'
find . -iname "*BAK" -exec rm -f {} \;

Known Bugs: Wenn Sie in Ihrem PDF-Export keine Graphen-Beschriftungen sehen, wechseln Sie von OpenJDK zu SUNJava.

Abbildung 9.1. Icinga-Reporting in Icinga-Web

Icinga-Reporting in Icinga-Web


Abbildung 9.2. Icinga-Reporting TOP10 in Icinga-Web

Icinga-Reporting TOP10 in Icinga-Web


[Anmerkung] Anmerkung

Die Integration in Icinga-Web ist noch nicht implementiert!

Wir geben Ihnen einige Beispiel-Reports an die Hand, ändern Sie diese gern auf Ihre Bedürfnisse :)