Réalisé par :
Meryem AZAZ Soumia BRABIJE
Année de réalisation :
2012/2013
Guide d’installation et de configurationOpenbravo / Eclipse
2
Sommaire
Introduction........................................................................................................3
Installation et configuration d’OpenBravo.........................................................4
1. SGBD PostgreSql:...................................................................................................4
2. Installation JDK......................................................................................................5
3. Installation Tomcat Apache:...................................................................................5
4. Installation de Mercurial:.......................................................................................6
5. Clonage du Code Source OpenBravo :...................................................................6
6. Intégration de Mercurial dans Eclipse:..................................................................7
7. Configuration d’OpenBravo :..................................................................................8
Développement avec OpenBravo.........................................................................9
1. L’environnement de développement Openbravo:...................................................9
2. Préparation de l’environnement de développement (Eclipse IDE):.....................10
2.1. Eclipse Workbench:........................................................................................10
2.2. Eclipse Workspace:........................................................................................10
3. Extraire le code Openbravo ERP :........................................................................13
4. Définir le Server Tomcat:.....................................................................................14
5. Compiler et lancer le projet :...............................................................................16
Conclusion.........................................................................................................19
3
Introduction
Avant de commencer le développement avancé sous Openbravo ERP nous avons
besoins d’installer quelques éléments pour assurer le bon fonctionnement de notre
système.
Le présent document décrit les différentes étapes d’installation et de configuration des
différents outils utilisés notamment Eclipse, est suit l’organisation suivante :
1ere partie :
Dans cette première partie vous trouverez les différentes étapes d’installation – à
suivre - des différents outils nécessaires au bon fonctionnement d’Openbravo.
2eme partie :
Dans cette deuxième partie vous trouverez la configuration détaillée de l’IDE Eclipse
pour assurer une bonne intégration du code.
Avant de commencer voici la liste des outils dont on aura besoin pour effectuer ce
travail :
SGBD PstgreSql
Sun Java Development Kit ‘JDK’
Apche Ant
Apache server
Connector Tomcat-apache
Mercurial
Et biensur
Eclipse
Openbravo
Le système utilisé doit avoir au minimum 1 GB de mémoire disponible.
4
5
Installation et configurationd’OpenBravo
Le schéma suivant illustre les différentes étapes que nous avons suivies pour installer et configurer correctement (sous une VM : la Virtual Box d’Oracle) notre ERP :
1. SGBD PostgreSql:
Sur le site Officiel de PostgreSql ‘http://www.postgresql.org/download/’, vous aurez la main pour télécharger le fichier binaire dédié pour Windows afin d’installer le SGBD, puis suivez l’assistante d’installation.
Ensuite, pour faire fonctionner PostgreSql, on doit télécharger le fichier ‘uuid.lib’ à travers le lien suivant http://winpg.jp/~saito/pg_work/OSSP_win32/.
6
Ce fichier contient des fonctions et des algorithmes standards permettant de générer des identifiants uniques et doit être ajouté au répertoire lib de PostgreSql que l’on va relancer afin que ce fichier soit pris en considération.
2. Installation JDK
Ensuite, nous allons installer la dernière version du JDK (Sun Java Development Kit (JDK 7.0)) et ajouter les variables d’environnement nécessaires.
3. Installation Tomcat Apache:
Les différents outils dont on aura besoin sont : (dernière version de préférence)
- Apache Tomcat : http://tomcat.apache.org/download-60.cgi, une fois
installé il faut ajouter les variables d’environnement suivantes:
7
CATALINA_HOME, CATALINA_BASE et CATALINA_OPTS de la
même manière que les variables d’environnement Java.
- Apache Ant : http://archive.apache.org/dist/ant/binaries/ , la version
1.7.x est la plus compatible avec OpenBravo.
- Apache server httpd : disponible sous sa dernière version sur le
http://httpd.apache.org/download.cgi#apache24, il suffit ensuite de
suivre l’assistance d’installation graphique, et pour vérifier que
l’installation s’est bien déroulée, on tape dans le browser: localhost, et
on doit avoir affiché le message « It Works ! »
- Conncector Tomcat-Apache : disponible sur
http://tomcat.apache.org/download-connectors.cgi sous sa dernière
version, une fois téléchargé, il faut :
Insérer le fichier mod_jk.so dans le répertoire « modules »
d’Apache.
Modifier le fichier «httpd.conf » d’Apache pour déclarer les
fichiers relatifs à ‘mod_jk’.
4. Installation de Mercurial:
Mercurial est un système de gestion de versions permettant en particulier la gestion
de version décentralisée, s'utilise via des lignes de commandes commençant par « hg »
en référence au symbole chimique
du mercure. Mercurial permet de
récupérer n'importe quelle version
de fichier que vous avez sauvegardé
! Et si vous naviguez souvent entre
plusieurs machines, vous pouvez
synchroniser tout votre
développement sans vous demander
où se trouve la dernière version à jour de votre logiciel !
Comme tout logiciel, il est d'usage de l'installer et le configurer avant de l'utiliser pour
pouvoir cloner le code source (presque 600 MB de taille). Il suffit de suivre les étapes
suivantes :
8
Allez à l'adresse suivante :
http://mercurial.selenic.com/ download puis téléchargez Mercurial pour
Windows
(dernier lien).
Une fois téléchargé, il suffit de double cliquer pour installer en suivant l’assistante
d’installation graphique.
5. Clonage du Code Source OpenBravo :
Après installation du Mercurial, il nous est possible maintenant de cloner le code
source d’OpenBravo, pour faire suivez les étapes suivantes :
- Lancer l’invite de Commande en mode Administrateur ‘cmd’.
- Taper la commande suivante:
hg clone http://code.OpenBravo .com/erp/devel/main OpenBravo
http://code.OpenBravo .com/erp/devel/main : est le chemin relatif à la location du code
source.
OpenBravo : est le nom du répertoire destination dans lequel le code sera copié.
6. Intégration de Mercurial dans Eclipse:
Pour Eclipse le plugin existe et est utilisable à partir de la version 3.3 d’Eclipse. Pour
une intégration réussie il suffit de suivre les étapes suivantes :
9
- Tout d'abords allez dans le menu "Help" puis dans "Install New
Software" puis dans la fenêtre qui s'ouvre cliquez sur "Add" Puis
ajoutez ceci :
Nom: Vectrace (Mercurial Eclipse plugin)
URL: http://www.vectrace.com/eclipse-update/
7. Configuration d’OpenBravo :
Exécuter setup-properties-windows.exe, le wizard graphique de configuration vous guidera lors de la configuration d’OpenBravo en passant par :
- Le mode d’installation : Standard puisque la base de données et le
server sont sur la même machine.
- Le type d’installation : Development puisque nous allons utiliser le code
source.
- Spécifier l’emplacement du JDK, du AntExcutor et d’apache-tomcat.
- Le type de la SGBD : PostgreSql
- Spécifier l’emplacement de la BDD et les paramètres d’accès définis
précédemment afin de créer la base de données à partir des
fichiers .xml
Maintenant nous sommes capables d’accéder à OpenBravo à partir de
http://Localhost:8080/OpenBravo dans le navigateur web.
10
Développement avec OpenBravo
1. L’environnement de développement Openbravo:
Openbravo est une pure application web construite suivant le modèle MVC. La plupart
du code est généré automatiquement sur la base du MDD (Model Driven Development)
par un moteur que nous appelons WAD. Le moteur exécute et recompile l'application à
chaque fois que l'administrateur système modifie la configuration sur une demande
utilisateur. Cela exécute une création et une recompilation des fichiers pour les
différentes composantes du modèle MVC que montre la figure ci-dessous:
Modèle: xsql fichiers exécutables SQL.
Vue: des fichiers HTML et XML de définition de la disposition des
formulaires et de définition de la relation avec les données.
Control: java Servet pour définir les actions à exécuter, gérer et générer le
modèle de la vue.
L’ODE est composé de:
– Tools (Eclipse, SVN, etc)– Méthodologies (source control, Development cycle, etc.)
• Le MDD (Model Driven Development) permet:
– Séparer le Design de l’ARCHITECTURE/PLATFORM
– Qualité élevée du code (drastic REDUCTION OF MANUAL CODE)
– Une PRODUCTIVITE ET EFFICACITE élevées.
• Le MVC Model (Model, View, Control) permet:
– Le DE-COUPLAGE des zones de développement.
– Une MAINTENANCE FACILE du code
Principaux avantagesL’environnement de développement
11
– Processes (sequences)
Nous l’utilisons pour rendre les tâches suivantes plus efficaces :
– Editer/naviguer/contrôler le code source.– Debugger– Tester– Déployer
ODE supporte Oracle and PostgreSql comme base de données.
2. Préparation de l’environnement de développement (Eclipse IDE):
1.1. Eclipse Workbench:
Télécharger le fichier workbench.xml et copier le dans le repertoire siuvant:
votre_workspace/.metadat/.plugins/.org.eclipse.ui.workbench.
1.2. Eclipse Workspace:
L’étape suivante va nous permettre de régler les préférences standards utilisées lors
du développement d’Openbravo, pour celà il suffit de suivre les étapes suivantes pour
télécharger le fichier de préférences adéquat.
Cliquer sur File > Import > Général > Preferences et cliquer sur le bouton
Next.
12
Rendez vous sur le fichier openbravo-eclipse-prefs.epf, sélectionnez ‘Import all’ puis cliquez sur terminer.
Maintenant pour copier les fichiers stax-api-1.0.1.jar et wstx-asl-3.0.2.jar du
répértoire Ant_ lib, il suffit d’aller sur : Window > Preferences > Ant > Runtime >
Ant Home Entries (Default) > Add External JARs > Ajouter stax-api-1.0.1.jar et
wstx-asl-3.0.2.jar.
Puis Window >
Preferences >Validation :
cochez ‘Suspend all
validator’ et décochez le
reste.
13
Puis Window > Preferences > Java > compiler : verifier qu’il s’agit de la version
1.6
Toujours sur Window > Preferences > Général > content Type > Text > XML > bouton ‘Add’ puis associer les types suivant à l’éditeur XML :
- *.xsql- *.jrxml- *.fo
14
Finalement et pour éviter les problèmes d’encodage mettez ‘Text File Encoding’ à
UTF-8 et ‘New text file delimiter’ à Windows ceci en vous rendant sur Window >
Preferences > Général > Workspace.
3. Extraire le code Openbravo ERP :
Nous aurons besoin des projets suivants dans notre espace de travail avant la
compilation :
- Openbravo
- OpenbravoCore
- OpenbravoWAD
- OpenbravoTrl
Noter bien que l’ordre d’import de ces répertoires est important.
Openbravo :
Ce projet contient l’ERP Openbravo lui-même: forms, reports, windows … etc.
Pour importer ce projet il suffit d’aller à : File > Import > Général > Existing
projects into workspace puis cliquer sur le bouton Next.
Browser vers le répertoire en question et cliquer sur OK, vérifier que le répertoire est
sélectionné puis cliquer sur terminer.
15
Suivez les mêmes étapes pour importer les autres projets en respectant l’ordre cité précédemment à savoir OpenbravoCore, OpenbravoWAD et OpenbravoTrl.
4. Définir le Server Tomcat:
Une fois avoir importé les projets cités auparavant, nous allons maintenant définir le server pour visualiser les résultats obtenus.
Faites un click droit sur Server tab > new server > tomcat 6.0
16
À cette étape nous allons spécifier le chemin du server pour le localiser > Next.
Selectionner Openbravo sur la liste affichée > Add > Finish
17
Faites un click droit sur Server > Open > Overview
Cocher : - Serve modules without publishing - Use custom location - Régler le Time Out à 120 s
Le server est prêt à l’emploi, maintenant, nous sommes en mesure de compiler et lancer le projet Openbravo.
18
5. Compiler et lancer le projet :
Il y a deux manières de faire :
1. Single Step, ceci en utilisant Ant task Eclipse.Install .Source
2. Composant par composant en passant par les étapes suivantes :
a. OpenbravoCore projectb. La BDDc. OpenbravoWad projectd. OpenbravoTrl projecte. Openbravo project
Eclipse.Install .Source :
En lançant Eclipse.Install .Source Ant task, la base de données sera créée et les
projets OpenbravoCore, OpenbravoWAD, OpenbravoTrl, et Openbravo seront compilés
et lancés également.
- Selectionnez Run >External Tools > Eclipse.Install .Source Ant task.
- L’avancement de ce processus sera visible dans la console, un message ‘BUILD
SUCCESSFUL’ sera affiché vers la fin de l’opération.
OpenbravoCore :
Dans l’onglet ‘Project Explorer’
- selectionnez OpenbravoCore >Project > Build Project.
- L’avancement de ce processus sera visible dans la console.
La base de données :
La première étape lors de la construction du projet est la création de la base de
données à partir des fichiers *.xml. Allez sur :
- Selectionnez Run >External Tools > create database Ant task.
- L’avancement de ce processus sera visible dans la console, si les paramètres
de la BDD sont bien configurés dans le fichier ‘Openbravo.properties’, un
message ‘BUILD SUCCESSFUL’ sera affiché vers la fin de l’opération.
OpenbravoWAD :
19
- Selectionnez Run >External Tools > eclipse.wad.lib Ant task.
- L’avancement de ce processus sera visible dans la console, un message ‘BUILD
SUCCESSFUL’ sera affiché vers la fin de l’opération.
OpenbravoTrl :
- Selectionnez Run >External Tools > eclipse.trl.lib Ant task.
- L’avancement de ce processus sera visible dans la console, un message ‘BUILD
SUCCESSFUL’ sera affiché vers la fin de l’opération.
Openbravo:
- Selectionnez Run >External Tools > eclipse.compile complete Ant task.
- L’avancement de ce processus sera visible dans la console, un message ‘BUILD
SUCCESSFUL’ sera affiché vers la fin de l’opération.
Une fois que l’ERP Openbravo est proprement compilé et exécuté, il est prêt
maintenant à être utilisé directement sur le navigateur Web. La figure ci-dessous
illustre le résultat obtenu après avoir :
- Selectionnez Tomcat server >click sur start the sever > lancer votre
navigateur > taper l’URL du site. (Ex: http://localhost:8080/openbravo/).
20
21
Conclusion
Openbravo ERP introduit le nouveau concept de modularité.
La modularité est une caractéristique importante de l’ERP Openbravo, ce qui
rend le système très souple, modulaire et maintenable. Introduite dans la
version 2.50, la modularité est une nouvelle approche du développement qui
fournit aux développeurs les moyens d'être en mesure de développer de
nouvelles fonctionnalités, packages et distribuer leur travail d'une manière
structurée et contrôlée.
******************************************************************************
***********
******************************************************************************
***********
******************************************************************************
***********
******************************************************************************
***********
******************************************************************************
***********
******************************************************************************
***********
******************************************************************************
***********
******************************************************************************
***********
22
******************************************************************************
***********
******************************************************************************
***********
******************************************************************************
***********
******************************************************************************
***********
******************************************************************************
***********
******************************************************************************
***********
******************************************************************************
***********