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>
