Difference between revisions of "Compile"
From ADempiere
This Wiki is read-only for reference purposes to avoid broken links.
m |
(Missing a line for MailLogger) |
||
(12 intermediate revisions by 7 users not shown) | |||
Line 1: | Line 1: | ||
==Building the source== | ==Building the source== | ||
− | Here you will find instructions for compiling and installing | + | 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=== |
− | + | *[[Manual_Installation_From_Trunk|Installation From Trunk]] | |
− | + | *[[Create_your_ADempiere_development_environment|Development with Eclipse]] | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
===Compilation FAQ=== | ===Compilation FAQ=== | ||
− | Problems (and their solutions) that people often have compiling | + | 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! | *Remember to add "execute" permission to all the shell scripts before you start! | ||
− | :Run the following command | + | :Run the following command from the directory above the Adempiere directory to convert all shell script files. |
− | <blockquote>find | + | <blockquote>find Adempiere -name *.sh -exec chmod +x "{}" \;</blockquote> |
:Thanks to "DeathMeat" on Freenode #adempiere for that. | :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> | ||
+ | |||
*Errors running standard unix shell scripts | *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 | + | :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 | + | <blockquote>find Adempiere -name *.sh -exec dos2unix -d "{}" \;</blockquote> |
:Thanks again to DeathMeat from freenode #adepiere for that. | :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 | + | :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 | *OutOfMemoryError when running the ant build | ||
− | :Allow the ant | + | :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]] | [[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