View source for ERP/2.50/Openbravo environment installation

{{RatingArticle}}

<div style="background: white; border: 2px solid rgb(255, 0, 0); padding: 2px">
{{(!)| '''This document refers to the old Openbravo 2.50 version and is probably not what you are looking for.'''
* For documentation about the latest Openbravo 3 version, go [[Installation/Custom|here]].
* If you are still using Openbravo 2.50, we strongly recommend to migrate to Openbravo 3. [[Upgrading_From_2.50|Upgrading from 2.50 guide]].
}}
</div>






{{Languages | ERP/2.50/Openbravo_environment_installation}}

== Introduction ==
This article explains in detail how to install and configure the whole stack required for Openbravo ERP to run. The stack consists of:

* [[#PostgreSQL_database|PostgreSQL]] or [[#Oracle_database|Oracle]] database
* [[#Sun_JDK|Sun Java Development Kit (JDK)]]
* [[#Apache_Tomcat|Apache Tomcat]]
* [[#Apache_Ant|Apache Ant]]

{{(!)|If you are looking for a quick way to explore Openbravo ERP without installing the full system stack, try the [http://demo.openbravo.com/ '''Openbravo ERP on-line demo'''] or download an [[ERP/2.50/Openbravo_ERP_Installation#Community_Appliance|'''Openbravo ERP virtual appliance''']].}}

Installation steps of each component are explained for the following operating systems:

* [http://www.microsoft.com/windows/ Microsoft Windows]
* [http://www.debian.org/ Debian Etch/Lenny/Sid]
* [http://www.ubuntu.com/ Ubuntu/Kubuntu]
* [http://www.gentoo.org/ Gentoo Linux 2008.0]
* [http://centos.org/ CentOS]

{{Fancydancy|'''Please feel free to contribute to this article by adding installation steps for more operating systems or improving existing ones'''.}}

== PostgreSQL database ==
Openbravo ERP supports [http://www.postgresql.org/ PostgreSQL] as its database engine.

* 8.3.5 is the minimum required version.
* The UUID contrib package is required.

PostgreSQL documentation and tutorials are available at:

* [http://www.postgresql.org/docs/ PostgreSQL Documentation]
* [http://www.thegeekstuff.com/2009/04/15-practical-postgresql-database-adminstration-commands/ 15 Practical PostgreSQL Database Administration Commands]

===Installing PostgreSQL on Microsoft Windows ===
Follow the instructions on the [http://wiki.postgresql.org/wiki/Running_%26_Installing_PostgreSQL_On_Native_Windows PostgreSQL wiki]. Make sure to select the "UUID" option during the installation. 

There's two installers right now: ''pgInstaller'' and ''One click installer'', We suggest you use '''pgInstaller''' to install PostgreSQL.

By default, '''One click installer''' version does not include the UUID, if you use it you will need to also do this three steps:

#Download "uuid-ossp.dll" from zip file at [http://winpg.jp/~saito/pg_work/OSSP_win32/ winpg.jp]
#Unpack the zip file into ''%Postgresql_directory%/lib'' directory
#Restart the Postgresql server.

=== Installing PostgreSQL on Debian (Ubuntu/Kubuntu/Linux Mint) ===
#Install the package using
#:<pre>sudo apt-get install postgresql-8.3 postgresql-contrib-8.3</pre>
#Set the postgres password using:
#:<pre>sudo /etc/init.d/postgresql-8.3 start
#:sudo su - postgres -c psql
#:alter role postgres with password 'new_password';
#:\q</pre>

===Installing PostgreSQL on Gentoo ===
#Install the package using the following commands. Portage will tell you which version to specify:
#:<pre>echo dev-db/postgresql >> /etc/portage/package.keywords
#:echo dev-db/postgresql-server >> /etc/portage/package.keywords
#:echo dev-db/postgresql-base >> /etc/portage/package.keywords
#:echo virtual/postgresql-base >> /etc/portage/package.keywords
#:echo app-admin/eselect-postgresql >> /etc/portage/package.keywords
#:echo dev-db/libpq >> /etc/portage/package.keywords
#:echo dev-libs/ossp-uuid >> /etc/portage/package.keywords
#:echo dev-db/postgresql-server uuid >> /etc/portage/package.use
#: emerge -av postgresql-server
#: emerge --config postgresql-server
#:/etc/init.d/postgresql-8.3 start
#:rc-update add postgresql-8.3 default</pre>
#Set the postgres password:
#:<pre>psql -U postgres
#: alter role postgres with password 'new_password';
#: \q
#: sed -i 's/trust$/md5/' /var/lib/postgresql/8.3/data/pg_hba.conf
#: /etc/init.d/postgresql-8.3 reload</pre>

===Installing PostgreSQL on CentOS ===

<pre>
yum install postgresql postgresql-contrib
</pre>

== Oracle database ==
Openbravo ERP also supports the following editions of Oracle 10g (version 10.2.0.4.0 or later) and 11g (version 11.1.0.6.0 or later):

* [http://www.oracle.com/us/products/database/std-one/index.html Standard Edition One]
* [http://www.oracle.com/us/products/database/StandardEdition/index.html Standard Edition]
* [http://www.oracle.com/us/products/database/enterprise-edition/index.html Enterprise Edition]

To learn more about Oracle, follow the links:

* [http://www.oracle.com/technology/documentation/database.html Oracle Database 11g Documentation]
* [http://www.oracle.com/technology/documentation/database10gR2.html Oracle Database 10g Release 2 Documentation]

===Installing Oracle on Microsoft Windows ===
Follow [http://www.oracle.com/technology/obe/11gr1_db/install/dbinst/windbinst.htm these instructions] to install Oracle 11g on Windows.

=== Installing Oracle on Debian (Ubuntu/Kubuntu/Linux Mint) ===

Follow [http://www.pythian.com/news/13291/installing-oracle-11gr2-enterprise-edition-on-ubuntu-10-04-lucid-lynx/ these step by step instructions] to install Oracle 11g on '''Ubuntu 10.04 (Lucid Lynx)'''.

Follow [http://www.pythian.com/news/2329/installing-oracle-11gr1-on-ubuntu-904-jaunty-jackalope/ these step by step instructions] to install Oracle 11g on '''Ubuntu 9.04 (Jaunty Jackalope)'''.

Follow [http://www.pythian.com/news/968/installing-oracle-11g-on-ubuntu-804-lts-hardy-heron/ these step by step instructions] to install Oracle 11g on '''Ubuntu 8.04 (Hardy Heron)'''.

Or you can follow [http://www.linuxinsight.com/a-first-look-at-oracle-11g-database-on-debian-gnu-linux.html these instructions] to install Oracle 11g on '''other Debian (Ubuntu/Kubuntu/Mint) versions'''.

===Installing Oracle on Gentoo ===
Follow [http://gentoo-wiki.com/http://www.gentoo-wiki.info/HOWTO_Install_Oracle_10g these guidelines] to install Oracle 10g database on Gentoo.

Follow [http://gentoo-wiki.com/HOWTO_Install_Oracle_10g_Express_Edition these guidelines] to install Oracle 11g database on Gentoo.

===Installing Oracle on CentOS ===

Follow [http://wiki.oracle.com/page/Installing+Oracle+on+CentOS these guidelines] to install Oracle 10g database on Gentoo.

=== Common installation steps ===

* Select AL32UTF8 as the database's NLS_CHARACTERSET.
* Select AL16UTF16 as the database's NLS_NCHAR_CHARACTERSET.

=== Common postinstallation steps ===
In all the cases, after running the installation, check the following:

* The '''number of open cursors''' should be at least '''3000'''. Verify it, and tune the ''ALTER SESSION'' to change the number of open cursors if needed:
<source lang="sql">SELECT value FROM v$parameter WHERE name = 'open_cursors';
ALTER SYSTEM SET open_cursors = 3000 SCOPE=BOTH;</source>
* Make sure that the '''number of processes''' is at least '''150'''. Verify it, and tune the ''ALTER SESSION'' to change the number of processes if needed:
<source lang="sql">SELECT value FROM v$parameter WHERE name = 'processes';
ALTER SYSTEM set processes=150 SCOPE=SPFILE;</source>
* Restart Oracle after doing this change.

== Sun JDK ==
Openbravo supports the following JDKs:

* [http://java.sun.com/ Sun Java Development Kit] version 1.6 (also known as JDK 6.0).
* [http://www.ibm.com/developerworks/java/jdk/ IBM JDK]
* [http://openjdk.java.net/ OpenJDK] version 6 (IcedTea 1.8.x).

All the developers use Sun's version and therefore is the recommended one.

=== Installing the Java SDK on Microsoft Windows ===
#Download and install [http://java.sun.com/javase/downloads/index.jsp JDK 1.6].
#Add the JAVA_HOME environment variable:
## Right-click on '''My Computer'''.
## Select '''Properties'''. The System Properties window appears. 
## Select the '''Advanced''' tab then click  '''Environment Variables'''.
## Click '''New'''. The New System Variable box appears.
## In the '''Variable name''' field, type ''JAVA_HOME''.
## In the '''Variable value''' field type the path of the JDK installation directory. This is usually ''C:\Java\jdk1.6.0_<version>''
## Select the PATH environment variable.
## In the '''Variable value''' field, type the path of the JDK installation directory's ''bin'' folder. This is usually ''C:\Java\jdk1.6.0_<version>\bin''

===Installing the Java SDK on Debian (Ubuntu/Kubuntu/Linux Mint) ===

You must add unstable/non-free apt repositories to install sun-java-jdk6. Ubuntu/Kubuntu users may also need to add the Multiverse repository to install sun-java6-jdk. The Multiverse repository is enabled by default in version Ubuntu 7.10 onwards.

#Install the package:
#:<pre> sudo apt-get install sun-java6-jdk</pre>
#Set the Sun Java JDK as the default JDK:
#:<pre>sudo update-java-alternatives -s java-6-sun</pre>
#Create the '''JAVA_HOME''' variable:
#:<pre> echo 'JAVA_HOME="/usr/lib/jvm/java-6-sun"' | sudo tee -a /etc/environment</pre>
#To make this variable available in your current terminal run:
#:<pre>source /etc/environment</pre>
#To make these variables available system wide, restart the user session.

===Installing the Java SDK on Gentoo ===
#To install the package:
#:<pre>emerge -av sun-jdk</pre>
#Set the default JDK:
#:<pre>java-config -S sun-jdk-1.6</pre>

Portage sets the '''JAVA_HOME''' variable automatically.

===Installing the Java SDK on CentOS ===

#Download [http://java.sun.com/javase/downloads/index.jsp JDK 1.6], put the file in /tmp/.
#Run the installer as root:
#<pre>su -</pre>
#<pre>sh /tmp/jdk-6uXY-linux-i586.bin</pre>
#<pre>mv /tmp/jdk1.6.0_XY/ /usr/local/sun-jdk</pre>
# Create the required environment variables:
#<pre>echo 'export JAVA_HOME=/usr/local/sun-jdk' > /etc/profile.d/sun-jdk.sh</pre>
#<pre>echo 'export PATH=$JAVA_HOME/bin/:$PATH' >> /etc/profile.d/sun-jdk.sh</pre>
#<pre>chmod +x /etc/profile.d/sun-jdk.sh</pre>
# Now log out and log in again as root:
#<pre>exit</pre>
#<pre>su -</pre>
# Verify that the JDK is working as expected:
#:<pre>echo $JAVA_HOME</pre>
#:<pre>/usr/local/sun-jdk</pre>
#:<pre>java -version</pre>
#:<pre>java version "1.6.0_18"</pre>
#:<pre>Java(TM) SE Runtime Environment (build 1.6.0_18-b07)</pre>

== Apache Tomcat ==
Openbravo ERP recommends [http://tomcat.apache.org/ Apache Tomcat] version 6.0 as the servlet container. Use the tar and not the Installer.

===Installing Apache Tomcat on Microsoft Windows ===
#Download and install [http://tomcat.apache.org/download-60.cgi Apache Tomcat 6.0].
#Add '''CATALINA_HOME''', '''CATALINA_BASE''' and '''CATALINA_OPTS''' environment variables:
##Right-click on '''My Computer'''.
##Select '''Properties'''. The system properties window appears.
##Select the '''Advanced''' tab.
##Click '''Environment Variables'''.
##Click '''New'''. The New User Variable box appears.
##In the '''Variable name''' field, type ''CATALINA_HOME''.
##In the '''Variable value''' field, type the path of the Apache Tomcat installation directory. This is usually ''C:\Apache Software Foundation\Tomcat 6.0''.
##Click '''OK'''.
##Click '''New'''. The New User Variable box appears.
##In the '''Variable name''' field, type ''CATALINA_BASE''.
##In the '''Variable value''' field type the path of the Apache Tomcat installation directory.
##Click '''OK'''
##Click '''New'''. The New User Variable box appears.
## In the '''Variable name''' field, type ''CATALINA_OPTS''.
##In the '''Variable value''' type ''-server -Xms384M -Xmx512M -XX:MaxPermSize=256M''.
### If you want to be able to install modules and update the core from the repository, we recommend setting the ''CATALINA_OPTS'' to  ''-server -Xms384M -Xmx1024M -XX:MaxPermSize=256M''
##Select the ''PATH'' environment variable.
##In the '''Variable value''' field, type the path of the Apache Tomcat installation's ''bin'' folder. This is usually ''C:\Apache Software Foundation\Tomcat 6.0\bin''.
{{(!)| More information about managing environment variables in Microsoft's [http://support.microsoft.com/kb/310519 Help & Support] site}}
#Copy the ''C:\Java\jdk1.6.0_<version>\bin\lib\tools.jar'' file from your Sun JDK installation to ''C:\Apache Software Foundation\Tomcat 6.0\lib\''
#In order to avoid Tomcat from auto-reloading itself, comment the WatchedResource line in ''C:\Apache Software Foundation\Tomcat 6.0\conf\context.xml'':
#:<source lang="xml"><!-- <WatchedResource>WEB-INF/web.xml</WatchedResource> --></source>
#Configure a username and password for the Tomcat Manager, by replacing the ''C:\Apache Software Foundation\Tomcat 6.0\conf\tomcat-users.xml'' file with these contents, replacing password="admin" with your chosen password:

<source lang="xml"><?xml version='1.0' encoding='utf-8'?>
<tomcat-users>
  <role rolename="manager"/>
  <role rolename="admin"/>
  <user username="admin" password="admin" roles="admin,manager"/>
</tomcat-users>
</source>

You can check that Tomcat is running by opening http://localhost:8080 in a web browser.

===Installing Apache Tomcat on Debian (Ubuntu/Kubuntu/Linux Mint) ===
#Install the package:
#:<pre> sudo apt-get install tomcat6 tomcat6-admin 
#: sudo rm /var/log/tomcat6/catalina.out
#: sudo /etc/init.d/tomcat6 start</pre>
#:'''Note''': On Ubuntu the 'sudo rm /var/log/tomcat6/catalina.out' command may not find the file, resulting in an error message. This will not affect the installation.
#Check that Tomcat is running by opening http://localhost:8080 in a web browser. Alternatively use the following nmap command to check that port 8080 is open:
#:<pre> nmap localhost -p 8080</pre> if you don't have installed nmap you can try <pre>sudo netstat -atunep|grep 8080|grep jsvc</pre>
#:'''Note''': Earlier versions of Debian based distributions configured Tomcat to run on port 8180. If you cannot verify that Tomcat is running on port 8080, please try 8180 instead.
#Set the '''CATALINA_HOME''', '''CATALINA_BASE''' and '''CATALINA_OPTS''' variables:
#:<pre>echo 'CATALINA_HOME="/usr/share/tomcat6"' | sudo tee -a /etc/environment
#: echo 'CATALINA_BASE="/var/lib/tomcat6"' | sudo tee -a /etc/environment</pre>
#Edit the /etc/default/tomcat6 file, and set the following line:-
#:<pre>JAVA_OPTS="-server -Djava.awt.headless=true -Xms384M -Xmx512M -XX:MaxPermSize=256M"</pre>
#To make this variable available in your current terminal run:
#:<pre>source /etc/environment</pre>
#To make these variables available system wide, restart the user session.
#Check if the tools.jar library is present in Tomcat's classpath in directory /usr/share/tomcat6/lib and, if not, add it: 
#:<pre>cp $JAVA_HOME/lib/tools.jar /usr/share/tomcat6/lib/</pre>
#:In order to avoid Tomcat from auto-reloading itself, comment the WatchedResource line in /var/lib/tomcat6/conf/context.xml:
#:<source lang="xml"><!-- <WatchedResource>WEB-INF/web.xml</WatchedResource> --></source>
#Configure a username and password for the Tomcat Manager, by replacing the ''/etc/tomcat6/tomcat-users.xml'' file with these contents, replacing password="admin" with your chosen password:
#:<source lang="xml"><?xml version='1.0' encoding='utf-8'?>
#:<tomcat-users>
#:  <role rolename="manager"/>
#:  <role rolename="admin"/>
#:  <user username="admin" password="admin" roles="admin,manager"/>
#:</tomcat-users></source>
#Starting with 2.50, the modularity feature required the tomcat user to write in the main Openbravo ERP directory. So achieve this, edit the /etc/init.d/tomcat6 file, search for ''umask 022'' and replace it with ''umask 002''. Then restart Tomcat.

{{Fancydancy|'''Important notes''':
* The security policy of Debian's Tomcat package will prevent the Openbravo context from loading. You must either disable the security policy or create a rule to allow the Openbravo context to load.
*#To create a rule for Openbravo you must create a .policy file. Use a command like:
*#:<pre> sudo touch /etc/tomcat6/policy.d/20openbravo.policy</pre> 
*#:to create a file called ''/etc/tomcat5.5/policy.d/20openbravo.policy''.
*#Open the file and add the following contents:
*#:<pre> // permissions for Openbravo ERP
*#: grant codeBase "file:${catalina.base}/webapps/openbravo/-" {
*#:   permission java.security.AllPermission;
*#: };</pre>
*#Save the file.
*#Restart tomcat to make the changes effective.
*#:<pre> sudo /etc/init.d/tomcat6 restart</pre>}}

===Installing Apache Tomcat on Gentoo ===
#Install the package:
#:<pre>emerge -av tomcat</pre>
#Start Tomcat:
#: /etc/init.d/tomcat-6 start
#: rc-update add tomcat-6 default
#:You can check that Tomcat has been in stalled correctly by opening http://localhost:8080 in a web browser Alternatively, use the following nmap command to check that port 8080 is open:
#:<pre>nmap localhost -p 8080</pre>
#Set the '''CATALINA_HOME''' and '''CATALINA_BASE''' variables:
#:<pre> touch /etc/env.d/99tomcat
#:echo 'CATALINA_HOME=/usr/share/tomcat-6' >> /etc/env.d/99tomcat
#:echo 'CATALINA_BASE=/var/lib/tomcat-6' >> /etc/env.d/99tomcat</pre>
#Update the environment and make the newly created environment variables available system-wide:
#:<pre>env-update && source /etc/profile</pre>
#Set the '''CATALINA_OPTS''' variable by editing the /etc/conf.d/tomcat-6 file:
#:<pre> CATALINA_OPTS="-server -Xms384M -Xmx512M -XX:MaxPermSize=256M"</pre>
#Add the tools.jar library to Tomcat's classpath: 
#:<pre>cp $JAVA_HOME/lib/tools.jar /var/lib/tomcat-6/lib/</pre>
#:In order to avoid Tomcat from auto-reloading itself, comment the WatchedResource line in /etc/tomcat-6/context.xml:
#:<source lang="xml"><!-- <WatchedResource>WEB-INF/web.xml</WatchedResource> --></source>
#Configure a username and password for the Tomcat Manager, by replacing the ''/var/lib/tomcat-6/conf/tomcat-users.xml'' file with these contents, replacing password="admin" with your chosen password:
#:<source lang="xml"><?xml version='1.0' encoding='utf-8'?>
#:<tomcat-users>
#:  <role rolename="manager"/>
#:  <role rolename="admin"/>
#:  <user username="admin" password="admin" roles="admin,manager"/>
#:</tomcat-users></source>
#Starting with 2.50, the modularity feature required the tomcat user to write in the main Openbravo ERP directory. So achieve this, edit the /etc/init.d/tomcat-6 file, search for this line:
#:<pre>start-stop-daemon ${arguments} --exec ${executor} -- ${OPTS_CP} "$@" \</pre>
#Replace it with the following ones:
#:<pre>
#:umask 002 && \
#:start-stop-daemon ${arguments} --exec ${executor} -- ${OPTS_CP} "$@" \
#:</pre>
#:Restart Tomcat to apply the changes:
#:<pre>/etc/init.d/tomcat-6 restart</pre>

===Installing Apache Tomcat on FreeBSD===
You may use tomcat5.5 (/usr/ports/www/tomcat55), tomcat6 (/usr/ports/www/tomcat6), or possibly other verisons. Substitute the version in the commands as necessary.

#Install tomcat
#:<pre>cd /usr/ports/www/tomcat6
#:make && make install</pre>
#Set necessary memory options for tomcat
#:<pre>echo 'tomcat6_java_opts="-server -Xms384M -Xmx512M -XX:MaxPermSize=256M"' \
#:   >> /etc/rc.conf</pre>
#Set the CATALINA_HOME variable
#:<pre>echo 'tomcat6_catalina_home="/usr/local/tomcat6"' >> /etc/rc.conf</pre>
#Start tomcat
#:<pre>/usr/local/etc/rc.d/tomcat6 start</pre>

===Installing Apache Tomcat on CentOS===

#Download the apache-tomcat-6.0.XY.tar.gz file from [http://tomcat.apache.org/download-60.cgi Apache Tomcat 6.0] and place it in /tmp/.
#Uncompress it:
#:<pre>su -</pre>
#:<pre>cd /usr/local</pre>
#:<pre>tar zxvf /tmp/apache-tomcat-6.0.XY.tar.gz</pre>
#:<pre>mv apache-tomcat-6.0.XY/ tomcat</pre>
#Add '''CATALINA_HOME''', '''CATALINA_BASE''' and '''CATALINA_OPTS''' environment variables:
#:<pre>echo 'export CATALINA_HOME=/usr/local/tomcat' > /etc/profile.d/tomcat.sh</pre>
#:<pre>echo 'export CATALINA_BASE=/usr/local/tomcat' >> /etc/profile.d/tomcat.sh</pre>
#:<pre>echo 'export CATALINA_OPTS="-server -Xms128M -Xmx1024M -XX:MaxPermSize=256M"' >> /etc/profile.d/tomcat.sh</pre>
#:<pre>chmod +x /etc/profile.d/tomcat.sh</pre>
#:<pre>chown -R openbravo:openbravo /usr/local/tomcat</pre>
# Download [http://openbravo.pastebin.com/8mrFtJ6H this init script] and place it into /etc/init.d/tomcat. Then make it executable:
#:<pre>chmod +x /etc/init.d/tomcat</pre>
#In order to avoid Tomcat from auto-reloading itself, comment the WatchedResource line in ''/usr/local/tomcat/conf/context.xml'':
#:<source lang="xml"><!-- <WatchedResource>WEB-INF/web.xml</WatchedResource> --></source>
#Configure a username and password for the Tomcat Manager, by replacing the ''/usr/local/tomcat/conf/tomcat-users.xml'' file with these contents, replacing password="admin" with your chosen password:
#:<source lang="xml"><?xml version='1.0' encoding='utf-8'?>
#:<tomcat-users>
#:  <role rolename="manager"/>
#:  <role rolename="admin"/>
#:  <user username="admin" password="admin" roles="admin,manager"/>
#:</tomcat-users></source>

===Tomcat through a proxy===
If your network have a proxy, you need to append this to the tomcat configuration:

 CATALINA_OPTS='-Dhttp.proxySet=true -Dhttp.proxyHost=[PROXY SERVER] -Dhttp.proxyPort=[PORT]'

== Apache Ant ==
[http://ant.apache.org/ Apache Ant] is a Java-based build tool used by Openbravo ERP to automate most of its development tasks. Version 1.7.0  or higher is required.
{{(!)|Note: Apache Ant 1.8.x has not been tested. Use the latest 1.7.x}}

===Installing Apache Ant on Microsoft Windows ===
#Download and extract [http://ant.apache.org/bindownload.cgi Apache Ant] ([http://archive.apache.org/dist/ant/binaries/ old releases]) onto your system (for instance, ''C:\Apache-Ant'').
#Add '''ANT_HOME''' environment variable:
##Right-click on '''My Computer'''.
##Select '''Properties'''. The System Properties window appears.
##Select the '''Advanced''' tab. 
##Click on the '''Environment Variables''' button.
##Click the '''New''' button.
##In the '''Variable name''' field, type ''ANT_HOME''.
##In the '''Variable value''' field, type the path of the Ant directory. This is usually ''C:\Apache-Ant''.
##Click '''OK'''.
## Select the ''PATH'' environment variable.
##In the Variable value field, type the path of the Ant directory's ''bin'' folder. This is usually ''C:\Apache-Ant\bin''.
#Equally add the '''ANT_OPTS''' environment variable:
##Click the '''New''' button.
##In the '''Variable name''' field, type ''ANT_OPTS''.
##In the '''Variable value''' field, type ''-Xmx1024M -XX:MaxPermSize=128M''.

===Installing Apache Ant on Debian (Ubuntu/Kubuntu/Linux Mint) ===
#Install the package:
#:<pre>sudo apt-get install ant ant-optional</pre>
#Set the '''ANT_HOME''' variable:
#:<pre>echo 'ANT_HOME="/usr/share/ant"' | sudo tee -a /etc/environment</pre>
#Set the '''ANT_OPTS''' variable:
#:<pre>echo 'ANT_OPTS="-Xmx1024M -XX:MaxPermSize=128M"' | sudo tee -a /etc/environment</pre>
#Make the ANT_HOME and ANT_OPTS variables available in your current terminal run:
#:<pre>source /etc/environment</pre>
#To make the variables available system wide, restart the user session.

===Installing Apache Ant on Gentoo ===
In Gentoo it's enough to install the ant-core package:

 emerge -av dev-java/ant-core

Portage sets the '''ANT_HOME''' variable automatically. But not '''ANT_OPTS'''. To set it:

 echo 'ANT_OPTS="-Xmx1024M -XX:MaxPermSize=128M"' > /etc/env.d/99ant
 env-update && source /etc/profile

To make the variables available system wide, restart the user session.

===Installing Apache Ant on CentOS===

#Download and extract [http://archive.apache.org/dist/ant/binaries/apache-ant-1.7.1-bin.tar.gz Apache Ant] 1.7.1 onto your system:
#:<pre>su -</pre>
#:<pre>cd /tmp</pre>
#:<pre>wget http://archive.apache.org/dist/ant/binaries/apache-ant-1.7.1-bin.tar.gz</pre>
#:<pre>cd /usr/local</pre>
#:<pre>tar zxvf /tmp/apache-ant-1.7.1-bin.tar.gz</pre>
#:<pre>mv apache-ant-1.7.1/ ant</pre>
#Add the environment variables:
#:<pre>echo 'export ANT_HOME=/usr/local/ant' > /etc/profile.d/ant.sh</pre>
#:<pre>echo 'export PATH=$ANT_HOME/bin/:$PATH' >> /etc/profile.d/ant.sh</pre>
#:<pre>echo 'export ANT_OPTS="-Xmx1024M -XX:MaxPermSize=128M"' >> /etc/profile.d/ant.sh</pre>
#:<pre>chmod +x /etc/profile.d/ant.sh</pre>
# Now log out and log in again as root:
#<pre>exit</pre>
#<pre>su -</pre>
# Verify that Ant working as expected:
#<pre>ant -version</pre>
#<pre>Apache Ant version 1.7.1 compiled on June 27 2008</pre>

== Operating system permissions for Tomcat ==
UNIX based operating systems use different system users to run their processes and services. Tomcat usually has its own ''tomcat'' user, and a command line and task is run by a normal user, e.g. ''openbravo''. Since the introduction of the modularity feature in version 2.50, it is necessary to allow ''tomcat'' to write in the root directory of the Openbravo ERP installation. Conversely, the ''openbravo'' user requires write permissions in the Tomcat webapps directory.

#Change the default file permissions for the user running the Ant tasks, e.g. ''openbravo''. Assuming you are using Bash as your shell, append the following line to the /home/openbravo/.bashrc file:
#:<pre>umask 002</pre>
#Add openbravo to the tomcat group:
#:<pre>gpasswd -a openbravo tomcat</pre>
#Add tomcat to the openbravo group:
#:<pre>gpasswd -a tomcat openbravo</pre>

Windows systems do not use system users in the same way, so these changes are not required.

== Performance and security tips ==
For production environments, it is recommended to make some changes in order to [[Performance_and_Security_Tips| improve Openbravo ERP performance and security]].

== Known issues ==
Here is a list of known issues during Openbravo environment installation.

=== JDK and X issue in Debian/Ubuntu ===
When installing a module from within Openbravo ERP, you may get an error saying that the tomcat user cannot access the X server. To workaround this, run this with the user running the ant tasks:

 xhost +

=== Jasper Reports ===
In some configurations to make JasperReports work, you need to add ''-Djava.awt.headless=true'' parameter to the ''CATALINA_OPTS'' environment variable. The ''CATALINA_OPTS'' should look something similar to ''CATALINA_OPTS ="-server -Xms384M -Xmx512M -Djava.awt.headless=true"''.

=== Tomcat hot-deployment problem on Windows ===
There is a known issue with Tomcat working under Windows. Openbravo ERP does a hot-deploy a of ''openbravo.war'' file to Tomcat but on Windows it often encounters file locking issues. Windows will not let Tomcat undeploy the old application because files are locked by the Operating System. Tomcat has mechanisms to allow avoiding locking. In Tomcat 5.5 and 6.0, this mechanism is disabled by default. To enable it edit %CATALINA_BASE%\conf\context.xml. Find the root <context> and add these two attributes:

 <context antiJARLocking="true" antiResourceLocking="true" />

=== Openbravo ERP FAQ ===
[[FAQ|Openbravo's ERP Frequently Asked Questions (FAQ)]].

== Support ==
If you have any questions about installing the penbravo environment, post them in [http://forge.openbravo.com/plugins/espforum/browse.php?group_id=100&forumid=549511 Openbravo Help forum] or join [[Communication_channels#Openbravo_chat_channels | #openbravo IRC channel]] in Freenode.

== Installing Openbravo ERP ==

Now that the technology stack is properly installed and configured you can continue with your [[ERP/2.50/Openbravo_ERP_Installation/Custom_Installation#Downloading_Openbravo_ERP|'''custom installation of Openbravo ERP''']].


[[Category:Installation ERP]]