Page Comparison

Note: thanks to Scott Amerson of UC Davis for these instructions.

Assumptions

1. Windos XP, SP2 environment
2. Java 1.4.2 installed
3. Tomcat 5.5.x installed together with Compat *.jar
4. Maven installed and build.properties defined
5. Eclipse 3.1.x installed
6. MyEclipse 4.0.x installed (optional)

Setup

1. Environment: set JPDA variables as Environment variables

Set the Java Debug Wire Protocol (JDWP) for the connection and the port the debugger will use to communicate with the JVM, typically port 8000.
Set the following Environment Variables (either user or system) for debugging by right clicking on My Computer--> Properties --> Advanced Tab --> Environment Variables

JPDA_TRANSPORT=dt_socket;
JPDA_ADDRESS=8000

2. Tomcat: start in debug mode

Go to your TOMCAT_HOME\bin directory via Windows Explorer, and type:
(make sure your Tomcat\bin directory contains the catalina.bat script from the Tomcat source)
catalina jpda start

3. Eclipse: set breakpoint(s) in code and switch to Debug Perspective

Debug Perspective: Window > Open Perspective > Other > Debug

...

1. Connect
   • Name: SakaDebug
   • Project: leave blank
   • Connection Type: Standard (Socket Attach)
   • Host: localhost
2. Port: 8000 (as defined above)
3. Source
   • Click Add and select Java Project icon
   • Click Select all projects (deselect local database project)
   • Uncheck Add exported entries of selected projects (otherwise references to MAVEN_REPO, ECLIPSE_HOME, etc. are added)
     #Common
     #*Stay with defaults
4. Click Apply (debug session should start, otherwise click Debug icon and click on named debug profile)

Sample debug sessions

Exampe I: Legacy-service walkabout

Set a breakpoint in org.sakaiproject.service.legacy.user.cover.UserDirectoryService, specifically in method:

...