Pour rappel BIRT Viewer est le composant serveur de diffusion de rapport. Il permet de distribuer les rapports créés avec BIRT Designer aux utilisateurs via internet.

J’utilise une centos 5.3 pour les tests (un équivalent de rhel 5.3).

Ce que nous allons réaliser dans ce how-to :

• Installer BIRT Viewer 2.5 sur Red Hat Enterprise Server
• Monter le viewer de manière « transparente » en reverse proxy via le module proxy de Apache
• Installer des drivers JDBC supplémentaires

Composants à télécharger :

Télécharger BIRT Runtime

• BIRT Runtime : http://www.eclipse.org/…/birt-runtime-2_5_0.zip
• Driver JDBC pour Mysql : http://dev.mysql.com/downloads/connector/j/5.1.html

Installer Tomcat

Installer Tomcat

Je sélectionne les paquets tomcat 5.5, tomcat 5.5 admin et tomcat 5.5 webapps (bien entendu vous pouvez utiliser Yum, mais restons « basique »). Le système va gérer les dépendances pour moi.

Paquets sélectionnés pour Tomcat

Tomcat est maintenant installé, nous pouvons passer à BIRT.

Déployer BIRT Viewer

Pour celà, une simple copie de birt.war vers /var/lib/tomcat5/webapps est suffisante.

Copier le fichier birt.war

Une fois l’opération réalisée, nous pouvons relancer Tomcat. Pour cette opération, j’utilise l’outil système « services » de la distribution. Une fois cette opération réalisée, un répertoire birt devrait apparaître dans votre répertoire webapps.

On lance Tomcat au démarrage du système

Nous allons tester le bon fonctionnement de BIRT en l’appelant via le navigateur : http://<mon_serveur>:8080/birt

Test de fonctionnement

Configurer le reverse proxy de Apache

Ajoutez ceci dans votre httpd.conf :

ProxyRequests Off
<Location /birt >
ProxyPass        ajp://127.0.0.1:8009/birt
ProxyPassReverse ajp://127.0.0.1:8009/birt
</Location>

Puis relancez apache.

Nous allons tester tout ceci une dernière fois en essayant d’accéder à BIRT Viewer via apache : http://<mon_serveur>/birt

Accéder au Viewer via le port 80

Cette méthode d’installation ne nécessite que quelques minutes de plus, et offre l’avantage de ne pas ouvrir le port 8080 pour accéder au Viewer.

Installer le driver JDBC pour Mysql

Encore une fois, l’opération est très simple. Dézippez l’archive du driver, puis copiez simplement le fichier mysql-connector-java-5.1.7-bin dans le répertoire /var/lib/tomcat5/webapps/birt/WEB-INF/platform/plugins/org.eclipse.birt.report.data.oda.jdbc_2.5.0.v20090605/drivers et le tour est joué.

Effectuez la même opération pour tous vos drivers JDBC (sauf exception).

Vous pouvez maintenant déployer vos rapports dans le répertoire /var/lib/tomcat5/webapps/birt/<un répertoire de stockage pour les rapports à diffuser aux utilisateurs>