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 |
---|---|
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 über das Binary
Nutzen Sie den JasperServer-ce-linux-installer, angeboten über: Sourceforge mit bereits enthaltener MySQL-Database und Tomcat Server. Die Ausführung des Binaries leitet Sie durch den Installationsprozess.
Installation des WAR-Archives
Sie können das JasperServer-CE WAR in einen bestehenden Tomcat6 Server integrieren und Ihre bereits angelegte Icinga Datenbank benutzen. Hier wird die WAR-Installation in einen Tomcat6 Server beschreiben. Die offizielle JasperServer-Installationsanleitung finden Sie hier.
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
Download von jasperserver-ce-x.x.x-bin.zip von Sourceforge/Jasper
Folgen Sie der Installationsdokumentation veröffentlicht auf Sourceforge/Jasper (JasperServer-CE-Install-Guide.pdf)
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
Download des Icinga-Reporting-Pakets von Sourceforge/Icinga
Oder Benutzen des GIT: Sie können alle Templates und die aktuellen Servletimplementationen herunterladen von: git://git.icinga.org/icinga-reports.git/.
Laden Sie Ihren Klone von icinga-reports.git
#> git clone git://git.icinga.org/icinga-reports.git
Oder Download der Software von https://git.icinga.org/index?p=icinga-reports.git;a=snapshot;h=refs/heads/master;sf=tgz.
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 |
---|---|
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 |
---|---|
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 |
---|---|
Denken Sie daran das Suchfeld zu ändern und setzen Sie die 4 "Dropdowns" auf die folgenden Werte um Ihre Datenquelle zu finden: |
"Changed by anyone" (wie bereits oben erwähnt)
"All"
"Any time"
"Any schedule"
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.
![]() |
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 :)
© 2009-2011 Icinga Development Team, http://www.icinga.org