Home

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

Editing the Configuration files
Move to the OpenbravoERP-3.0PR21Q1.1 directory in a command line terminal and run:
ant setup
Configure the Openbravo.properties and log4j.lcf files using the console application.
Note: More about setup ant task can be found at Openbravo.properties#Edition.

Note: On a windows based system all path in Openbravo.properties with a \ character need to be written as \ . This applies for example to the source.path and attach.path settings.

The ant setup tool currently has a known bug not following this for source.path setting.

Extra system configuration
Bulbgraph.png This system configuration applies just for versions prior to 3.0PR19Q2.
Before the installation one more system level setup is needed.

One file which is delivered with the Openbravo sourcecode is needed to be available inside a folder of the ant installation.

The file needed to be made available is:

src-db/database/lib/wstx-asl-3.0.2.jar
That file needs to made available inside the ANT_HOME/lib (The lib subfolder of the ant installation done earlier).

That can be done by either copying the file once or creating a symlink (ln -s on linux or using mklink on a windows system)

Installation
Bulbgraph.png Before starting with the installation verify that both java/tomcat & your database have the same timezone configuration otherwise hard to debug problems happen.
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.

In the command line type:
ant install.source
The ant install.source command creates the database from *.xml files and installs Openbravo
Troubleshooting
If you find problems running install.source, check the Installation/Troubleshooting article

Accessing Openbravo
To access Openbravo type http://ip-address/openbravo in your web browser. Use Openbravo as the username and openbravo as the password.

NOTE: The username is Openbravo, with an uppercase O. The password is openbravo, with a lowercase o. The system is case-sensitive, and you need to type both data elements correctly to access it.

Known Issues / Special System Specific Notes
MMC restart functionality is not available and must not be used. Reason is that is replaces the running tomcat and requires custom installation with the way tomcat start/stop is managed which is i.e. not compatible with the windows tomcat service manager.
Instead of using it the normal system specific restart method must be used.
MMC rebuild combined with system specific restart can fail in some specific cases. If a Openbravo update does replace third-party jar libraries (i.e. updating them) then using the MMC rebuild + a non MMC restart can lead to failures on the tomcat start.
To avoid this both the rebuild & restart can be done on the command line.
If that error happens a full recompile (ant compile.complete.deploy) & tomcat restart can be done to correct the situation.

General Information
Please click on the above link for general information about Openbravo.

In this section you will find information on Getting Started with Openbravo, which provides a summary of resources available to you.

In order to quickly configure Openbravo to evaluate it, we would recommend that you start with the Quick Guide.
This will allow you to get your own version of Openbravo up and running in a matter of hours.

The current Openbravo Development Status and Release Notes are available, same way as Openbravo Design and Development Processes.

You may also find Support Policy useful as well as the Openbravo Implementation methodology.

System Administration Guide
Please click on the above link to access all documentation for System Administrators.

You will find important information on System Requirements, which should be reviewed, but once you are confident that your environment meets the minimum system requirements, the next port of call is likely to be the Installation Manual.

Please note that if you are coming from a previous version of Openbravo then you will find the Upgrade Guide useful.

Helpful information on working with the Openbravo Appliance can be found in the Openbravo Appliance Administration Guide.

Quick Guide
The Quick Guide describes the main steps needed to setup and run fundamental functional flows for your company in Openbravo, intentionally keeping the explanations and executions as simple as possible. By following this simple guide you should be able to have your own version of Openbravo up and running within a couple of hours.

User Guide
Click on the above link to access the User Guide describing how to use Openbravo.

If you are new to Openbravo then the User Interface chapter of the User Guide explains how to access Openbravo and navigate though the user interface.

The Business Flows contains list of process supported in Openbravo and drives to step by step instructions on how to execute them in the application.

The Common Concepts & Processes provides a summary of concepts and processes common throughout Openbravo, while the Openbravo Application Areas details how to setup, operate and analize each Openbravo application area.

There are a series of How-To documents addressing areas of special interest. Many of the guides present how to achieve particular business goals in a manner supported by Openbravo.

Developer's Guide
Openbravo Developer's Guide provides information to developers on how to change, extend and build further on Openbravo.

Development HowTos describe Openbravo development topics from the perspective of specific development goals.

Localization Guide
The Localization Guide provides all the information required to properly adapt Openbravo to different languages, regional or country differences and technical or legal requirements of a target market.

Finally, there is a list of Localization Projects currently available for Openbravo.
Please visit that link in case you want to collaborate in the localization effort for your country.

http://wiki.openbravo.com/wiki/Main_Page

Installation Guide

http://wiki.openbravo.com/wiki/Installation/Custom