Configuring Openbravo manually

Introduction

Several parameters should be configured for Openbravo to work correctly. These parameters can be configured through a graphical interface using the command ant setup. However, sometimes you may want or need to change directly the configuration files. For example:

• The system has no graphical environment. If installing Openbravo in a server without graphical environment, parameters should be manually configured.
• Change only one parameter. Openbravo is up and running. If only one parameters needs to be changed (e.g., Tomcat context name) it is faster to change the parameter directly in the configuration file.

Configuration files

This is a list of the Openbravo's configuration files. For each of the them, the most important parameters are explained.

build.xml

• context.name: This is the name of the Tomcat's context.
• attach.path: This is the path where the attachments will be stored.
• web.url: This is the url that would be used to access the static content (i.e., images, css, javascripts) of the application. If not sure, write '@actual_url_context@/web'.

config/Openbravo.properties

This file configures several system wide configuration parameters. Select the date format you want. The database parameters in this file are used by the ant database tasks.

config/dbCon5.xml

This file stores the database connection data used during compilation. The URL parameter has the format: 'CONNECTOR:USER/PASSWORD@SERVER:PORT:SID'. This is an example: 'jdbc:oracle:thin:user/password@localhost:1521:xe'. Each of this parameters is explained below:

• CONNECTOR: The one used to connect to the database.
• USER/PASSWORD: Database user and password. This user does not need sysdba role.
• SERVER: The server where the database is. This could be an IP, the name of the machine or localhost if the database is in the same machine.
• PORT: Port to which the database server is listening.
• SID: Database SID.

config/XmlPool.xml

This file stores the database connection data used during execution. The parameters are the same as those of config/dbCon5.xml, but grouped in different order.

config/log4j.lcf

This file configures Openbravo logs. More info about this file can be found here.