PROCEDURE D`INSTALLATION OPENREPORTS

PROCEDURE
D'INSTALLATION
OPENREPORTS

Table des matières
Prérequis.....................................................................................................................................................2
1 Installation linux.....................................................................................................................................2
2 Installation JAVA....................................................................................................................................3
2.1 Installation de la jdk........................................................................................................................3
2.2 Configuration de l'environnement...................................................................................................3
3 Installation de ANT.................................................................................................................................3
4 Installation de tomcat..............................................................................................................................3
4.1 tomcat..............................................................................................................................................3
4.2 ajout des utilisateurs de tomcat.......................................................................................................4
5 Installation openreports...........................................................................................................................4
5.1 installation et copie des drivers.......................................................................................................4
5.2 mise à jour de la librairie hibernate.................................................................................................5
5.3 renseignement des fichiers de configuration...................................................................................5
5.3.1 configuration de hibernate.properties......................................................................................5
5.3.2 configuration de quartz.properties...........................................................................................6
5.3.3 configuration log4j.properties..................................................................................................6
5.3.4 configuration openreports.properties.......................................................................................6
5.3.5 configuration webwork.properties...........................................................................................7
5.4 Traduction de l'interface utilisation.................................................................................................7
5.5 compilation de openreports ............................................................................................................7
6 Installation de Ordesigner.......................................................................................................................8
7 Installation de iReport.............................................................................................................................8
8 Procédure de lancement..........................................................................................................................8
8.1 lancement de tomcat........................................................................................................................8
8.2 Deploiement de l'application...........................................................................................................9
Prérequis
Logiciels nécessaires
. Une distribution linux fédora core 3 (choix de l'équipe)
. Java jdk1.5.0_03
. Compilateur Ant1-6-2
. Le moteur de servlet jakarta-tomcat-5.5.9
. Pilote jdbc de oracle ojdbc14.jar
. Application web Openreports-0.9.0 ( http://www.oreports.com/ )
. Gestionnaire de la pesistance relationne/objet Hibernate-2.1.8
. Editeur de rapport Ordesigner-1.3. Il nous sert simplement de compilateur.
. Editeur de rapport iReport-0.4.1

1 Installation linux
Installez la FEDORA en configuration serveur avec les outils de développement et d'édition.
2 Installation JAVA
2.1 Installation de la jdk
Lancez un terminal
Déplacez-vous dans le répertoire où se trouve le binaire de la jdk1.5
cmd :
chmod +x jdk-1.5_0_03-linux-i586.bin //on rend le fichier exécutable
$ ./jdk-1.5_X_XX-linux-i586.bin //on exécute le programme
$ mv jdk1.5.0_03 /usr/java
2.2 Configuration de l'environnement
- Editez le fichier .bash_profile puis ajoutez les lignes:
JAVA_HOME=/usr/java/
export JAVA_HOME
- Editez le fichier /etc/profile puis ajoutez les lignes:
JAVA_HOME=/usr/java/
export JAVA_HOME
Le logiciel iReport utilise l'interpreteur java de la distribution FEDORA
Vous devez donc rediriger les liens symbolique /usr/bin/java et /usr/bin/javac vers
mv /usr/bin/java /usr/bin/java.old ; ln -s /usr/java/bin/java /usr/bin/java
mv /usr/bin/javac /usr/bin/javac.old ; ln -s /usr/java/bin/javac /usr/bin/javac
pour qu'iReport fonctionne correctement. Vous pouvez aussi placer le chemin /usr/java/bin avec celui /
usr/bin dans les variables PATH de vos environnements.
3 Installation de ANT
Lancez un terminal
Déplacez vous dans le répertoire où se trouve le tar de ANT
tappez :
su root
tar -zxvf apache-ant-1.6.3-bin.tar.gz
mkdir /usr/local/ant ; mv ./apache-ant-1.6.3/* /usr/local/ant

4 Installation de tomcat
4.1 tomcat
Déplacez vous dans le répertoire où se trouve le tar de tomcat
tappez :
su
tar -zxvf jakarta-tomcat-5.5.9.tar.gz
mkdir /usr/local/tomcat
mv ./jakarta-tomcat-5.5.9 /usr/local/tomcat
éditez le script catalina.sh
emacs /usr/local/tomcat/bin/catalina.sh
ajoutez en début de script
JAVA_HOME=/usr/java/
JAVA_OPTS=«$JAVA_OPTS -Xmx512m»
L'option -Xmx dimentionne la mémoire maximale allouée à une applet.
Attention à la conséquence sur la charge système induite par une activation
de la swap permanente (dépassement de le mémoire physique disponible).
Vous devez tenir compte de la charge parallèle du serveur et de l'espace
initial de tomcat. Dans nos tests nous voyons tomcat avec une instance mère
(le démon) de 275Mo environs et un fils de 700 Mo environs .
A vous d'ajuster votre parametre -Xmx .
4.2 ajout des utilisateurs de tomcat
su root
cd /usr/local/tomcat/conf
emacs tomcat-users.xml
-création d'un utilisateur manager
<user username=”login” password=”password” role=”manager”/>
5 Installation openreports
dans ce chapître la base de donnée dont il est question est celle nécessaire au fonctionnement interne
d'openreports. Elle contient notamment les données droits utilisateurs et descriptions de états...

5.1 installation et copie des drivers
Déplacez vous dans le répertoire où se trouve le fichier zippé openreports
tappez :
su
unzip openreports-0.9.0.zip
mv ./openreports /usr/local/
Les accès aux bases de donnée sont gérés par l'api jdbc(java database connectivity) mais il n'y a aucun
driver jdbc par défaut dans openreports.
Copiez les drivers jdbc des bases de données dans openreports.
$ cp ........./ojdbc14.jar /usr/local/openreports/webapp/WEB-INF/lib/
NB: Pensez à copier les drivers des SGBD qui seront interrogés openreports. Les drivers jdbc sont
spécifiques à chaque versions de SGBD.
5.2 mise à jour de la librairie hibernate
La bibliothèque hibernate(version 2.1.2) livrée avec openreports ne fonctionne pas avec la version
d'oracle utilisées a l'UAG. Vous devez remplacer cette librairie par une version plus récente.
Déplacez vous dans le répertoire de où se trouve le tar de hibernate
tappez :
tar -zxvf hibernate-2.1.8.tar.gz
cp -i ./hibernate-2.1/hibernate2.jar /usr/local/openreports/webapps/WEB-INF/lib/
cp -i ./hibernate-2.1/etc/hibernate.properties /usr/local/openreports/src/.
5.3 renseignement des fichiers de configuration
Dans la suite vous lirez:
$OPENREPORT_SRC_PATH pour /usr/local/openreports/
Si vous avez extrait l'archive dans /usr/local...
5.3.1 configuration de hibernate.properties
$OPENREPORT_SRC_PATH/src/hibernate.properties
Par défaut hibernate est configuré pour le SGBD HypersonicSQL.
Transformez les lignes faisant référence à HypersonicSQL en commentaire,pour cela ajoutez le