Professional Documents
Culture Documents
Introduction
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:
Single server. Dual server, with one database server and one application server. Multi-server, with multiple servers running a database RAC and multiple application servers with a load balancer.
For production environments, follow these installation steps. For development environments, follow these installation steps.
Downloading a source code tarball. Checking out the source code from the Openbravo Mercurial repository.
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. Replace the xx with the latest version. e.g OpenbravoERP-3.0MP2.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 http://code.openbravo.com/erp/devel/main OpenbravoERP-3.0MP2 $ hg up 3.0MP2
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 [trusted] users = tomcat EOF
ant setup
2. Move to the OpenbravoERP-2.50MPX/config directory. 3. Access the graphical configuration wizard: o 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.
o Windows: run setup-properties-windows.exe 4. Configure the Openbravo.properties 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.
Installation
Before starting with installation, check that Openbravo.properties 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
Tips (Advanced)
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:
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