View source | Discuss this page | Page history | Printable version   

ERP 2.50:Openbravo ERP Installation/Custom Installation

Bulbgraph.png   This document refers to the old Openbravo 2.50 version and is probably not what you are looking for.
  • For documentation about the latest Openbravo 3 version, go here.
  • If you are still using Openbravo 2.50, we strongly recommend to migrate to Openbravo 3. Upgrading from 2.50 guide.


A custom installation provides you with maximum deployment flexibility and full control over the technology stack and its configuration. However, it can be laborious and requires a high degree of experience.

For this reason, we recommend to novice users not to attempt custom installations and to instead install Openbravo ERP in other recommended architectures.

System Requirements

Look up system requirements before installing Openbravo ERP!

Deployment Topology

A custom installation allows you to choose your preferred deployment topology, depending on your data volume and user load:

Technology Stack Installation

You can optimize your installation of Openbravo ERP, depending on how you intend to use it:

Downloading Openbravo ERP

You can to obtain a copy of the source code by either:

Downloading the tarball

You can download a tarball of the Openbravo ERP source code from SourceForge.

Once the download is complete, you can extract the code with the following command:

tar -xvf OpenbravoERP-2.50xx.tar.bz2

If you are using Windows, make sure you uncompress this file with a tool capable of managing long file names, like 7-zip. Using 7-zip is the recommended option for Windows users.

Bulbgraph.png   Replace the xx with the latest version. e.g OpenbravoERP-3.0PR23Q4.tar.bz2

Mercurial clone

To be able to check out Openbravo ERP source code from Openbravo Mercurial repository you need to first install the Mercurial client.

Once the Mercurial client is installed, move to the directory to which you want to check out the source code.

To check out the latest source code tag, type the command:

$ hg clone OpenbravoERP-3.0PR23Q4
$ hg up 3.0PR23Q4

In order for the Module Management Console to work correctly it is necessary that the user running the Tomcat process is a trusted user to access the Mercurial repository, trust from Mercurial's point of view. If you are running Tomcat with the same user that has done the hg clone, then you can skip this step. Otherwise, add the tomcat user (e.g. tomcat) to the trusted group:

$ mkdir /etc/mercurial
$ cat << EOF >> /etc/mercurial/hgrc
users = tomcat

Openbravo ERP Installation

Once you have obtained the source code follow these steps to install it.

Editing the Configuration files

  1. Move to the OpenbravoERP-2.50MPX in a command line terminal and run:
    ant setup
  2. Move to the OpenbravoERP-2.50MPX/config directory.
  3. Access the graphical configuration wizard:
    • Linux: make executable and run setup-properties-linux.bin
    If you face any segfaults running this tool, add --mode xwindow or --mode text as an argument.
    • Windows: run setup-properties-windows.exe
  4. Configure the and log4j.lcf files using the configuration wizard.

These configuration wizard can also run in text mode without a graphical system. It will detect the correct display mode for your system.


Before starting with installation, check that and log4j.lcf files (in the config directory) have been properly configured. If not, edit them manually.

  1. In the command line type:
    ant install.source
    The ant install.source command creates the database from *.xml files and installs Openbravo ERP

Using Openbravo ERP

Navigate to the Openbravo ERP installation guide to discover how to use Openbravo ERP.

Tips (Advanced)

Bulbgraph.png   These instructions are not required if you selected the default options

If you have explicitly selected war as the deploy.mode during the setup, you must deploy the openbravo.war file into the Apache Tomcat context directory using the command:

ant deploy.context

Database cleanup

If you are using PostgreSQL database, you must clean the database before you access Openbravo ERP to prevent performance issues. Use the command:

vacuumdb -f -z -h ''hostname'' -d ''dbname'' -U ''username''

Replacing hostname with the actual hostname of your DB server, dbname with the database name (by default openbravo), and username with the name of the DB user (by default tad).

Configuration Validation

Before you access your Openbravo instance, it is strongly recommended that you run the following command to validate your system configuration:

ant diagnostic

Retrieved from ""

This page has been accessed 124,395 times. This page was last modified on 20 April 2015, at 14:43. Content is available under Creative Commons Attribution-ShareAlike 2.5 Spain License.