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

******************************************************************************

***********

******************************************************************************

***********

******************************************************************************

***********

******************************************************************************

***********

******************************************************************************

***********

******************************************************************************

***********

******************************************************************************

***********