To perform uninstallation, IzPack goes through three phases, each involving a separate process.

The following describes how to remotely debug each of these phases.

Phase 1

This phase:

  1. Extracts the jar to a temporary directory
  2. Spawns a new process for Phase 2, referencing the temporary directory as the classpath; and
  3. Exits

Its invoked by running:

    java -jar MyApp/Uninstaller/uninstaller.jar

To debug this phase:

  1. Place a breakpoint in com.izforge.izpack.uninstaller.Uninstaller.main(String[] args)
  2. Run the command with the appropriate debug agent settings
  3. Attach to the process in the debugger

E.g.:

    java -jar -Xdebug -Xrunjdwp:transport=dt_shmem,address=jdbconn,server=y,suspend=y MyApp/Uninstaller/uninstaller.jar

Phase 2

This phase:

  1. Spawns a new process for Phase 3
  2. Waits for it to complete
  3. Deletes the temporary directory containing the classes extracted in Phase 1

To debug this phase,:

  1. Place a breakpoint in  com.izforge.izpack.util.SelfModifier.main(String[] args)
  2. Define the self.mod.debugPort2 property, which specifies the debug port to listen on
  3. Attach to the process in the debugger using socket transport, and the port above
E.g.:
java -jar -Dself.mod.debugPort2=8002 MyApp/Uninstaller/uninstaller.jar

Phase 3

This phase performs the actual uninstallation.

To debug this phase:

  1. Place a breakpoint in  com.izforge.izpack.util.SelfModifier.main(String[] args)
  2. Define the self.mod.debugPort3 property, which specifies the debug port to listen on
  3. Attach to the process in the debugger using socket transport, and the port above
E.g.:
java -jar -Dself.mod.debugPort3=8003 MyApp/Uninstaller/uninstaller.jar