JBoss debugging in Eclipse


If you set up a JBoss server using the Eclipse WebTools, you can simply start the server in debug mode (debug button in the servers view). This will allow you to set breakpoints in the application that is running inside the JBoss.


How do you configure JBoss to debug an application in Eclipse?

Eclipse Remote debugging with jboss

What you are asking is not specific to either Java EE or JBoss 4.x - you can debug any Java process in case you specified the remote debugging runtime parameters when starting the JVM.

In your setting the -Xdebug parameter is missing, so your line would be:

JAVA_OPTS="$JAVA_OPTS -Xdebug -Xrunjdwp:transport=dt_socket,address=8787,server=y,suspend=n"

Now it should be able to connect, in case you are using the correct host and your specified port 8787. In case it's still not working, it's most likely a firewall issue blocking the port.

We have to do 2 changes to debug remote java application that is running in JBoss

  1. Configure in JBoss
  2. Creating remote debugger in in eclipse

    1. Open run.conf.bat(windows) or run.conf(Linux) file in JBoss bin folder.

go to the below lines

`# Sample JPDA settings for remote socket debugging`
 #JAVA_OPTS="$JAVA_OPTS -Xrunjdwp:transport=dt_socket,address=8787,server=y,suspend=n

and remove hash in JAVA_OPTS

# Sample JPDA settings for remote socket debugging
JAVA_OPTS="$JAVA_OPTS -Xrunjdwp:transport=dt_socket,address=8787,server=y,suspend=y

Restart the server if it is started.
2. In Eclipse, Run -> Debug configuration -> Remote Java Application and create a new. Note that you have to give port that is mentioned in run.conf.bat file

I am assuming you have an IDE to do the debugging from - which in most case people use Eclipse.

  1. Need to set up your JBoss to allow debug connection
  2. Connect to your JBoss, on its debugging port, through Eclipse.

Check out this post JBoss debugging in Eclipse