Installation sous Linux Oracle.

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
caractères # au début de chaque ligne. Sur notre site, la base de donnée de openreports est gérée par le SGBD Oracle9i vous devez donc
“décommenter” la zone du document où sont définis les paramètres Oracle et compléter les propriétés
de connexion.Creer un user openreports dans votre instance Oracle.
## Oracle
hibernate.dialect net.sf.hibernate.dialect.Oracle9Dialect
hibernate.dialect net.sf.hibernate.dialect.OracleDialect
hibernate.connection.driver_class oracle.jdbc.driver.OracleDriver
hibernate.connection.username= login //utilisateur oracle ayant //tous les droits sur la base.
hibernate.connection.password=****** // mot de passe de l'utilisateur
hibernate.connection.url=jdbc:oracle:thin:@xxxxxxx:1521:<sid>
5.3.2 configuration de quartz.properties
$OPENREPORT_SRC_PATH/src/quartz.properties
configurer la datasource
org.quartz.dataSource.myDS.driver=oracle.jdbc.driver.OracleDriver
org.quartz.dataSource.myDS.URL=jdbc:oracle:thin:@xxxxxxxx:1521:<sid>
org.quartz.dataSource.myDS.user= login
org.quartz.dataSource.myDS.password= passwd
5.3.3 configuration log4j.properties
$OPENREPORT_SRC_PATH/src/log4j.properties
Pour une meilleur compréhension et une phase de mise au point vous pouvez configurer les
traces:
Dans la rubrique set log level mettez tous les log4l.logger à debug
5.3.4 configuration openreports.properties
$OPENREPORT_SRC_PATH/src/openreports.properties
Il vous faut un chemin de stackage des sources jasper. L'emplacement du baseDirectory n'est pas figé;
cependant vous devez vous assurer que ce répertoire existe et qu'il est possible d'y écrire.
Nous avons choisi le chemin suivant...
baseDirectory=/home/openreports Ensuite configurez le serveur smtp en modifiant la ligne suivante. Vous devez y placer un serveur smtp autorisant l'envoi de messages depuis votre serveur.
mail.smtp.host=xxxxxxx.univ­ag.fr
5.3.5 configuration webwork.properties
$OPENREPORT_SRC_PATH/src/webork.properties
Ajouter à la fin du fichier:
webwork.multipart.parser=internal
webwork.multipart.saveDir=/usr/tomcat/war­temp
webwork.multipart.maxSize=2097152
webwork.multipart.uploadToMemory=false
vérification des droits:
chmod ­R 0777 /usr/tomcat/war­temp
5.4 Traduction de l'interface utilisation
La traduction de l'interface nécessite des connaissances en html. Vous allez devoir modifier des fichiers
vm qui se trontuve dans le répertoire “/usr/local/openreport/webapp”.
Les fichiers concernés sont :
*.vm
Traduisez
les phrases entre les <strong> </sstrong>,
les expreoissn “title=name”etc...
Pour la version 0.9.0 nous avons effectuez la traduction.Remplacez les fichiers vm par ceux qui ont été
mondifiés. Pour une traduction plus fine notamment des messages d'erreurs vous devrez modifier le fichier
src/LocaStrings.properties
5.5 compilation de openreports
$ cd /usr/local/openreports
$ export ANT_HOME=/usr/local/ant $ export PATH=${PATH}:${ANT_HOME}/bin
$ ant war
$ ant schemaExporter
La commande ant war construit l'application web le fichier war généré est placé dans le répertoire
deploy de openreports(/usr/local/openreports/deploy).
La commande ant schemaExporter crée les tables de gestion des utilisateurs. Cette commande ne
fonctionnera pas si la base de donnée n'a pas été crée préalablement. Vous devez maintenant créer les tables quartz pour le gestionnaire de tâches(scheduler).
A l'aide de l'outil de votre choix,executez le script tables_oracle.sql qui se trouve dans le répertoire /usr/local/openreports/database/schema/quartz/ afin de créer les tables quartz.
6 Installation de Ordesigner
Ordesigner est un éditeur de rapport issue du projet jasperedit. Il permet de mettre en forme les
rapports.
Cependant,vous utiliserez ce logiciels uniquement pour compiler les fichiers xml que vous allez
généner avec l'éditeur iReport­0.4.1 qui est beaucoup plus évolué qu'ordesigner.
Tappez :
su
unzip ordesigner­1.2.1.zip
mv ./ordesigner /usr/local/
Pour lancer ordesigner il suffit de tapez ant run à partir du répertoire d'ordesigner.
cd /usr/local/ordesign/ ; ant run
7 Installation de iReport
iReport est l'éditeur de rapport que vous allez utilisez pour mettre en forme les rapports, il offre
beaucoup plus de fonctionnalités que ordesigner. Toutefois, le compilateur qu'intègre iReport produit
des jasper incompatibles avec openreports; il convient donc de compiler les fichiers xml obtenus avec
le compilateur de 'ordesigner'.
Allez dans le répertoire contenant iRepor t:
tappez:
tar zxvf iReport­0.4.1.tar.gz
Copiez les drivers jdbc des SGBD dans la librairie de iReport
cp ..../ojdbc14.jar /usr/local/iReport/lib/
pour lancer iReport executez le scrpit iReport.sh se trouvant dans le répertoire de iReport. 8 Procédure de lancement
8.1 lancement de tomcat
tappez:
cd /usr/local/tomcat/bin
./catalina.sh run
L'argument run permet de visualiser les logs de tomcat en temps réel.Cette commande est à utiliser lors
du premier lancement ou lorsque vous deployez une nouvelle application,elle vous permettra de
localiser d'éventuels problèmes.
Si votre serveur est totalement fonctionnel vous pouvez le lancer avec la commande ./startup.sh
8.2 Deploiement de l'application
Tapez l'url www.@ip:8080 dans un navigateur
Cliquez sur manager puis entrer les login et mots de passe définis en 4.2
Dans la rubrique WAR file to deploy allez cherchez le fichier war se trouvant à l'adresse /usr/local/openreports/deploy/ puis cliquez sur deploy.