Remote Debugging

Remote debugging a container

The default configuration for Tomcat with ORCA has port 8000 open for remote debugging. You need to create a debugging configuration in eclipse that connects to the host with the container you want to debug on port 8000. Once Orca is running in the container, you can click on the Debug button in the Debug Configurations and Eclipse will connect to the running instance.

Remote Debuggin Node Agents

/etc/init.d/na for nodeagents reference a script .../bin/http-server.sh. Make sure the line DEBUG_OPTIONS="-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=${DEBUG_PORT}" exists to enable remote debugging. Stop and start the agent to enable debugging.

Driver Debugging Notes

If you need to make changes to the driver or a file used by the driver (e.g., XML) you will need to regenerate the driver package (mvn package) and reinstall the driver (ant upgrade) If you need to debug remotely: Open the nodeagent project in eclipse and setup remote debugging for the remote machine. The debug port if 8000. If you need to take a look at the nodeagent log file, it is located under /root/na/log/na.log. If the nodeagent service seems broken, you can start/stop it using: sudo /etc/init.d.na stop|start. Note that this startup script is not working 100%, so that sometimes you may need to kill the service manually and remove the pid files in /root/na/bin.