Installation/Custom/Openbravo Setup - Revision history

Wikiadmin: Created page with "{| style="margin: auto;" cellpadding="0" |- align="center" |

2022-08-13T10:51:30Z

Created page with "{| style="margin: auto;" cellpadding="0" |- align="center" | <div class="t"><div class="b"><div class="l"><div class="r"><div class="bl"><div class="br"><div class="tl"><div..."

New page
{| style="margin: auto;" cellpadding="0"
|- align="center"

| <div class="t"><div class="b"><div class="l"><div
class="r"><div class="bl"><div class="br"><div class="tl"><div
class="tr">
<div style="height:25px;display:
table-cell;vertical-align:middle;"><span style="color:#DC6710">[[Installation | Installation]]</span></div>
</div></div></div></div></div></div></div></div>

| <div class="t"><div class="b"><div class="l"><div
class="r"><div class="bl"><div class="br"><div class="tl"><div
class="tr">
<div style="height:25px;display:
table-cell;vertical-align:middle;"><span style="color:#DC6710">[[Installation/Custom | Custom installation]]</span></div>
</div></div></div></div></div></div></div></div>

|

{|
|-

<div class="t"><div class="b"><div class="l"><div class="r"><div
class="bl"><div class="br"><div class="tl"><div class="tr">
<div style="height:25px;display:
table-cell;vertical-align:middle;"><span style="color:#DC6710">[[Installation/Custom/PostgreSQL_Database | PostgreSQL]]</span>
</div></div></div></div></div></div></div></div></div>

| <div class="t"><div class="b"><div class="l"><div
class="r"><div class="bl"><div class="br"><div class="tl"><div
class="tr">
<div style="height:25px;display:
table-cell;vertical-align:middle;"><span style="color:#DC6710">[[Installation/Custom/Oracle_Database | Oracle]]</span></div></div></div></div></div></div></div></div></div>

|}

| <div class="t"><div class="b"><div class="l"><div
class="r"><div class="bl"><div class="br"><div class="tl"><div
class="tr">
<div style="height:25px;display:
table-cell;vertical-align:middle;"><span style="color:#DC6710">[[Installation/Custom/JDK | JDK]]</span></div></div></div></div></div></div></div></div></div>

| <div class="t"><div class="b"><div class="l"><div
class="r"><div class="bl"><div class="br"><div class="tl"><div
class="tr">
<div style="height:25px;display:
table-cell;vertical-align:middle;"><span style="color:#DC6710">[[Installation/Custom/Apache_Tomcat | Tomcat]]</span></div></div></div></div></div></div></div></div></div>

| <div class="t"><div class="b"><div class="l"><div
class="r"><div class="bl"><div class="br"><div class="tl"><div
class="tr">
<div style="height:25px;display:
table-cell;vertical-align:middle;"><span style="color:#DC6710">[[Installation/Custom/Apache_Ant | Ant]]</span></div></div></div></div></div></div></div></div></div>

| <div class="t"><div class="b"><div class="l"><div
class="r"><div class="bl"><div class="br"><div class="tl"><div
class="tr">
<div style="height:25px;display:
table-cell;vertical-align:middle;"><span style="color:#DC6710">[[Installation/Custom/Apache | Apache]]</span></div></div></div></div></div></div></div></div></div>

|

{|
|-

<div class="t"><div class="b"><div class="l"><div class="r"><div
class="bl"><div class="br"><div class="tl"><div class="tr">
<div style="height:25px;display:
table-cell;vertical-align:middle;"><span style="color:#DC6710">[[Installation/Custom/Download_Tarball | Download Tarball]]</span>
</div></div></div></div></div></div></div></div></div>

| <div class="t"><div class="b"><div class="l"><div
class="r"><div class="bl"><div class="br"><div class="tl"><div
class="tr">
<div style="height:25px;display:
table-cell;vertical-align:middle;"><span style="color:#DC6710">[[Installation/Custom/Mercurial_Clone | Mercurial Clone]]</span></div></div></div></div></div></div></div></div></div>

|}

| <div class="t"><div class="b"><div class="l"><div
class="r"><div class="bl"><div class="br"><div class="tl"><div
class="tr">
<div style="height:25px;display:
table-cell;vertical-align:middle;"><span style="color:#DC6710">[[Installation/Custom/Openbravo_Setup | Openbravo Setup]]</span></div></div></div></div></div></div></div></div></div>

|}

<currentversion type="link">

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

===Editing the Configuration files===
# Move to the ''OpenbravoERP-#version#'' directory in a command line terminal and run:
#:<pre>ant setup</pre>
# Configure the [[Openbravo.properties|''Openbravo.properties'']] and [[Technical_FAQ_about_Openbravo_ERP#How_can_I_configure_the_log4j_file.3F|''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 [https://issues.openbravo.com/view.php?id=30135 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.}}
{{Fancydancy|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:
#:<pre>ant install.source</pre>
#: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.

{{Fancydancy|'''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>

[[Category:Installation]]