Edit online

How to Attach a Debugger to Oxygen XML Web Author

To attach a debugger to a running Java process, you need to configure the Java Virtual Machine (JVM) to listen for debugging connections. This can be achieved by passing to the java command an extra argument, similar to this: -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=5005.

To set this argument for the JVM that runs Oxygen XML Web Author, the procedure depends on the distribution that you use. For example:
  • When using the All Platforms distribution, this argument can be added on a new line in the oXygenXmlWebAuthor.vmoptions file.
  • When using the WAR distribution, the arguments needs to be set for the JVM that runs the servlet container. With Tomcat, this can be done by setting the CATALINA_OPTS environment variable to contain this argument.

To connect a debugger, you need to follow the instructions provided by your IDE and use port 5005 (as configured above).

Note: If you are using Eclipse, you can start the WAR distribution of Oxygen XML Web Author in debug mode directly from the IDE.