house fly

JSwat Project

JSwat Installation


Installing JPDA

  1. First, check to see if your version of the JDK comes with the JPDA files. All versions of the Javasoft Linux JDK come with the JPDA included, in which case you can skip to Installing JSwat. Otherwise, look in the lib directory of the JDK installation. If there is a jpda.jar or tools.jar then there is a good chance the JPDA is already installed. In the case that you have the tools.jar file, scan the output from jar tf tools.jar and look for "com/sun/jdi" classes. If you see them, then your tools.jar file contains the JPDA classes and you can skip to Installing JSwat. Otherwise you need to continue to the next step.
  2. Download the JPDA from the JavaSoft site.
  3. Read and follow the JPDA installation instructions. They will tell you where to put the JPDA files and how to set your environment variables for using the JPDA.
  4. Linux JDK 1.2.2 users: If you looked at those JPDA installation instructions in the previous step and saw the sentence that says "these instructions do not apply to the Linux JDK", do not believe it -- you must follow them anyway. The important step is to add <jdk_home>/lib/i386 to your LD_LIBRARY_PATH setting. If you fail to do this, you will see the "can't find libjdwp.so" error message when using JSwat.

Acquiring JSwat

  1. Obviously the first thing you need to do is download the JSwat package from this site. Visit the Downloads page and get the latest stable release.
  2. Extract the files using either gzip and tar or WinZip, if you are a Windows user. If either of these programs complains that the archive is corrupted, try holding the Shift key will you click the download link. Netscape Navigator has a tendency to mis-interpret files as ASCII and perform the end-of-line character mangling on them.
  3. With the files extracted, check that you have a docs directory (which contains this file) and the jar file. This jar file contains the JSwat classes.
  4. Proceed to the next section.

Installing JSwat

  1. Make sure your CLASSPATH includes the jpda.jar or tools.jar file, whichever one is part of your JDK installation. I recommend you do this by putting the jar file in the JDK's jre/lib/ext directory. This will add the jar to the classpath automatically.
  2. Ideally JSwat should be run from within its jar file. This is most easily done by adding the JSwat jar file to your CLASSPATH.

Starting JSwat

  1. Invoke JSwat using 'java com.bluemarsh.jswat.Main' and you should see the JSwat main window in a moment. If instead you get an error message that says the JPDA could not be found, you will need to download the JPDA and install it (see the instructions above).
  2. See the Launching JSwat How To for other ways to start JSwat.


Back to Documentation