Installation/Custom/Openbravo Setup

Installation

Custom installation

PostgreSQL Oracle

JDK

Tomcat

Ant

Apache

Download Tarball Mercurial Clone

Openbravo Setup

<currentversion type="link">

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

Editing the Configuration files

1. Move to the OpenbravoERP-#version# directory in a command line terminal and run:

   ant setup

2. 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

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: <source lang="bash">src-db/database/lib/wstx-asl-3.0.2.jar</source>

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

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.

1. 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.

Installation on Windows

</currentversion>