Debug server

From ADempiere
Jump to: navigation, search
This Wiki is read-only for reference purposes to avoid broken links.

Prerequisites

  • You must have set up the IDE to compile and run the client.
  • You must have compiled and started the server (the easiest way to do this is to run the RUN_build.sh|bat script in utils_dev directory where you checked out Adempiere.

Enable debug

Append the following to the line that starts with ADEMPIERE_JAVA_OPTIONS to the file utils/myEnvironment.bat|sh

-Xdebug -Xnoagent -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=8888

The result will be something like:


@SET ADEMPIERE_JAVA_OPTIONS=-Xms64M -Xmx512M -DADEMPIERE_HOME=D:\Develop\Adempiere\stable\adempiere\Adempiere 
-Xdebug -Xnoagent -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=8888


Start the server (using utils/RUN_Server2.sh). If you have compiled using the RUN_build.sh script mentioned in the prerequisites you'll find this script in adempiere/Adempiere/utils with the checkout directory as root).

Debug

Use the "Attach debugger" option in your IDE. If you're using NetBeans you'll find that menu option under the main menu "Run". Attach to the server you're running adempiere on using the specified port (in this example, port 8888). Add breakpoints as you please.

See Also