Le Blog de C-quad

BI – Installation de JasperReports sur CentOS 6

Je vous avais présenté (j’ai surtout survolé) précédemment la solution open source SpagoBI. Le monde de l’aide à la décision est massivement constitué d’outils propriétaires, mais il existe d’autres alternatives opensource. C’est le cas de la solution JasperReports qui fourni un portail web qui permettra d’héberger et de mettre à la disposition des utilisateurs de très beau rapports.

La force pour moi de JasperReports, c’est que la création des rapports y est assez simple et permet de faire le rendu que l’on désire au pixel près. Les créatifs pourront donc faire de très joli rendus.

JasperReports est produit pas une société : JasperSoft, qui propose un produit « entrée de gamme » open source qui est libre et une version plus évoluée qui elle n’est pas fournie sous licence open source.

Les versions payantes en fonction de l’option choisie permettent en autre de réaliser des requêtes ad-hoc, de gérer les accès aux rapports, de créer des dashboards, etc …

Je vous détaille ici la mise en place de la version open source disponible sur jasperforge.

Pré-requis

Tout d’abord, nous allons commencer par télécharger l’archive JasperReports-server.

J’ai choisi de prendre le war pour la simple et bonne raison, que les autres versions embarquent un serveur d’appplication ainsi que la base de données. Et je préfère utiliser les fonctionnalités de mon système d’exploitation, l’intégration n’en sera que plus propre.

Afin de pouvoir installer jasperreports, il est nécessaire d’avoir un serveur d’application ainsi qu’une base de données pour le moteur.

Nous utiliserons tomcat pour le serveur d’application et postgresql pour la base de données (tel que recommandé par jaspersoft)

 Installation et configuration de PostgreSQL

Remarque : Pour plus de détail sur l’installation de PostgreSQL, vous pouvez jeter un œil à la documentation fedora-fr sur le sujet.

Nous commençons par installer la base de données et le connecteur jdbc associé:

# yum install postgresql-server postgresql-jdbc

Une fois postgresql installé, il est nécessaire d’initialiser une base de données :

# service postgresql initdb

Si tout se passe bien vous avez pour réponse :

# Initialisation de la base de données : [ ok ]

Ensuite il est nécessaire de démarrer le service :

# service postgresql start

Si vous souhaitez que son lancement soit automatique lors du démarrage de la machine :

# chkconfig postgresql on

Nous définissions ensuite le mot de passe de l’utilisateur postgres :

# su - postgres
$ psql
postgres=# ALTER USER postgres WITH PASSWORD 'mon_password';

Et afin d’être propre nous allons créer un utilisateur spécifique pour JasperReports :

$ psql
# CREATE USER jruser;
# ALTER ROLE jruser WITH CREATEDB;
# ALTER USER jruser WITH ENCRYPTED PASSWORD 'jrpassword';

Afin de permettre la connexion à un utilisateur qui n’est pas défini sous unix, nous allons modifier la configuration de postgres en éditant le fichier /var/lib/pgsql/data/pg_hba.conf :

Modifier le fichier en remplaçant ident par md5 afin d’obtenir les lignes suivantes :

# "local" is for Unix domain socket connections only
local   all         all                               md5
# IPv4 local connections:
host    all         all         127.0.0.1/32          md5
# IPv6 local connections:
host    all         all         ::1/128               md5

Pour que les modifications prennent effet il faut redémarrer le serveur :

# service postgresql restart

Installation et configuration de Tomcat

L’installation est toujours aussi simple, il nous suffira de faire appel à yum :

# yum install tomcat6*

Il est ensuite nécessaire de définir un utilisateur qui pourra administrer tomcat, pour se faire éditer le fichier /etc/tomcat6/tomcat-users.xml et ajouter les lignes suivantes dans la section tomcat-users :

<role rolename="manager"/>
<user username="tomcat" password="tomcat" roles="manager"/>

Il est nécessaire d’ajouter le driver de connexion dans les libraires de tomcat :

# ln -s /usr/share/java/postgresql-jdbc.jar /usr/share/tomcat6/lib/

A noter : cette action sera aussi nécessaire en fonction des bases de données qui devront être accédées par vos rapports.

Nous pouvons ensuite démarrer le service tomcat6 et se connecter à l’interface d’administration. Attention pour que tomcat fonctionne il est nécessaire d’avoir un service apache fonctionnel :

# service httpd start
# service tomcat6 start
# chkconfig httpd on
# chkconfig tomcat6 on

Installation de JasperReports

Il est nécessaire dans un premier temps de décompresser l’archive téléchargée précédemment.
Puis nous allons créer un fichier default_master.properties dans le répertoire buildomatic qui contiendra :

# application server type (default is tomcat6)
appServerType = tomcat6

# Tomcat app server root dir
appServerDir = /var/lib/tomcat6

# database type
dbType=postgresql

# database location and connection settings
dbHost=localhost
dbUsername=jruser
dbPassword=jrpassword

# additional database parameters
# (uncomment these if you want non-default settings)
# dbPort=5432
# JasperServer db name, sample db names
# js.dbName=jasperserver
# sugarcrm.dbName=sugarcrm
# foodmart.dbName=foodmart

Une fois le fichier de configuration mis à jour nous pouvons tester si tout est ok pour l’installation :

# cd buildomatic
# ./js-install-ce.sh test

Si tout va bien, nous pouvons procéder à l’installation :

# ./js-install-ce.sh minimal
...
install-minimal-ce:
     [echo] Installation successfully completed!

BUILD SUCCESSFUL
Total time: 2 minutes 4 seconds
Checking Ant return code: OK

Note : Si on ne passe pas l’argument minimal, les databases de test foodmart et sugarcrm seront installées.

Afin que jaspersoft puisse fonctionner correctement, il est nécessaire qu’il puisse écrire (ses logs par exemple) dans la webapps. Nous allons spécifier que tomcat est le propriétaire de jasperserver :

# cd /usr/share/tomcat6/webapps
# chown -R tomcat:tomcat jasperserver

Bien vérifier que la connexion définie dans /usr/share/tomcat6/conf/Catalina/localhost/jasperserver.xml est correcte

Par défaut l’application est configurée avec deux comptes utilisateurs :

  • Un compte administrateur : jasperadmin avec le mot de passe jasperadmin
  • Un compte utilisateur : joeuser avec le mot de passe joeuser

Voici un aperçu de l’interface de l’administrateur :

Nous voila avec un portail JasperReports fonctionnel, il est maintenant nécessaire de créer les rapports avec le Studio de développement iReport.

3 réponses à to “BI – Installation de JasperReports sur CentOS 6”

  • C’est vrai que si je me rappelle bien, il y a un client SugarCRM pour jasper : ZuckerReport, fait par une boite allemande. Il est pas mal foutu ça donne une bonne idée d’intégration.

    ____________________________________________
    http://leadconverted.com
    Votre Spécialiste SugarCRM

  • Super tes différents article sur JasperReports !!! Hop dans mon shaarli !
    PS : j’ai enfin mis à jour ton url ^^ sur mon blog

  • VivienV:

    Bonjour,

    A la suite l’installation de JasperReports avec tomcat6 sur CentOS 6.4, je n’ai pas pu accéder à la page « http://localhost:8080/jasperserver/login.html ». Il manquait en fait le fichier tomcat-dbcp.jar dans le dossier /usr/share/tomcat6/lib/ dont tomcat a besoin pour créer la connection JasperServer.
    Il suffit simplement de télécharger le zip de tomcat-jdbc.jar à l’adresse « http://www.java2s.com/Code/Jar/t/Downloadtomcatdbcpjar.htm » puis de le copier dans le dossier /lib de tomcat.
    Autre solution à tester en renommant le fichier commons-dbcp.jar par tomcat-jdbc.jar…

    Merci pour ce tuto d’installation !

Laisser un commentaire