View source | Discuss this page | Page history | Printable version   
Main Page
Upload file
What links here
Recent changes

PDF Books
Add page
Show collection (0 pages)
Collections help




Several parameters should be configured for Openbravo to work correctly. These parameters can be configured through a graphical interface using the setup tool or by hand.


The content of this file include:

Date/time format

Define the date and time formats:

Bulbgraph.png   After changing any of those properties above a complete re-compilation must be done, a smartbuild is not sufficient. This is needed as those values are incorporated in various generated files. Therefore, after changing any of these properties, ant compile.complete.deploy must be executed



Apache JDBC Connection Pool

Bulbgraph.png   This feature is available starting from 3.0PR15Q4.

All properties are explained in detail here.

Read-Only Pool

Bulbgraph.png   This feature is available starting from 3.0PR17Q2.

The read-only pool feature allows to retrieve connections from a secondary (backup) database which allows just read-only operations. Typically, this will be a stand-by database that must have its data updated as much as possible.

It provides two main advantages:

To configure the read-only pool the following property must be included:

Note that it is also mandatory to define the Apache JDBC Connection Pool in order to make use of the read-only pool.

Besides, for each bbdd.* and db.pool.* it is possible to add new bbdd.readonly.* and db.readonly.pool.* properties to configure the read-only database connection and specific pool properties for it. For example:


In case the read-only properties are not defined, the read-only pool will take the properties defined for the standard pool.

Bulbgraph.png   Once the read-only pool is enabled, it will be used to generate all the standard reports of the application. Please note that for custom manual reports which are not making use of the standard reporting engine, they should be adapted in case it is desired to make use of the read-only pool to generate them.

Starting from 3.0PR17Q4 release, there are some manual reports in core that have been made compatible with the read-only pool. The full list of adapted reports is listed here.

And starting from 3.0PR18Q2 release, the documents printed with the standard print toolbar button, are never using the read-only pool (even if configured) but the standard pool. See here for additional information.

Tomcat Manager

Development parameters

Parameters specially useful for developers.


authentication.class: property used configure the authentication manager. Possible values:

This is an example using the default authentication manager.




Safe mode

Log in security

These properties are explained in detail in Log in security document.

Bulbgraph.png   Available from 3.0MP12


Bulbgraph.png   This feature is available starting from 3.0MP20.
Bulbgraph.png   This feature is available starting from 3.0PR17Q1.
Bulbgraph.png   This feature is available starting from 3.0PR17Q3.


Bulbgraph.png   Available from 3.0PR15Q1 is a plain text file that you can edit manually by duplicating the file or using the assistant (console application).

Since 3.0PR15Q1 to configure file can (and in fact must) be done via console application. For that, go to the directory with the working clone of the repository and execute setup ant task:

cd openbravo-root
ant setup

The invocation of this ant target will compile and execute automatically a console application.By going through the console application provide all requested information and at the end, select Accept to apply the changes and close the application.

Bulbgraph.png   The recommended configuration option is [2], Default configuration that is the fastest option to configure the Openbravo.Properties file. Then you can change some specific properties.

As a result of these actions a new file, containing specified settings, will be created in config subdirectory.

Before 3.0PR15Q1 is a plain text file that you can edit manually by duplicating the file or using the graphical assistant (wizard).

To configure it using the wizard, first run the ant setup command to download the setup tool that matches your operating system and architecture:

cd openbravo-root
ant setup

Then, go to the config/ directory and run the setup-properties tool. For example, in Linux:

cd openbravo-root/config

As a result of these actions a new file, containing specified settings, will be created in config subdirectory.

Note: If there is no setup binary for your operating system and architecture, send a request to <staff.rm at openbravo dot com>.

Overriding properties per instance

Bulbgraph.png   Available from 3.0PR15Q2

Openbravo installations within a Tomcat clustering can define some properties to be different between different cluster nodes while sharing a common file for the common properties.

This can be done by creating new properties files for each node wanting to override some properties. These files must be placed in the same config directory than common and be named, where hostName references the name of each node. Name of each host can be defined in 3 different manners:

For example, having a cluster of 3 nodes named app1, app2 and app3. All the 3 nodes share the same webapp and sources directories. Background processes want to be run only in app1 node. In this case there would be a common file containing all the properties where background.policy would be set to no-execute. In addition there would be a with background.policy set to default. In this manner, app1 instance would use the common for all the properties but for background.policy which would be overrident to default.

Developers: getting values for properties

The way to obtain the actual value for a concrete property is using OBPropertiesProvider.getInstance().getOpenbravoProperties().getProperty("propertyName") where propertyName is the name of the property to get the value for. OBPropertiesProvider manages file path location and property overwriting.

Retrieved from ""

This page has been accessed 32,418 times. This page was last modified on 20 February 2018, at 15:14. Content is available under Creative Commons Attribution-ShareAlike 2.5 Spain License.