Page History

...

Remote Debugging OFBiz in Eclipse

This is the recommended way for debugging ofbiz. But personnaly (Jacques Le Roux) I use and prefer the second way below : Running (or debugging) OFBiz in Eclipse

Step 1: Run OFBiz in debug mode

Normally we start OFBiz with the command line

%JAVA_HOME%\bin\java -jar ofbiz.jar

To start in debug mode use the command line

%JAVA_HOME%\bin\java -Xdebug -Xnoagent -Djava.compiler=NONE -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=8091 -jar ofbiz.jar

This changed command line instructs java to run in debug mode listening for a socket connection on port 8091 for a debugger to connect. You can change the port number to any port not otherwise being used.

Step 2: Connect to OFBiz with Eclipse as a Debugger

Before connecting you have to create a new debug configuration.
* In Eclipse choose Run->Debug... from the menu. A Debug window should pop up.

• Select Remote Java Application from the tree on the left.
• Click New (button on the bottom left).
• Type a name at the top (OFBiz, perhaps?)
• On the Connect tab
  
  • Pick ofbiz for the project
  • Select Standard (Socket Attach) for Connection Type
  • Type localhost for host
  • Type 8091 (or whatever port you chose) for port
• On the Source tab
  
  • Click Add Projects... (buttons on the right)
  • Select the ofbiz project
• Click ApplyIf you have OFBiz running debug (Step 1 above) you can start debugging by clicking Debug (on the bottom) now.
  
  You know that you are connected when you see a start/stop button in the debug perspective of Eclipse.
  

  No Format
  First created by Jarrod Ribble.

  
  

----

Running (or debugging) OFBiz in Eclipse

• Select OFBiz project, right-click on it -> Run As -> Run ... (alike for Debug)
• Select Java Application and click on New
• Set Run configuration name to OFBiz
  • Main tab:
    • Project: OFBiz
    • Main class: org.ofbiz.base.start.Start
  • Arguments:
    • VM arguments: -Xms(minValue)M -Xmx(maxValue)M  (typically minValue = 128, maxValue = 512, more is better of course) -Duser.language=en  
      • In some case (Suse  SL 10.1 at least) it's better to not define any VM arguments but let the defaults values.
    • Working directory: Use default working directory
  • Classpath
    • Bootstrap Entries: JRE System Library
    • User Entries: ofbiz.jar from OFBiz project
      • Don't forget to remove the entry "ofbiz (default classpath)" else you may have a message "Can't find bundle for base name cache, locale ..."
  • Source tab
    
    • Click Add Projects... (buttons on the right)
    • Select the ofbiz project
  • Environment
    • Add environment variable LC_ALL=C (Optional, Linux only)
• Click on Apply and Run (or Debug)
  

  No Format
  Thanks to Peter Goron of Néréides

  
  
  

...

Browsing Derby Database in Eclipse 

Connecting the database

The Eclipse DTP (Data Tools Project) is quite helpful to inspect database content from within the IDE. As long as you are using the embedded Derby database in OFBiz, you can create a DTP connection as described here. Everything you need comes with OFBiz. Just make sure you have the Data Tools Platform features installed in your Eclipse IDE.

...