Installation/Custom/Openbravo Setup
|
|
|
<currentversion type="link">
Once you have obtained the source code follow these steps to install it.
Contents
Editing the Configuration files
- Move to the OpenbravoERP-#version# 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
 |
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. |
- 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>
