Compile

From ADempiere ERP Wiki

Jump to: navigation, search

Contents

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
Personal tools