Difference between revisions of "Compile"

From ADempiere
Jump to: navigation, search
This Wiki is read-only for reference purposes to avoid broken links.
 
(Missing a line for MailLogger)
 
(17 intermediate revisions by 9 users not shown)
Line 1: Line 1:
 
==Building the source==
 
==Building the source==
  
Here you will find instructions for compiling and installing Adempiere from source and suggestions for when compilation doesn't go so smoothly.
+
Here you will find instructions for compiling and installing ADempiere from source and suggestions for when compilation doesn't go so smoothly.
  
*Adempiere Stable
+
===ADempiere Stable===
Instructions for installing the latest stable Adempiere 3.x release.
+
Follow the instruction on how to build from trunk, except that you should pull the source from the svn tag folder instead of from the svn trunk folder.
  
*Aempiere Trunk
+
===ADempiere Trunk===
Instructions for installing the latest and greatest Adempiere development source code.
+
*[[Manual_Installation_From_Trunk|Installation From Trunk]]
 +
*[[Create_your_ADempiere_development_environment|Development with Eclipse]]
  
*Older Versions
+
===Compilation FAQ===
Instructions for installing the latest and greatest Adempiere development source code.
+
Problems (and their solutions) that people often have compiling ADempiere.
  
*Building two versions
+
*Use the proper Java version. (jdk-1_5_0_14-linux-i586-rpm.bin for example). Compiling with 1.6 will give you errors and will require extra steps.
Learn how to build two (or more) copies of Adempiere.
+
*Remember to add "execute" permission to all the shell scripts before you start!
 +
:Run the following command from the directory above the Adempiere directory to convert all shell script files.
 +
<blockquote>find Adempiere -name *.sh -exec chmod +x "{}" \;</blockquote>
 +
:Thanks to "DeathMeat" on Freenode #adempiere for that.
 +
:Notes: for OpenSuSE 10.1, it requires quote for the *.sh, which we shall type:
 +
<blockquote>find Adempiere -name "*.sh" -exec chmod +x "{}" \;</blockquote>
  
*Newbie Guide
+
*Errors running standard unix shell scripts
Working with Adempiere SVN (on quality.adempiere.org)
+
:The standard unix shell scripts were created on a dos/windows platform and contain special characters that are incompatible with unix and which can cause strange errors when you run the scripts.  The common dos2unix utility will correct this problem. Running the following command from the directory above the Adempiere install directory should fix this
 +
<blockquote>find Adempiere -name *.sh -exec dos2unix -d "{}" \;</blockquote>
 +
:Thanks again to DeathMeat from freenode #adepiere for that.
  
*Compilation FAQ
+
:In addition to the shell scripts (i.e. *.sh files) you may also need to run this utility (dos2unix) against the file Adempiere/jboss/bin/run.conf.
Problems (and their solutions) that people often have compiling Adempiere.
+
*OutOfMemoryError when running the ant build
 +
:Allow the ant Process to use more (heap) memory. One way of doing this is by setting the ANT_OPTS environment variable. Example for Windows: <blockquote>set ANT_OPTS=-Xmx256M</blockquote>
 +
:For many Linux system, such as OpenSuSE, Fedora, Red Hat <blockquote>export ANT_OPTS=-Xmx256M</blockquote>
 +
 
 +
*You may get a MailLogger Exception
 +
:MailLogger failed to send e-mail!
 +
:java.lang.Exception: Missing required parameter: MailLogger.from
 +
 
 +
:Add these lines to Adempiere/utils_dev/mybuild.properties:
 +
<blockquote>
 +
MailLogger.from=username@domain.com<BR>
 +
MailLogger.success.to=username@domain.com<BR>
 +
MailLogger.failure.to=username@domain.com
 +
</blockquote>
 +
 
 +
*Show time!!
 +
:Move to the utils_dev directory <blockquote>cd Adempiere/utils_dev</blockquote>
 +
:Compile everything,
 +
:in Linux <blockquote>sh RUN_build.sh or ./RUN_build.sh</blockquote>
 +
:in Windows <blockquote>RUN_build</blockquote>
 +
 +
[[category:developer documentation]]

Latest revision as of 03:26, 25 August 2011

Building the source

Here you will find instructions for compiling and installing ADempiere from source and suggestions for when compilation doesn't go so smoothly.

ADempiere Stable

Follow the instruction on how to build from trunk, except that you should pull the source from the svn tag folder instead of from the svn trunk folder.

ADempiere Trunk

Compilation FAQ

Problems (and their solutions) that people often have compiling ADempiere.

  • Use the proper Java version. (jdk-1_5_0_14-linux-i586-rpm.bin for example). Compiling with 1.6 will give you errors and will require extra steps.
  • Remember to add "execute" permission to all the shell scripts before you start!
Run the following command from the directory above the Adempiere directory to convert all shell script files.
find Adempiere -name *.sh -exec chmod +x "{}" \;
Thanks to "DeathMeat" on Freenode #adempiere for that.
Notes: for OpenSuSE 10.1, it requires quote for the *.sh, which we shall type:
find Adempiere -name "*.sh" -exec chmod +x "{}" \;
  • Errors running standard unix shell scripts
The standard unix shell scripts were created on a dos/windows platform and contain special characters that are incompatible with unix and which can cause strange errors when you run the scripts. The common dos2unix utility will correct this problem. Running the following command from the directory above the Adempiere install directory should fix this
find Adempiere -name *.sh -exec dos2unix -d "{}" \;
Thanks again to DeathMeat from freenode #adepiere for that.
In addition to the shell scripts (i.e. *.sh files) you may also need to run this utility (dos2unix) against the file Adempiere/jboss/bin/run.conf.
  • OutOfMemoryError when running the ant build
Allow the ant Process to use more (heap) memory. One way of doing this is by setting the ANT_OPTS environment variable. Example for Windows:
set ANT_OPTS=-Xmx256M
For many Linux system, such as OpenSuSE, Fedora, Red Hat
export ANT_OPTS=-Xmx256M
  • You may get a MailLogger Exception
MailLogger failed to send e-mail!
java.lang.Exception: Missing required parameter: MailLogger.from
Add these lines to Adempiere/utils_dev/mybuild.properties:

MailLogger.from=username@domain.com
MailLogger.success.to=username@domain.com
MailLogger.failure.to=username@domain.com

  • Show time!!
Move to the utils_dev directory
cd Adempiere/utils_dev
Compile everything,
in Linux
sh RUN_build.sh or ./RUN_build.sh
in Windows
RUN_build