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.