Openbravo ERP installation/fr

Introduction

Cet article explique comment installer Openbravo ERP. Avant de commencer, Soyez sûr d'avoir bien installé l'environnement Openbravo, i.e., PostgreSQL database, Sun Java Development Kit (JDK), Apache Tomcat et Apache Ant.

Openbravo ERP peut être installé de deux manières différentes:

• Graphique mais lent: Télécharger Bitrock installer.
• Plus rapidement en ligne de commande (Programme/Exécuter puis Cmd) checking out and compiling Subversion source code.

License

Openbravo ERP is licensed under the Openbravo Public License Version 1.1:

The contents of this file are subject to the Openbravo Public License Version 1.1 (the "License"), being the Mozilla Public License version 1.1 with a permitted attribution clause; you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.openbravo.com/product/legal/license/.

Software distributed under the License is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License for the specific language governing rights and limitations under the License.

The Original Code is Openbravo ERP. The Initial Developer of the Original Code is Openbravo SL. All portions are Copyright (C) 2001-2006 Openbravo SL. All Rights Reserved.

Installateur Bitrock

Télécharger le dernier Openbravo ERP Universal Installer.

• Sous Windows, double cliquez dessus.
• Sous Linux, rendez le éxécutable et lancez le (utilisateur root):

chmod +x OpenbravoERP-2.35-MP1-linux-installer.bin
./OpenbravoERP-2.35-MP1-linux-installer.bin

Un assistant d'installation (wizard) apparaît:

Lisez et acceptez Openbravo Public License Version 1.1 avant de continuer le processus d'installation. En cliquant sur Next, vous acceptez les termes de la licence.

Indiquez le répertoire ou Openbravo ERP va être installé. Après avoir cliqué sur Next, selectionnez aussi le répertoire des attachements.

Puis chosissez le type d'installation:

• Full (standard) installation incluant la base de donnéeset l'application.
• Partial (custom) installation incluant un seul des composants.

Si vous avez choisi l'installation complète, deux options sont nécessaires :

• Binary. La base de données est créée et l'application est installée. C'est la voie la plus rapide et recommandée pour les tests.
• Full. La base de donnée est créée, l'application compilée et les fichiers générés sont installés.Catte installation est plus longue mais recommandée pour la production.

Indiquez quelle base de données utiliser. Aujourd'hui, Oracle et PostgreSQL sont supportés.

Indiquez le répertoire d'installation du Java Development Kit (JDK) de Sun (si le JDK est proprement installé, le répertoire d'installation sera automatiquement inséré).

Indiquez le répertoire d'installation d'Apache Ant (si Apache Ant est correctement installé, le répertoire d'installation sera automatiquement inséré).

Indiquez le répertoire d'installation d'Apache Tomcat (si Apache Tomcat est correctement installé, le répertoire d'installation sera automatiquement inséré).

Indiquez les paramètres de connexion à Apache Tomcat. Apache Tomcat doit être en service car le port est testé. Trois paramètres sont requis :

• Web Server domain. L'adresse IP ou Tomcat tourne (localhost ou adresse externe).

• HTTP Port. Le port que Tomcat utilise (en général 8080, 8880, 8180, ...).
• Context name. Donnez un nom de contexte à votre application.

Indiquez le réperoire ou la base est installée.

Indiquez les paramètres de base de données permettant à l'installateur de se connecter. Votre base de données doit tourner carle port est testé. Les paramètres suvants sont requis :

• Database host. L'adresse IP ou le nom d'hôte ou la base tourne.
• Database port. Le port que la base utilise (Par défaut, 5432 avec PostgreSQL et 1521 avec Oracle).
• Database name. Si PostgreSQL, le nom de la base qui hébergera le modèle de données d'Openbravo.

Cliquez sur Next, si vous utilisez Oracle, SID (Oracle System Identifier) et TNS (Transparent Network Substrate) seront requis.

Dans la fenêtre suivante, si vous utilisez postgres, tapez deux fois le mot de passe administrateur de la base. Si cest Oracle tapez deux fois le mot de passe de l'utilisateur system .En fait, Openbravo ERP a besoin des privilèges administrateur pour créer une base de données.

Tapez le nom et mot de passe de l'utilisateur qui va gérer les objets de la base Openbravo. Attention de ne pas réutiliser un utilisateur déjà créé.

Cliquez sur Next deux fois pour finaliser l'installation d'Openbravo ERP. Ce process peut prendre plus d'une heure suivant votre machine.

Subversion source code

Pour vérifier les sources Openbravo ERP depuis Openbravo Subversion repository, vous devez installer le client Subversion (SVN).

Une fois installé, allez dans le répertoire ou vous voulez vérifier le code source et tapez en ligne de commande :

svn co https://dev.openbravo.com/svn/openbravo/tags/r2.35mp1/ openbravo-235mp1

Allez dans le répertoire openbravo-235mp1 et configurez les fichiers build.xml, Openbravo.properties, XmlPool.xml et dbCon5.xml en utilisant l'assistant (wizard) en tapant en ligne de commande :

ant -f build.xml.template setup

Avant de commmencer la compilation, vérifiez que build.xml (répertoire racine) et Openbravo.properties, XmlPool.xml et dbCon5.xml (dans le répertoire config) ont été bien configurés. Sinon, éditez les manuellement (avec JCreator LE par exemple).

Créez la base depuis les fichiers *.xml et installez Openbravo ERP en une fois en tapant :

ant install.source

Finallement, déployez le fichier openbravo.war dans le répertoire contexte d'Apache Tomcat (en général webapps) en tapant en ligne de commande :

ant deploy

Démarrer Openbravo ERP

Dans les 2 cas (installatin en ligne de commande ou avec Bitrock), stoppez et redémarrez le service Tomcat pour terminer l'intallation.

Normalemen, vous devez trouver dans le répertoire Apache Tomcat webapps :

• le fichier nom_du_contexte.war.
• le répertoire nom_du_contexte.war.

Sinon :

• Stoppez le service Tomcat.
• Copier le fichier nom_du_contexte.war depuis le répertoire lib.
• Copiez le dans le répertoire webapps de Tomcat.
• Redémarrez le service Tomcat.
• Vérifiez que le répertoire nom_du_contexte.war a bien été créé dans le répertoire webapps de Tomcat.

Accédez à Openbravo ERP depuis votre navigateur Internet en tapant l'exacte URL de contexte (par exemple http://localhost:8080/openbravo/).

Tapez Openbravo pour Username et openbravo pour Password puis cliquez sur le bouton Login.

Félicitations! L'installation d'Openbravo ERP est terminée :-)

Note importante: please notice that first log in is done with System Administrator role so you will not be able to see business options (message AccessTableNoView will display instead) but only administration tasks. In order to access business partners, products, sales and procurement orders and so on, change your role to Openbravo Admin by clicking on Openbravo link (left up) and selecting it in Role infomation pop-up window. You can also set this role as default by checking Set as default check box.

Configurations after installation

After Openbravo ERP is properly installed and running, there are a few parameters that you can customize to adapt better Openbravo ERP to your country or region.

Configuring the default date and time formats

To change the default Openbravo ERP date format edit the Openbravo.properties file and adjust the Time formats variables.

If you are using Oracle, edit the XmlPool.xml file and assign the dbSessionConfig variable to:

ALTER SESSION SET NLS_LANGUAGE='SPANISH' NLS_DATE_FORMAT='DD-MM-YYYY' NLS_NUMERIC_CHARACTERS='.'

Where the NLS_LANGUAGE and NLS_DATE_FORMAT parameters are assigned to the language and date format that you want to use.

If you are using PostgreSQL, modify the 'dateFormat' database function in /database/model/prescript-PostgreSql.sql with the date format that you want to use, and apply that change to the database by performing:

ant update.database

In both cases, once all the changes are done, recompile and deploy Openbravo ERP:

ant compile.complete
ant war
ant deploy

Configuring the default numbering format

You can modify the default numbering format by editing the Format.xml file inside config folder. You should have decimal="." grouping="," for every category. Once this is done you will have to restart Tomcat and the reports will show as you wish.

Known issues

Here is a list of common issues with Openbravo ERP installation.

Tomcat hot-deployment problem on Windows

There is a known issue with Tomcat working under Windows. Openbravo ERP does a hot-deploy a of openbravo.war file to Tomcat but on Windows it often encounters file locking issues. Windows will not let Tomcat undeploy the old application because files are locked by the Operating System. Tomcat has mechanisms to allow avoiding locking. In Tomcat 5.5 and 6.0, this mechanism is disabled by default. To enable it edit %CATALINA_BASE%\conf\context.xml. Find the root <context> and add these two attributes:

<context antiJARLocking="true" antiResourceLocking="true">

Jasper Reports Issue

When compiling the source code, the application server needs an internet connection in order to compile successfully the *.jrxml files. If not, the Jasper reports will not work on the application.

In Windows, firewalls could also impede Jasper reports compilation so turn them off temporarily.

The header of these .jrxml files is like

<?xml version="1.0" encoding="UTF-8"  ?>
<!DOCTYPE jasperReport PUBLIC "//JasperReports//DTD Report Design//EN" "http://jasperreports.sourceforge.net/dtds/jasperreport.dtd">

If the application server does not have internet connection, you will have some errors while compiling the sources even if the build is successful. When you call one of these reports in the application, you will get something similar to this:

org.xml.sax.SAXParseException: Premature end of file.

If you edit all the jrxml files (a total of 58) and delete the line where it calls the internet connection,

<!DOCTYPE jasperReport PUBLIC "//JasperReports//DTD Report Design//EN" "http://jasperreports.sourceforge.net/dtds/jasperreport.dtd">

the compilation will report no errors, but the translation will be done badly, and when calling one of these reports in the application, you will get an error window:

Language "null" not supported by this report compiler. Expecting "java" instead.

So, the final solution for this issue is to replace the line

<!DOCTYPE jasperReport PUBLIC "//JasperReports//DTD Report Design//EN" "http://jasperreports.sourceforge.net/dtds/jasperreport.dtd">

by this one

<!DOCTYPE jasperReport PUBLIC "//JasperReports//DTD Report Design//EN" "/tmp/jasperreport.dtd">

in all 58 .jrxml files in order to avoid the contact with the previous url, and so the compilation and the application reports will work well.

Unsatisfied Link Error executing a Jasper Report

In some Linux distributions there is a problem using Java SDK 1.5.0_13 and Tomcat running as a daemon [jsvc]. When a Jasper Report is launched an error appears indicating that it cannot find a library. The easiest way of fixing it is editing /etc/init.d/tomcat script and export the variable LD_LIBRARY_PATH to the path where the library (libawt.so) is located. For example:

LD_LIBRARY_PATH=/usr/lib/jvm/java-1.5.0-sun-1.5.0.13/jre/lib/i386/
export LD_LIBRARY_PATH

Internet Explorer 6

The main problem is that IE6 does not support PNG with alpha channel. IE7 and Mozilla Firefox do.

First solution: replace PNG images with GIFs

• It is not possible just to replace PNG images with GIFs, because PNG have for every pixel an alpha channel, but GIF don't. GIF supports only a subset of 256 colors, but that's not the biggest problem. With GIFs you just have the possibility to define a color as full transparent or not. That means that a gradient from black to transparent is impossible.

Second solution: avoid using transparencies

• This implicates that overlaying images could not be used. For example an icon in the toolbar, has an a rounded rectangle background on hover and on press. The usage is easy now, because we can overlay these images with the icon. But without transparencies we would need 3 different icons. Three times the same with different backgrounds. That requires a lot of icons to be build.
• The problem in this case is not only that we have to rebuild all icons with every possible backgrounds, the problem is also on the implementation side of reconstructing your structure of HTML and CSS.

Third solution: filters

• Well, it is not completely impossible to display transparent PNGs with IE6, even IE5.5. There is a filter mechanism handling this, which could be applied by JavaScript.
• http://www.twinhelix.com/css/iepngfix/demo/ and http://redvip.homelinux.net/varios/explorer-png.html are few examples about this.

We have tried several filter solutions but it can not be applied without a big change of css and html files.

So the only factible solution would be build a new skin with gif images, loosing interface quality. You can find info about how to build a new skin here http://wiki.openbravo.com/wiki/index.php/Skins

You always also have the choice of install Mozilla Firefox or update to IE7 (if you are a Windows XP user).

Openbravo FAQ

Openbravo's Frequently Asked Questions (FAQ).

Summary

Openbravo ERP installation should not present any other special problem if Openbravo environment was properly installed before.

Support

For any question or doubt regarding Openbravo ERP installation, post them in Openbravo Help forum or join #openbravo IRC channel in Freenode.