Using the Programming Environment

To debug your classes in the Java Server IdS-J, you need to:

To run the IdS-J server in debug mode, start the server via a batch file rather than as a service. Copy the file runServer.bat in the folder install_path\ids-j\bin to a new file, for example debugServer.bat. Uncomment the line that sets the debug options. The line now reads:

SET debug=-DIDM_DEBUG=ON -Xdebug -Xnoagent -Djava.compiler=NONE
-Xrunjdwp:transport=dt_socket,address=48174,suspend=n,server=y

This means you can now access the debug port 48174. Of course, you can change the port if needed.

Next, create a Debug Configuration for the IdS-J server in Eclipse. From the Run menu, select Debug Configurations …. In the left-hand tree, select Remote Java Application and then click New. Now you can enter the properties for your Debug Configuration. Select the project with your Java sources under test. Keep Standard (Socket Attach) as the connection type. For the host, enter the IP address or DNS name where the IdS-J server is running (usually localhost) and the port that you entered in the file debugServer.bat, typically 48174.

Note that you can debug an IdS-J server running on a separate system, even running in a virtual machine (VM), provided that the firewall settings permit remote access to the debug port.

To debug, first start the server by running the batch file debugServer.bat and then click Debug in the Eclipse Debug Configuration. The Eclipse Debug perspective should open and you should see the IdS-J threads running.

To debug your classes in Apache Tomcat (especially Web Center and SPML Provisioning Services user hooks), there are the following scenarios:

If you have installed Tomcat as a service, open the Tomcat configuration via Start > Programs > Apache > Configure Tomcat. Select the java tab and then enter the following JVM options analogous to debugging the IdS-J:

Make sure you are using a port that is not used by another application.

Set up an Eclipse Debug Configuration the same way as described for IdS-J, but use another name for your configuration and enter the correct debug port for Tomcat. For more details, see http://tomcat.apache.org/faq/development.html#rd.

If you start your Tomcat via a batch file, set the following environment variables:

Start Tomcat using catalina jpda start.

An open source Eclipse plug-in is also available (http://www.eclipsetotale.com/tomcatPlugin.html) that allows you to start, stop and debug Tomcat from within Eclipse in addition to creating war files and configuring Tomcat easily.