9.5. Installation of the Icinga-Reporting with JasperReports Server
Prev | Chapter 9. Integration With Other Software | Next

## 9.5. Installation of the Icinga-Reporting with JasperReports Server

### 9.5.1. Introduction

The Icinga-Reporting is based on the IDOUtils backend and just like the Icinga-Core, it will support all major database platforms.

Here we'll give you some instructions on how to install the Icinga-Reporting with JasperReports Server.

### 9.5.2. Official Docs

For more information, please refer to http://sourceforge.net/projects/jasperserver/files/JasperServer/JasperServer%204.7.0/JasperReports-Server-CP-Install-Guide.pdf or http://jasperforge.org/espdocs/espbrowse.php?id=86&type=folder&group_id=112&parent=86

### 9.5.3. Requirements

- Icinga and IDOUtils

  Installed via sources or packages.

  | Note
  Starting with Icinga 1.8 there is a database function providing all needed sla-informations. This function needs to be imported into your existing IDOUtils database additional to the Icinga-Reporting package.

  MySQL

      #> /usr/bin/mysql icinga < icinga-reports-1.8.0/sql/mysql/icinga_availability.sql

  Please make sure your database user (here icinga@localhost) has the correct GRANT for EXECUTE.

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

- Apache Tomcat

  Only if you don't want to use the bundled one from JasperServer

       #> apt-get install tomcat6

- PostgreSQL

  Only if you don't want to use the bundled one from JasperServer. PostgreSQL is required for JasperServer's internal storage.

  | Note
  JasperServer changed their backend from MySQL to PostgreSQL in 4.2.1! Source

- JasperReports Server

  | Note
  The new JasperReports Server 4.7.0 is only supported starting with Icinga-Reporting 1.8. If you want to use an older version of the Icinga-Reporting- package, please use JasperReports Server 4.5.0 or older.

  Depending on your architecture (`uname -a`), fetch the appropriate installer - below is x64

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

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

  - Agree to license

  - select bundled tomcat

  - select bundled postgresql

    - select a different postgresql port, like 5433, not to interfere with existing setups

  - install sample reports and ireports

  The installer will automatically create the needed database, create the schema and install samples.

  | Note
  The default installation location will be /opt/jasperreports-server-cp-4.7.0/, so make sure to work on the correct JasperReports Server if you are doing an upgarde!

  Start

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

  For individual components

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

### 9.5.4. Icinga Reporting

As from Icinga 1.6 on, the package provides configure and make scripts.

- Sources

  Download from sourceforge and extract. If you have an issue which might be solved in the developer version then get the latest developer snapshot from git

       $> wget http://sourceforge.net/projects/icinga/files/icinga-reporting/1.8.0/icinga-reports-1.8.0.tar.gz; \
          tar xzf icinga-reports-1.8.0.tar.gz; \
          cd icinga-reports-1.8.0

  or

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

  If a developer told you to use his/her branch, check that out with

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

- Configure

  If you did not install the JasperReports Server into the default prefix before, you need to tell configure the location.

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

- Make

  Invoke 'make' without params to get a full list of available options.

  - MySQL Connector

    JasperReports Server natively ships with the PostgreSQL Connector, but if you require MySQL, the Icinga-Reporting package provides one for install.

         #> make install-mysql-connector

    Restart the Tomcat server

         #> cd /opt/jasperreports-server-cp-4.7.0
         #> ./ctlscript.sh stop tomcat
         #> ./ctlscript.sh start tomcat

  - Install

    JasperReports Server must be running!

         #> make install

    Restart the Tomcat server

         #> cd /opt/jasperreports-server-cp-4.7.0
         #> ./ctlscript.sh stop tomcat
         #> ./ctlscript.sh start tomcat

### 9.5.5. Configuration

Open the webinterface, default credentials are jasperadmin:jasperadmin

`http://127.0.0.1:8080/jasperserver`

- IDO

  Go to `/root/Icinga/datasource` (be sure that Refine contains "changed by anyone").

  Figure 9.1. Icinga reporting datasource IDO

  Figure 9.2. Icinga reporting datasource ido mysql

  - edit the existing datasource and configure your values. MySQL driver: com.mysql.jdbc.Driver MySQL URL: jdbc:mysql://localhost:3306/icinga

  - test the configuration and save the connection.

  - all reports in our package point to this datasource and should be able to run.

### 9.5.6. Reports

Verify that the reports are available and working.

Figure 9.3. Icinga reporting

### 9.5.7. Errors

- Display Errors

       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.

  The tomcat being run as root, trying to access the users x11 display. Allow it for everyone locally.

       $> xhost +local:all

- Generation Errors

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

  It could be Sun AWT trying to connect to X11 classes, but actually it's the PDF generation on a report.

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

Prev | Up | Next
9.4. MKLiveStatus Integration | Home | Chapter 10. Additional software

© 2009-2012 Icinga Development Team, http://www.icinga.org