This page contains a short overview for developers who want to install and debug JSPWiki on Apache Tomcat using the Eclipse IDE. Some shell and batch scripts are included, too.


At first, I (Florian Holeczek) tried to check out JSPWiki from the Subversion repository and then convert it to a Dynamic Web Project. After spending some hours on this I recognized, that the Web Tools Project isn't flexible enough when it comes to adapting other directory structures than the predefined ones.

Janne Jalkanen kindly provided the shell script he's using himself. I've translated it almost completely to a Windows batch script and added some functionality for choosing debugging options.

Please note that both scripts aren't highly sophisticated, they just (hopefully) do what they're expected to ;-) You'll have to tweak them yourself to suit your environment.


UNIX/OSX shell script(info) by JanneJalkanen

batch script(info) by FlorianHoleczek

Configuring Eclipse and debugging#

Here's a short howto on Eclipse 3.3.

  1. In the program menu, select 'Run'..'Open Debug Dialog'. Go to the section called 'Remote Java Application' and click on the 'New launch configuration' button.
  2. Give it a name, standard settings are ok (This may vary in your case, of course!). Important are 'Connection Type'='Standard (Socket Attach)' and 'Connection Properties'=localhost,8000.
  3. From now on, you can debug JSPWiki by:
    1. Setting your breakpoints
    2. Starting the script (see inside for details)
    3. Attaching to Tomcat via the previously created debug settings

Discussion and improvements#

As noted, these scripts just do what they should. Feel free to discuss and/or provide improvements.

--FlorianHoleczek, 09-Apr-2008

Add new attachment

Only authorized users are allowed to upload new attachments.

List of attachments

Kind Attachment Name Size Version Date Modified Author Change note
chk.txt 0.2 kB 1 24-Jun-2010 07:06
sh 2.8 kB 2 24-Jun-2010 07:05
jspwikidevtomcat.cmd 4.9 kB 2 14-Jul-2008 18:13 FlorianHoleczek updated Windows batch script
« This page (revision-3) was last changed on 09-Apr-2008 09:17 by JanneJalkanen