Debugging Arquillian Tests

This short tutorial describes how to debug Arquillian Test Cases using a development environment like Eclipse IDE.

The prerequisite is that you have gone through the basics of Arquillian– you can find a good Arquillian tutorial here.

As you already know, Arquillian tests are launched as JUnit test but are executed on the application server environment. Therefore, in order to intercept breakpoints that you have set in Eclipse, you should at first enable remote socket debugging. This can be done by uncommenting the following line from standalone.conf.bat (Windows):

set "JAVA_OPTS=%JAVA_OPTS% -agentlib:jdwp=transport=dt_socket,address=8787,server=y,suspend=n"

Unix users, on the other hand will uncomment the following line in standalone.conf:

JAVA_OPTS="$JAVA_OPTS -agentlib:jdwp=transport=dt_socket,address=8787,server=y,suspend=n"

Remote Profile Testing

If you want to debug your Arquillian Tests against a running JBoss AS instance, start by setting the Active Maven Profile as arq-jbossas-remote (or as you called it in your pom.xml).

 Arquillian tutorial debugging

Now start JBoss AS 7/EAP 6.1 from Eclipse using the Debug Option, as shown by the following picture:

debug arquillian tutorial

Now set your breakpoints and execute your application as JUnit Test (Run as->JUnit Test). The Debugger perspective will kick in and you will be able to debug your test.

Managed Profile Testing

If you plan to debug your test using a JBoss AS instance managed by Arquillian, you have to set the remote socket debugging options from within your arquillian.xml file as shown by the following example:

<arquillian xmlns=""

        <property name="deploymentExportPath">target/</property>

    <container qualifier="jboss" default="true">
        <protocol type="jmx-as7">
            <property name="executionType">REMOTE</property>
            <property name="jbossHome">C:\jboss\jboss-as-7.1.1.Final</property>
            <property name="javaVmArguments">-agentlib:jdwp=transport=dt_socket,address=8787,server=y,suspend=y</property>


Now, set the Maven profile to run against a managed Arquillian profile:

arquillian tutorial debug jboss tutorial

Now set your breakpoints and execute your application as JUnit Test (Run as->JUnit Test). That’s all! Happy debugging!