Debugging

<< Module Upload
*** We are improving this documentation all the time. Please feel free to contribute!! ***

As you're building a Component Module you will probably want to debug it to make sure it is interacting properly with the App or Service you are building the connector for. The easiest way to do this is to:

1. Deploy the On-Premise App Deployer to your local development machine. After doing this, you will be able to run your test integrations on your local machine. This allows you to see FINE/debug logging output (see #2 below) on your local machine's console, or to connect your IDE's debugger for debugging.
2. Turn on FINE logging by adding com.foxweave.level = FINE to a new line at the bottom of Tomcat's logging configuration file conf/logging.properties.

Connecting your IDE's debugger to your local Tomcat container is also very easy. You need to stop your Tomcat (if it is running) and then restart it, adding the jpda switch.

Linux/Mac:

./catalina.sh jpda run

Windows:

catalina.cmd jpda run

After restarting Tomcat, your IDE's debugger will be able to remotely connect on port 8000. Now you can debug your connector's code!